PyCharm 2025.3 Help

Docker 注册表设置

指定用于访问用于存储和分发 Docker 镜像的 Docker 注册表 的设置。

启用 Docker 插件

此功能依赖 Docker 插件,该插件默认随 PyCharm 一起捆绑并启用。 如果相关功能不可用,请确保未禁用该插件。

  1. Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 已安装 选项卡,找到 Docker 插件,并选中其名称旁的复选框。

Docker 注册表设置

默认情况下,PyCharm 允许您从 Docker Hub 拉取公共镜像。 如果您要使用私有仓库,请添加 Docker 注册表并提供您的帐户凭据。

添加按钮添加

添加新的 Docker 注册表。

移除按钮删除 Alt+Delete

移除所选 Docker 注册表。

针对每个 Docker 注册表,配置以下内容:

名称(M)

为此注册表配置指定名称。

注册表

选择一种可用的 Docker 注册表类型:

  • Docker Hub :指定您的凭据,以访问位于 registry.hub.docker.com 的主 Docker 注册表中的私有镜像。 默认情况下,PyCharm 只能访问 Docker Hub 上的公共镜像。

  • GitLab :使用位于 gitlab.com 的 GitLab 主注册表,或指定自托管的 GitLab 注册表。

  • JetBrains Space :使用您 Space 实例中的 Docker 注册表。

  • Docker V2 :指定任何支持 Docker Registry HTTP API V2 的注册表。

  • 通用 :如果其他注册表类型不起作用,请将您的注册表添加为通用。 您将无法在 服务 工具窗口中浏览和拉取镜像,但可以将镜像推送到此注册表。

    例如,PyCharm 尚未完全支持 Quay 镜像注册表,但您可以将其添加为通用注册表:在 quay.io 上创建一个存储库,并将 quay.io 指定为地址,填写您的用户名和密码。

地址

指定 Docker 注册表的 URL。

用户名

指定在所选注册表中的用户帐户名称。

密码

指定在所选注册表中的用户帐户密码。

令牌

为所选 Docker 注册表指定访问令牌

Azure 容器注册表

PyCharm 支持将 Azure 容器注册表 添加为 Docker V2 注册表。

如果您使用用于 通过 Azure AD 的个人登录 的临时令牌,请将用户名设置为 00000000-0000-0000-0000-000000000000 ,并将密码设置为由 az acr login 使用 --expose-token 参数返回的令牌。 使用以下命令登录 Azure CLI 并公开令牌:

az login az acr login --name <azureregistryname> --expose-token

如果您要使用 管理员用户帐户 ,请在 Azure 门户或通过 Azure CLI 将其启用:

az acr update -n <azureregistryname> --admin-enabled true

在配置 Azure 容器注册表时,您可以设置管理员用户名和密码。

最后修改日期: 2025年 12月 2日