WebStorm 2025.2 Help

Docker 镜像

Docker 镜像是用于运行容器的可执行包。 Docker 使用 registries 分发镜像。 默认情况下,WebStorm 使用 Docker Hub ,该公共注册表包含所有常见镜像,如各种 Linux 版本、数据库管理系统、Web 服务器和运行时环境。 如果您只打算使用 Docker Hub ,则无需额外配置注册表。 如需使用其他公共或私有 Docker 注册表(包括您部署的注册表服务器),请先在 WebStorm 中进行配置。

启用 Docker 插件

此功能依赖于 Docker 插件,该插件默认已捆绑并在 WebStorm 中启用。 如果相关功能不可用,请确保未禁用该插件。

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

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

要在 WebStorm 中管理 Docker 镜像,请打开 服务 工具窗口(视图(V)| 工具窗口(T)| 服务Alt+8 ),展开已配置的 Docker 连接节点 Docker 节点 ,然后展开 镜像 节点。 有关更多信息,请参阅 镜像

服务工具窗口 - Docker - 镜像

根据您的开发需要,您可以通过以下方式使用 Docker:

配置 Docker 注册表

  1. 服务 工具窗口中,点击 添加服务按钮 ,然后选择 Docker 注册表…

    服务工具窗口 - 添加 Docker 注册表
  2. 新建Docker 注册表 对话框中,选择注册表类型及连接方式。 指定凭据后,WebStorm 会自动检查与注册表的连接。 连接成功 消息应显示在对话框底部。

    有关更多信息,请参见 Docker 仓库设置

    添加新的 Docker 注册表

您可以在 服务 工具窗口中查看已配置的 Docker 注册表。

服务中的 Docker 注册表

另外,您也可以在 Docker 仓库设置 中管理已配置的 Docker 注册表列表。

从 Docker Hub 拉取公共镜像

  1. 服务 工具窗口(视图(V)| 工具窗口(T)| 服务Alt+8 )中,选择 镜像 节点。

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

    使用 代码补全官方镜像 的可用建议中进行选择。 再次按下 Ctrl+Space 可查看所有用户的相关镜像。

    Docker 工具窗口:拉取镜像
  3. 按下 Ctrl+Enter 执行 docker pull

与在 Docker CLI 中一样指定镜像名称,例如: ubuntu:20.04

从 Docker 注册表拉取镜像

如果希望在 Docker Hub 或其他 Docker 注册表中使用私有镜像,请 配置 Docker 注册表连接

  • 服务 工具窗口(视图(V)| 工具窗口(T)| 服务Alt+8 )中,展开包含所需 Docker 注册表的节点,右键点击所需镜像并选择 拉取镜像…

    从已配置的注册表拉取镜像

从 Dockerfile 构建镜像

在编辑 DockerfileContainerfile 时,WebStorm 会为来自 已配置注册表 的镜像提供 代码补全 支持。

  1. 打开要用于构建镜像的 Dockerfile 或 Containerfile。

  2. 点击边距中的 在 Docker 上运行 并选择构建镜像。

    在 Docker 上构建镜像弹窗
  3. 对于已命名阶段,您可以在编辑器中点击 构建内联提示

    Dockerfile 中的内联提示

    要在 Dockerfile 中启用内联提示,请打开 设置 对话框(Ctrl+Alt+S ),转到 编辑器|内联提示 ,展开 其他 节点,然后在 Dockerfile 下选中 Docker 运行命名阶段 复选框。

WebStorm 会创建一个运行 docker build 命令的 Dockerfile 运行配置

推送镜像至 Docker 注册表

您可以将镜像推送到 已配置的 Docker 注册表

  1. 服务 工具窗口中,选择要上传的镜像,并单击工具栏上的 推送镜像按钮 或在 仪表板 中,或从上下文菜单中选择 推送镜像…

    推送镜像上下文菜单项
  2. 选择 Docker 注册表 ,并指定仓库与标签(镜像的名称和版本,例如: my-app:v2)。

    推送镜像对话框
  3. 点击 确定(O) 运行 docker push 命令。

将镜像复制到其他 Docker 守护进程

如果您拥有多个 Docker 守护进程连接,则可以将镜像从一个守护进程复制到另一个。

  1. 服务 工具窗口中,选择要复制的镜像并点击 复制 Docker 镜像按钮 ,或在上下文菜单中选择 复制Docker 镜像

    复制 Docker 镜像
  2. 复制Docker 镜像 对话框中,选择要将镜像复制到的 Docker 守护进程,然后点击 复制

该过程会首先使用 docker save 命令将当前 Docker 守护进程中的镜像保存为文件,然后使用 docker load 命令从目标守护进程中的文件加载镜像。

在服务工具窗口中管理 Docker 镜像

WebStorm 会在 服务 工具窗口中相应 Docker 守护进程连接的 镜像 节点下列出所有您本地拉取或构建的镜像。 有关更多信息,请参阅 镜像

选择一个镜像以查看其名称、ID、大小、标签、最后修改日期以及正在使用该镜像的容器。 您可以从所选镜像创建新容器、将镜像推送到已配置的 Docker 注册表,或查看该镜像使用的层。 点击 更多按钮 以查看更多操作:将镜像 ID 复制到剪贴板、运行 docker image inspect 命令,或显示应用于该镜像的 labels

Docker 镜像属性

没有标签的镜像 <none>:<none> 可以是以下之一:

  • 中间镜像 ,作为其他镜像的构建层,不占用任何空间。

  • 悬空镜像 ,在基于更新版本镜像重新构建镜像后仍保留。 应定期清理悬空镜像以节省磁盘空间。

要从列表中隐藏未标记的镜像,请点击 Docker 工具栏上的 筛选菜单 并取消选择 无标记的镜像

要删除一个或多个镜像,请在列表中选择它们并点击 删除镜像按钮

浏览 Docker 镜像

  1. 服务 工具窗口中,展开 镜像 ,选择您感兴趣的镜像。

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

  3. 选项卡显示构成该镜像的所有层及其详细信息。 点击 分析镜像以获得更多信息 以收集详细信息,包括对镜像文件系统的更改。

如果 WebStorm 支持该文件类型,您可以双击或右键点击镜像层中的任何文件以在编辑器中打开副本;如果不支持该类型,可以将其下载到本地文件系统。

从 Docker 层中打开文件
最后修改日期: 2025年 9月 26日