# Docker Registry 设置

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

> **TL;DR**
> `文件 | 设置 | 构建、执行、部署 | Docker | Docker 注册表`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 构建、执行、部署 | Docker | Docker 注册表`  适用于 macOS
>
>
>
> `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) !["设置"图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.settings.svg)

指定用于存储和分发 Docker 镜像的 [Docker registry](https://docs.docker.com/registry/) 的访问设置。

Procedure: 启用 Docker 插件

此功能依赖于 [Docker](https://plugins.jetbrains.com/plugin/7724-docker) 插件，该插件在 IntelliJ IDEA 中默认捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

> **Note:**
> Docker 插件默认仅在具有 Ultimate 订阅的 IntelliJ IDEA 中可用。 对于 IntelliJ IDEA，您需要按照 [插件](managing-plugins.html) 中的说明安装 Docker 插件。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  Docker  插件并点击   启用  。

![Docker Registry 设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/docker_registry_settings.png)

默认情况下，IntelliJ IDEA 允许您从 [Docker Hub](https://hub.docker.com/)拉取公共镜像。 如果您想使用私有存储库，请添加 Docker registry 并提供您的帐户凭据。

!["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)   添加
: 添加新的 Docker 注册表。

!["移除"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.remove.svg)   删除   `Alt+Delete` (Windows), `Alt+Delete` (macOS), `Alt+Delete` (IntelliJ IDEA Classic (macOS)), `Alt+Delete` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `Alt+Delete` (Sublime Text (macOS)), `Alt+Delete` (Visual Studio), `Alt+Delete` (Visual Studio (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))
: 删除选定的 Docker registry。

对每个 Docker 注册表，配置以下内容：

名称
: 指定此注册表配置的名称。

注册表
: 请选择一种可用的 Docker 注册表类型：
:
:
:
: * Docker Hub ：指定您的凭据以访问 [registry.hub.docker.com](https://hub.docker.com/) 中的私有镜像。 默认情况下，IntelliJ IDEA 只能访问 Docker Hub 上的公共镜像。
:
: * GitLab ：使用主要的 GitLab 注册表在 [gitlab.com](https://gitlab.com/)或指定一个自托管的 GitLab 注册表。
:
: * JetBrains Space ：在您的 [Space](https://www.jetbrains.com.cn/space/) 实例中使用 Docker registry。 > **Note:** > 指定您 Space 实例的域名地址，例如 `mycompany.jetbrains.space` 。
:
: * Docker V2 ：指定支持 [Docker Registry HTTP API V2](https://docs.docker.com/registry/spec/api/) 的任何注册表。
:
: * 泛型的 ：如果其他注册表类型不起作用，请将您的注册表添加为通用类型。 您将无法浏览并拉取 服务 工具窗口中的镜像，但可以将镜像推送到此注册表。 例如，IntelliJ IDEA 并不完全支持 [Quay](https://www.projectquay.io/) 镜像注册表，但您可以将其添加为通用注册表：在 [quay.io](https://quay.io/) 上创建一个存储库，并将 `quay.io` 作为地址、您的用户名和密码。

地址
: 请指定 Docker registry 的 URL。

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

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

令牌
: 请指定所选 Docker 仓库的访问令牌

## Azure 容器注册表

IntelliJ IDEA 支持添加一个 [Azure Container Registry](https://learn.microsoft.com/en-us/azure/container-registry/) 作为   Docker V2   registry。

如果您使用临时令牌进行 [使用 Azure AD 的单人登录](https://learn.microsoft.com/en-us/azure/container-registry/container-registry-authentication?tabs=azure-cli#individual-login-with-azure-ad)，请将用户名设置为  `00000000-0000-0000-0000-000000000000` ，并将密码设置为  `az acr login` 返回的令牌以及  `--expose-token` 参数。 使用这些命令登录到 Azure CLI 并暴露该令牌：

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

```

> **Note:**
> 当临时令牌过期时，您需要生成一个新的令牌并在注册表设置中更新它。

如果您想使用 [admin user account](https://learn.microsoft.com/en-us/azure/container-registry/container-registry-authentication?tabs=azure-cli#admin-account)，请在 Azure 门户或通过 Azure CLI 启用它：

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

```

您可以在配置 Azure Container Registry 时设置管理员用户名和密码。

## See also

### 相关

[Docker](docker.html)

### 参考

[Docker 连接设置](settings-docker.html) [Docker 控制台设置](settings-docker-console.html) [“服务”工具窗口](services-tool-window.html)

