# Docker 映像运行配置

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

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

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

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

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

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

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

|  项  |  描述  |
| --- | --- |
|    名称    |  为运行配置指定一个名称，以便在编辑或运行时能快速识别。  |
|    允许多个实例    |     允许并行运行多个此运行配置实例。       默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，CLion建议停止正在运行的实例并启动另一个实例。 这在运行配置消耗大量资源且没有充分理由运行多个实例时非常有用。     |
|    存储为项目文件    |     将运行配置设置保存到文件中，以便与其他团队成员共享。 默认位置是  `.idea/runConfigurations` 。 但是，如果您不想共享  `.idea` 目录，您可以将配置保存到项目中的任何其他目录。       默认情况下，它是禁用的，并且 CLion 将运行配置设置存储在  `.idea/workspace.xml` 。     |
|    服务器    |  请选择要用于运行配置的 [Docker daemon connection](docker.html#connect_to_docker)。  |
|    镜像 ID 或名称    |  指定标识符或要从中创建容器的 Docker 镜像名称。  |
|    容器名称    |     为容器指定一个可选名称。 如果留空，Docker 将为容器生成一个随机名称。       这与使用  `--name`  选项和  `docker run`  命令相似。     |
|    启动前    |     指定在开始运行配置之前执行的任务列表。 例如，运行其他配置，构建必要的工件，运行一些外部工具或网络浏览器，等等。       点击 ![添加按钮](https://resources.jetbrains.com/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)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) 以添加一个可用的任务。       在列表中使用 ![上移按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveUp.svg) 和 ![下移按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveDown.svg) 移动任务，以更改执行任务的顺序。 选择任务并点击 ![“编辑”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg)以编辑任务。 点击 !["移除"按钮](https://resources.jetbrains.com/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)), `⌘ 6` (Xcode), `Alt+4` (Visual Studio), `⌘ 4` (Visual Studio (macOS)), `Alt+4` (ReSharper), `⌘ 4` (ReSharper (macOS)), `Alt+3` (QtCreator), `⌘ 3` (QtCreator (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)), `⌘ 7` (Xcode), `Alt+5` (Visual Studio), `⌘ 5` (Visual Studio (macOS)), `Alt+5` (ReSharper), `⌘ 5` (ReSharper (macOS)), `Alt+5` (QtCreator), `⌘ 5` (QtCreator (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)), `⌘ 8` (Xcode), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (ReSharper), `Alt+8` (ReSharper (macOS)), `Alt+8` (QtCreator), `⌘ 8` (QtCreator (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))    |

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

|  项  |  描述  |
| --- | --- |
|    随机发布所有 Exposed 端口    |     将所有公开的容器端口发布到主机上的随机空闲端口。       这类似于在命令行上使用  `-P`  或  `--publish-all`  选项。     |
|    绑定端口    |     将特定容器端口映射到主机上的特定端口。       这类似于在命令行上使用  `-p`  或  `--publish`  选项。       在   绑定端口   字段中点击 ![浏览](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.open.svg)，并指定主机上的哪些端口应映射到容器中的哪些端口。 还可以提供一个特定的主机 IP，使该端口可从该 IP 访问（例如，可以将其设置为  `127.0.0.1`  以仅允许本地访问，或设置为  `0.0.0.0`  以向网络中的所有计算机开放）。       假设主机端口 5432 上已经运行 PostgreSQL，并且想在容器中运行另一个 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/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/help/img/idea/2026.3/app.expui.general.open.svg)，以添加变量名称和值。       例如，如果想默认使用特定用户名连接到 PostgreSQL（而不是使用运行该应用程序的用户在操作系统中的用户名），可以将  `PGUSER`  变量设置为所需值。 这类似于设置以下命令行选项：       ```PLAINTEXT --env PGUSER=%env-var-value ```      可以在   运行选项   字段中显式设置此选项，而不是配置   环境变量   字段。     |
|    运行选项    |     设置任何其他受支持的 [docker run](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`  选项。     |
|    拉取镜像    |     定义是否希望 CLion 在运行容器前拉取 Docker 镜像：        * 缺失 ：如果本地缺少 Docker 镜像，CLion 将从注册表拉取该镜像。    * 始终 ：CLion 将始终从注册表拉取 Docker 镜像。    * 从不 ：CLion 将永远不会从注册表拉取 Docker 镜像。    |
|    显示命令预览    |     预览将用于执行运行配置的生成命令。     |

