# Docker 映像运行配置

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

> **TL;DR**
> 创建：  `运行 | 编辑配置 |`  ![添加新配置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)  `| Docker 映像`

使用这种类型的配置来运行从本地现有镜像中创建的 Docker 容器，该镜像是您之前 [pulled](docker-images.html#pull-image)或 [built](docker-images.html#build-image)的。

![Docker Image 运行配置对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/docker-image-run-config.png)

Docker 使用 [docker run](https://docs.docker.com/engine/reference/commandline/run/) 命令，并采用以下语法：

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

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

默认情况下，   Docker 镜像   配置具有以下选项：

|  条目  |  描述  |
| --- | --- |
|    名称    |  在编辑或运行时，指定运行配置的名称以便快速识别。  |
|    允许多个实例    |     允许并行运行此运行配置的多个实例。       默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置，IntelliJ IDEA 建议停止正在运行的实例并启动另一个。 当一个运行配置消耗大量资源且没有充分理由运行多个实例时，这会很有帮助。     |
|    存储为项目文件    |     将运行配置设置的文件保存下来，与其他团队成员共享。 默认位置是  `.idea/runConfigurations` 。 但是，如果您不想共享  `.idea` 目录，您可以将配置保存到项目内的任何其他目录。       默认情况下，它是禁用的，并且 IntelliJ IDEA 将运行配置设置存储在  `.idea/workspace.xml` 。     |
|    服务器    |  选择用于此运行配置的 [Docker 守护进程连接](docker.html#connect_to_docker)。  |
|    镜像 ID 或名称    |  指定标识符或要从中创建容器的 Docker 镜像名称。  |
|    容器名称    |     为容器指定一个可选名称。 如果留空，Docker 将为容器生成一个随机名称。       这类似于将  `--name`  选项与  `docker run`  命令配合使用。     |
|    启动前    |     指定在启动运行配置之前要执行的任务列表。 例如，运行另一个配置、构建必要的构件、运行某个外部工具或 Web 浏览器等。       点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) 或按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) 添加一个可用任务。       使用 ![“向上”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.moveUp.svg) 和 ![“向下”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.moveDown.svg) 移动列表中的任务，以更改任务的执行顺序。 选择一个任务并点击 ![编辑按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.edit.svg) 来编辑该任务。 点击 !["移除"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.remove.svg) 从列表中移除所选任务。     |
|    显示此页面    |  在实际启动运行配置之前显示其设置。  |
|    激活工具窗口    |     根据配置类型，启动此运行配置时，将打开 [运行](run-tool-window.html)、 [调试](debug-tool-window.html) 或 [服务](services-tool-window.html) 工具窗口。 如果此选项被禁用，您可以手动打开工具窗口：        * `视图 \| 工具窗口 \| 运行` 或 `Alt+4` (Windows), `⌘ 4` (macOS), `⌘ 4` (IntelliJ IDEA Classic (macOS)), `⌘ 4` (macOS System Shortcuts), `Alt+4` (XWin), `Alt+4` (GNOME), `Alt+4` (KDE), `Alt+4` (Emacs), `Alt+4` (Sublime Text), `⌘ 4` (Sublime Text (macOS)), `Alt+4` (Visual Studio), `⌘ 4` (Visual Studio (macOS)), `Alt+4` (NetBeans), `Alt+4` (Eclipse), `⌘ 4` (Eclipse (macOS))    * `视图 \| 工具窗口 \| 调试` 或 `Alt+5` (Windows), `⌘ 5` (macOS), `⌘ 5` (IntelliJ IDEA Classic (macOS)), `⌘ 5` (macOS System Shortcuts), `Alt+5` (XWin), `Alt+5` (GNOME), `Alt+5` (KDE), `Alt+5` (Emacs), `Alt+5` (Sublime Text), `⌘ 5` (Sublime Text (macOS)), `Alt+5` (Visual Studio), `⌘ 5` (Visual Studio (macOS)), `Alt+5` (NetBeans), `Alt+5` (Eclipse), `⌘ 5` (Eclipse (macOS))    * `查看 \| 工具窗口 \| 服务` 或 `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))    |

使用   修改选项   菜单向运行配置添加高级选项：

|  条目  |  描述  |
| --- | --- |
|    随机发布所有已暴露端口    |     将所有已公开的容器端口发布到主机上的随机空闲端口。       这类似于在命令行上使用  `-P`  或  `--publish-all`  选项。     |
|    绑定端口    |     将特定容器端口映射到主机上的特定端口。       这类似于在命令行上使用  `-p`  或  `--publish`  选项。       点击   绑定端口   字段中的 ![浏览](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.open.svg)，并指定主机上的哪些端口应映射到容器中的哪些端口。 还可以提供一个特定的主机 IP，使该端口可从该地址访问（例如，可以将其设置为  `127.0.0.1`  以仅允许本地访问，或将其设置为  `0.0.0.0`  以向网络中的所有计算机开放）。       假设 PostgreSQL 已在主机端口 5432 上运行，并且您想在容器中运行另一个 PostgreSQL 实例，并通过端口 5433 从主机访问它。 将主机端口 5433 绑定到容器中的端口 5432 类似于设置以下命令行选项：       ```PLAINTEXT -p 5433:5432 ```      您可以在   运行选项   字段中显式设置此选项，而不是配置   绑定端口   字段。     |
|    Entrypoint    |     重写镜像的默认  `ENTRYPOINT` 。       这类似于在命令行上使用  `--entrypoint`  选项。     |
|    命令    |     重写镜像的默认  `CMD` 。       这类似于将该命令作为  `docker run`  的实参添加。     |
|    绑定挂载    |     将主机上的文件和目录挂载到容器中的特定位置。       这类似于在命令行上使用  `-v`  或  `--volume`  选项。      > **Note:** > 确保在 [Docker 连接设置](docker.html#daemon-connection)（   路径映射   表）中，已将必要的本地路径映射到虚拟机。      点击   绑定挂载   字段中的 ![浏览](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.open.svg)，并指定主机目录以及它应挂载到容器中的对应路径。 如果要禁用对容器卷的写入，请选择   只读  。       例如，可以将主机上的本地 PostgreSQL 目录（  `/Users/Shared/pg-data` ）挂载到容器内的某个目录（  `/var/lib/pgsql/data` ）。 以这种方式挂载卷类似于设置以下命令行选项：       ```PLAINTEXT -v /Users/Shared/pg-data:/var/lib/pgsql/data ```      您可以在   运行选项   字段中显式设置此选项，而不是配置   绑定挂载   字段。     |
|    环境变量    |     指定环境变量。 您所使用的基础镜像相关的环境变量是由  `ENV`  指令在 [Dockerfile](https://docs.docker.com/engine/reference/builder/) 中定义的。 每个新容器还有 [Docker 自动设置的环境变量](https://docs.docker.com/engine/reference/run/#env-environment-variables)。 使用此字段重写任意变量或指定其他变量。       这类似于在命令行上使用  `-e`  或  `--env`  选项。       点击   环境变量   字段中的 ![浏览](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.open.svg)，为变量添加名称和值。       例如，如果要默认使用特定用户名连接到 PostgreSQL（而不是使用运行应用程序的用户的操作系统名称），可以将  `PGUSER`  变量设置为所需值。 这类似于设置以下命令行选项：       ```PLAINTEXT --env PGUSER=%env-var-value ```      您可以在   运行选项   字段中显式设置此选项，而不是配置   环境变量   字段。     |
|    运行选项    |     设置任何其他受支持的 [docker 运行](https://docs.docker.com/engine/reference/commandline/run/) 选项。       例如，要将容器连接到  `my-net`  网络并为其设置  `my-app`  别名，请指定以下内容：       ```PLAINTEXT --network my-net --network-alias my-app ```     > **Note:** > 并非所有  `docker run`  选项都受支持。 如果您希望请求支持某个选项，请在 [IDEA-181088](https://youtrack.jetbrains.com/issue/IDEA-181088) 中发表评论。    |
|    附加到容器​​    |     附加到容器的标准输入、输出和错误流。       这类似于在命令行上使用  `-a`  或  `--attach`  选项。     |
|    拉取镜像    |     定义是否希望 IntelliJ IDEA 在运行容器之前拉取 Docker 镜像：        * 缺失 ：如果本地缺少 Docker 镜像，IntelliJ IDEA 将从镜像仓库拉取该镜像。    * 始终 ：IntelliJ IDEA 将始终从镜像仓库拉取 Docker 镜像。    * 从不 ：IntelliJ IDEA 永远不会从镜像仓库拉取 Docker 镜像。    |
|    显示命令预览    |     预览将用于执行运行配置的结果命令。     |

