WebStorm 2025.2 Help

Docker 容器

Docker 容器是相应镜像的运行时实例。 WebStorm 使用 Docker 运行配置 来执行构建 Docker 镜像和运行容器的命令。

启用 Docker 插件

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

  1. 按下 Ctrl+Alt+S 打开设置，然后选择 插件。

  2. 打开 已安装 选项卡，找到 Docker 插件，然后勾选插件名称旁的复选框。

从现有镜像运行容器

您可以从本地已有的 Docker 镜像运行容器，该镜像可以是此前已 拉取 或 构建 的。

  1. 在 服务 工具窗口中，选择一个镜像并单击 “创建容器”按钮 ，或从上下文菜单中选择 创建容器。

    “创建容器”上下文菜单项

  2. 在 创建容器 弹出窗口中，点击 创建…。

  3. 在打开的 创建Docker 配置 对话框中，您可以为配置命名一个唯一名称，并指定容器的名称。 如果您将 容器名称 字段留空，Docker 将为其分配一个随机唯一名称。

    “创建 Docker 配置”对话框

  4. 完成后，点击 运行 以启动新配置。

这将创建并启动 Docker 映像运行配置。

从 Dockerfile 运行容器

  1. 打开您要从中运行容器的 Dockerfile。

  2. 在标注区域点击 在 Docker 上运行 ，然后选择从该 Dockerfile 运行容器。

    “在 Docker 上运行”弹出窗口

这将使用默认设置创建并启动 Dockerfile 运行配置 ，首先根据 Dockerfile 构建镜像，然后基于该镜像运行容器。

要创建带有自定义设置的运行配置，在标注区域点击 在 Docker 上运行 ，然后选择 新建运行配置…。 您可以为构建的镜像指定自定义标签，以及容器的名称和读取 Dockerfile 的上下文文件夹。 上下文文件夹非常实用，例如，如果您有一些在 Dockerfile 作用域之外的构件，希望将其添加到镜像的文件系统中。

与容器交互

已创建的容器会列在 服务 工具窗口中。 默认情况下， 服务 工具窗口会显示所有容器，包括未运行的容器。 要从列表中隐藏已停止的容器，请在工具栏中点击 “筛选”按钮 ，选择 Docker ，然后点击 已停止容器 取消勾选复选框。

“服务”工具窗口 - Docker - 筛选

选择容器后，您可以查看 构建日志 选项卡，其中显示的是在创建和启动容器期间由对应的 Docker 运行配置 生成的部署日志。

在“服务”工具窗口中选择的容器的“构建日志”选项卡

仪表板 选项卡提供有关该容器的重要信息。 除名称和哈希 ID 之外，它还列出了环境变量、端口和卷挂载。 您可以添加、编辑和删除环境变量、端口和卷绑定。 但是，这些更改需要您重新创建容器，并不会更改用于创建该容器的 Docker run configuration。 这意味着下次运行该配置时，更改将不会保留。

在“服务”工具窗口中选择的容器的“仪表板”选项卡

如需了解更多信息，请参阅 容器仪表板。

在正在运行的容器中执行命令

  1. 在 服务 工具窗口中，右键点击容器名称，然后点击 Exec。

    在运行中的容器中执行命令：从上下文菜单中选择 Exec

  2. 在 在容器中运行命令 弹出窗口中，点击 创建并运行… 以创建并执行新命令。

    在运行中的容器中执行命令

    或者，您可以选择之前运行过的某个命令。

  3. 在 Exec 对话框中，输入命令并点击 确定(O)。 例如：

    ls /tmp

    列出 /tmp 目录的内容

    mkdir /tmp/my-new-dir

    在 /tmp 目录中创建 my-new-dir 目录

    /bin/bash

    启动 bash 会话

    正在运行 /bin/bash 的 Exec 选项卡

如需了解更多信息，请参阅 docker exec 命令参考。

查看正在运行的容器的详细信息

  • 在 服务 工具窗口中，右键点击容器名称，然后点击 检查。

    检查容器 - 菜单

    输出将在 检查 选项卡中以 JSON 对象形式呈现。

    “检查”选项卡

如需了解更多信息，请参阅 docker inspect 命令参考。

查看容器中正在运行的进程

  • 在 服务 工具窗口中，右键点击容器名称，然后点击 显示进程。

    显示运行中容器中的进程

    输出将在 进程 选项卡中以 JSON 数组形式呈现。

如需了解更多信息，请参阅 docker top 命令参考。

将控制台附加到容器输出

  • 在 服务 工具窗口中，右键点击容器，然后点击 附加。

    将控制台附加到运行中容器：上下文菜单

    控制台将附加到容器内运行的 ENTRYPOINT 进程的输出，并在 附加的控制台 选项卡中呈现。

    将控制台附加到运行中容器

如需了解更多信息，请参阅 docker attach 命令参考。

浏览容器中的文件

  1. 在 服务 工具窗口中，右键点击容器，然后点击 显示文件。

  2. WebStorm 执行 容器中的 ls 命令，并打开包含该容器文件系统的 文件 选项卡。

在 文件 选项卡中，您可以双击任意文件，在编辑器中查看。 WebStorm 将文件以只读模式打开，因此无法编辑或删除该文件。

SELinux 上的绑定挂载

如果主机使用 SELinux ，安全模块可能会阻止容器中的进程访问挂载的文件和目录。 为避免此问题，请使用 :z 选项为挂载的文件和目录添加标签。 如需了解更多信息，请参阅 Configure the SELinux label。

运行 Docker 容器时，WebStorm 可自动为主机上的所有卷绑定添加 :z 标志，但不包括顶层目录（例如 /bin ）。

为绑定挂载应用 SELinux 标签

  1. 按 Ctrl+Alt+S 打开设置，然后选择 高级设置 | Docker。

  2. 选择 将:z 挂载选项应用于 SELinux 系统的几乎所有绑定卷。。

    SELinux 系统的绑定设置
最后修改日期： 2025年 9月 26日
Docker 镜像Docker 运行配置