WebStorm 2025.2 Help

Docker 映像运行配置

使用此类型的配置从本地已有的映像运行一个 Docker 容器,该映像是您之前 拉取构建的。

Docker 映像运行配置对话框

Docker 使用 docker run 命令,其语法如下:

docker run [OPTIONS] IMAGE [COMMAND] [ARG...]

您可以使用 Docker 镜像 运行配置的选项设置此命令的所有参数。

默认情况下, Docker 镜像 配置包含以下选项:

项目

说明

名称(N)

为此运行配置指定一个名称,以便在编辑或运行时快速识别。

允许多个实例(U)

允许并行运行此运行配置的多个实例。

默认情况下,处于禁用状态,如果在已有实例运行时启动此配置,WebStorm 会建议停止当前实例并启动另一个。这在运行配置消耗大量资源且没有充分理由运行多个实例时非常有用。 这在运行配置消耗大量资源且没有充分理由运行多个实例时非常有用。

存储为项目文件(S)

保存包含运行配置设置的文件,以便与其他团队成员共享。 默认位置为 .idea/runConfigurations 。 不过,如果您不希望共享 .idea 目录,则可以将配置保存到项目中的其他目录中。

默认情况下,处于禁用状态,WebStorm 会将运行配置设置保存在 .idea/workspace.xml 中。

服务器

选择要用于运行配置的 Docker 守护程序连接

镜像ID 或名称

指定用于创建容器的 Docker 映像的标识符或名称。

容器名称

为容器指定一个可选名称。 如果未填写,Docker 将为容器生成一个随机名称。

这类似于在使用 docker run 命令时指定了 --name 选项。

执行前(B)

指定在启动运行配置之前要执行的任务列表。 例如,运行其他配置、构建所需构件、运行某个外部工具或 Web 浏览器等。

单击 添加按钮 或按下 Alt+Insert 以添加可用任务之一。

使用 上移按钮下移按钮 调整任务顺序,以更改任务执行顺序。 选择一个任务并点击 编辑按钮 以编辑该任务。 单击 移除按钮 可从列表中删除所选任务。

显示此页面

在实际启动运行配置前显示其设置。

激活工具窗口

根据配置类型,在启动此运行配置时打开 运行调试服务 工具窗口。 如果禁用此选项,您可以手动打开工具窗口:

  • 视图(V)| 工具窗口| 运行Alt+4

  • 视图(V)| 工具窗口| 调试Alt+5

  • 视图(V)| 工具窗口| 服务Alt+8

使用 修改选项(M) 菜单为运行配置添加高级选项:

项目

说明

随机发布所有暴露端口

将所有公开的容器端口发布到主机上的随机可用端口。

这类似于在命令行中使用 -P--publish-all 选项。

绑定端口

将特定容器端口映射到主机上的特定端口。

这类似于在命令行中使用 -p--publish 选项。

单击 浏览 (位于 绑定端口 字段中),并指定主机上的哪些端口应映射到容器中的哪些端口。 您还可以指定一个主机 IP,用于设置端口的访问来源(例如,您可以将其设置为 127.0.0.1 以仅在本地访问,或设置为 0.0.0.0 以允许网络内所有计算机访问)。

假设您已在主机的 3001 端口运行了 Node.js,并希望在容器中运行另一个 Node.js 实例并通过主机的 3000 端口访问。 将主机端口 3000 绑定到容器中的端口 3001 类似于设置以下命令行选项:

-p 3000:3001

您可以在 运行选项 字段中显式设置此选项,而不是配置 绑定端口 字段。

入口点

覆盖映像的默认 ENTRYPOINT

这类似于在命令行中使用 --entrypoint 选项。

命令

覆盖镜像的默认 CMD

这类似于将命令作为 docker run 的参数添加。

绑定挂载

将主机上的文件和目录挂载到容器中的特定位置。

这类似于在命令行中使用 -v--volume 选项。

绑定挂载 字段中点击 浏览 ,然后指定主机目录及其在容器中的挂载路径。 如果希望禁止向容器卷中写入,请选择 只读

例如,您可以将主机上的本地 Node.js 目录( /Users/jetbrains/WS/node_docker/web )挂载到容器内的某个目录( usr/src/app )。 以这种方式挂载卷类似于设置以下命令行选项:

-v /Users/jetbrains/WS/node_docker/web:usr/src/app

您可以在 运行选项 字段中显式设置此选项,而不是配置 绑定挂载 字段。

环境变量

指定环境变量。 您正在使用的基础镜像包含由 ENV 指令在 Dockerfile 中定义的环境变量。 新建的每个容器还会包含 Docker 自动设置的环境变量。 使用该字段可以覆盖任何变量或指定其他变量。

这类似于在命令行中使用 -e--env 选项。

环境变量 字段中点击 浏览 以添加变量的名称和值。

例如,如果希望在 REPL 中禁止颜色显示,请设置变量 NODE_DISABLE_COLORS = 1。 这类似于设置以下命令行选项:

--env NODE_DISABLE_COLORS=%env-var-value

您可以在 运行选项 字段中显式设置此选项,而不是配置 环境变量 字段。

运行选项

设置其他受支持的 docker run 选项。

例如,若要将容器连接到 my-net 网络并为其设置 my-app 别名,请指定以下内容:

--network my-net --network-alias my-app

附加到容器

连接到容器的标准输入、输出和错误流。

这类似于在命令行中使用 -a--attach 选项。

显示命令预览

预览用于执行运行配置的最终命令。

最后修改日期: 2025年 9月 26日