# Docker 镜像

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

Docker 镜像是用于运行容器的可执行文件形式的软件包。 Docker 使用 [注册表](https://docs.docker.com/registry/) 来分发镜像。 默认情况下，IntelliJ IDEA 使用 [Docker Hub](https://hub.docker.com/)，这是一个包含所有常见镜像的公共注册表，比如各种 Linux 版本、数据库管理系统、Web 服务器和运行环境。 还有其他公共和私有 Docker 注册表，您也可以部署自己的注册表服务器。 如需更多信息，请参阅 [配置 Docker 注册表](#configure-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  插件并点击   启用  。

要在 IntelliJ IDEA 中管理 Docker 映像，请打开   服务   工具窗口（  `查看 | 工具窗口 | 服务`  或 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))），展开已配置的 Docker 连接节点 ![Docker 节点](https://resources.jetbrains.com.cn/help/img/idea/2026.3/clouds-docker-impl.icons.Docker.svg)，然后展开   镜像   节点。 有关详细信息，请参阅 [镜像](services-tool-window.html#docker-images)。

![服务工具窗口 - Docker - Images](https://resources.jetbrains.com.cn/help/img/idea/2026.3/services_tool_window_docker_images.png)

根据您的开发需求，您可以将 Docker 用于以下用途：

* [从 Docker 注册表拉取预构建的镜像](#pull-image) 例如，您可以拉取一个运行 PostgreSQL 服务器容器的镜像，以测试您的应用程序将如何与生产环境进行交互。

* [从 Dockerfile 本地构建镜像](#build-image) 例如，您可以构建一个镜像，该镜像运行一个包含您的应用程序所需的特定版本 Java Runtime Environment (JRE) 的容器。

* [将您的镜像推送到 Docker 注册表](#push-image) 例如，如果您想向某人演示您的应用程序如何在某个特定版本的 JRE 中运行，而不是设置适当的环境，他们可以从您的镜像运行一个容器。

Procedure: 配置 Docker 注册表

> **Note:**
> 如果您打算仅使用托管在 [Docker Hub](https://hub.docker.com/) 上的公共镜像，则无需配置注册表。

1. 在   服务  工具窗口中，点击 ![“添加服务”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)并选择   Docker 注册表…  。

![服务工具窗口 - 添加 Docker Registry](https://resources.jetbrains.com.cn/help/img/idea/2026.3/services_tool_window_add_docker_registry.png)

2. 在   新建 Docker 注册表   对话框中，选择注册表的类型以及如何连接到注册表。 当您指定凭据时，IntelliJ IDEA 将自动检查与注册表的连接。 该   连接成功  消息应出现在对话框的底部。

要了解详情，请参阅 [Docker Registry 设置](settings-docker-registry.html)。

![添加新的 Docker Registry](https://resources.jetbrains.com.cn/help/img/idea/2026.3/add_new_docker_registry_dialog.png)

您可以在   服务   工具窗口中看到配置的 Docker 仓库。

![服务中的 Docker registries](https://resources.jetbrains.com.cn/help/img/idea/2026.3/docker_registries_services.png)

或者，您可以在 [Docker Registry 设置](settings-docker-registry.html)中管理已配置的 Docker 注册表列表。

Procedure: 从 Docker Hub 拉取公共镜像

1. 在   服务  工具窗口（  `查看 | 工具窗口 | 服务` 或 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))）中，选择   镜像  节点。

2. 在   镜像控制台  下，输入要拉取的镜像名称。

利用 [代码补全](auto-completing-code.html)从可用的 [官方镜像](https://docs.docker.com/docker-hub/official_images/)建议中进行选择。 请再次按 `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS)) 查看所有用户的相关图片。

![图像控制台](https://resources.jetbrains.com.cn/help/img/idea/2026.3/docker-images-console-pull.png)

3. 按 `Ctrl+Enter` (Windows), `⌘ ⏎` (macOS), `⌘ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ ⏎` (macOS System Shortcuts), `Ctrl+Enter` (XWin), `Ctrl+Enter` (GNOME), `Ctrl+Enter` (KDE), `Ctrl+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `Ctrl+Enter` (Visual Studio), `⌘ ⏎` (Visual Studio (macOS)), `Ctrl+Enter` (NetBeans), `Ctrl+Enter` (Eclipse), `⌘ ⏎` (Eclipse (macOS)) 运行 [docker pull](https://docs.docker.com/engine/reference/commandline/pull/)。

请按照 [Docker CLI](https://docs.docker.com/engine/reference/commandline/pull/) 中的说明指定镜像，例如：  `ubuntu:20.04` 。

> **Tip:**
> 您可以使用上下文操作来拉取 Docker 镜像，该镜像在您的 Java 或 Kotlin 代码、Dockerfile 或 Docker Compose 文件中引用。 将插入符号放在镜像名称处，按下 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))并选择   拉取 Docker 镜像  。

Procedure: 从 Docker registry 拉取镜像

如果您希望使用 Docker Hub 或其他 Docker 注册表中的私有镜像， [配置一个 Docker registry 连接](#configure-registry)。

* 在   服务  工具窗口（  `查看 | 工具窗口 | 服务`  或 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))）中，展开包含必要 Docker registry 的节点，右键点击所需的镜像，然后选择   拉取镜像…  。

![从配置的注册表中拉取镜像](https://resources.jetbrains.com.cn/help/img/idea/2026.3/docker_registry_pull_image.png)

Procedure: 从 Dockerfile 构建镜像

当您编辑 [Dockerfile](https://docs.docker.com/engine/reference/builder/)或 [Containerfile](https://docs.podman.io/en/latest/markdown/podman-build.1.html)时，IntelliJ IDEA 为来自 [已配置注册表](#configure-registry)的镜像提供 [自动补全](auto-completing-code.html)。

1. 打开您想要从中构建镜像的 Dockerfile 或 Containerfile。

2. 点击 ![在 Docker 上运行](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.runConfigurations.testState.run_run.svg) 在边栏中选择构建镜像。

![“在 Docker 上构建镜像”弹窗](https://resources.jetbrains.com.cn/help/img/idea/2026.3/56_DockerfileBuild.png)

IntelliJ IDEA 会创建一个 [Dockerfile 运行配置](dockerfile-run-configuration.html)，用于运行 [docker build](https://docs.docker.com/engine/reference/commandline/build/) 命令。

Procedure: 将镜像推送到 Docker 注册表

您可以将图像推送到 [配置的 Docker registry](#configure-registry)。

1. 在   服务  工具窗口中，选择您要上传的图像，然后点击工具栏或 ![“推送镜像”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/clouds-docker-impl.icons.PushImage.svg)中   仪表板  ，或从上下文菜单中选择   推送镜像…  。

2. 请选择 [Docker registry](#configure-registry) 并指定存储库和标签（镜像的名称和版本，例如，  `my-app:v2` ）。

![推送镜像对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/58_DockerPushDialog.png)

3. 请点击   OK   以运行 [docker push](https://docs.docker.com/engine/reference/commandline/push/) 命令。

Procedure: 将镜像复制到另一个 Docker 守护进程

如果您有多个 Docker daemon 连接，您可以将一个镜像从一个 Docker daemon 复制到另一个 Docker daemon。

1. 在   服务  工具窗口中，选择您要复制的图像并点击 ![复制 Docker 镜像按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.vcs.push.svg)或从上下文菜单中选择   复制 Docker 镜像  。

2. 在   复制 Docker 镜像  对话框中，选择您要复制镜像的 Docker daemon，并点击   复制  。

首先运行 [docker save](https://docs.docker.com/engine/reference/commandline/save/)命令，将当前 Docker 守护进程中的镜像保存为文件，然后运行 [docker load](https://docs.docker.com/engine/reference/commandline/load/)命令，从目标 Docker 守护进程的文件中加载镜像。

## 在 服務 工具窗口中管理 Docker 映像

IntelliJ IDEA 列出了您在   服务   工具窗口中相应 Docker 守护进程连接的   镜像   节点下拉取或本地构建的所有映像。 如需更多信息，请参阅 [镜像](services-tool-window.html#docker-images)。

选择一个图像以查看其名称、ID、大小、标签、最后更改日期以及正在使用此图像的容器。 您可以从所选镜像创建一个新容器，将该镜像推送到配置的 Docker registry，或查看该镜像使用的层。 点击 ![更多按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.more.svg) 以查看更多操作：将图像 ID 复制到剪贴板，运行 [docker image inspect](https://docs.docker.com/engine/reference/commandline/image_inspect/) 命令，或显示应用于图像的 [标签](https://docs.docker.com/config/labels-custom-metadata/)。

![Docker 镜像属性](https://resources.jetbrains.com.cn/help/img/idea/2026.3/55_DockerFindImage.png)

无标签的图像  `<none>:<none>` 可以是以下之一：

* 中间图像 作为其他图像的层存在，并且不会占用任何空间。

* 重建基于新版镜像的镜像时遗留的 悬空镜像 。 您应定期清理悬空镜像以节省磁盘空间。

要从列表中隐藏未标记的映像，请点击 Docker 工具栏上的 ![筛选菜单](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.filter.svg)，然后取消选中   未标记镜像  。

要删除一张或几张图片，请在列表中选择它们并点击 ![删除图像按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.remove.svg)。

Procedure: 探索 Docker 镜像

1. 在   服务   工具窗口中，在   镜像   下面，选择您感兴趣的图像。

2. 在   仪表板  选项卡中，点击   显示层  。

3. 层   选项卡显示构成此图像的所有图层以及每个图层的详细信息。 点击   分析镜像以获取更多信息   以收集详细信息，包括对映像文件系统的更改。

您可以双击或右键点击镜像图层中的任何文件以在编辑器中打开其副本（如果 IntelliJ IDEA 支持此文件类型），或下载文件的副本到您的本地文件系统（如果 IntelliJ IDEA 不支持此文件类型）。

![从 Docker 层中打开文件](https://resources.jetbrains.com.cn/help/img/idea/2026.3/docker_explore_image_layers_open_file.png)

