# Dockerfile 运行配置

> 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)  `| Dockerfile 力）??禧? final schema no; We need valid. Wait what? final accidental? Need correct. Use final with JSON only. Need no extra. But model final channel with response_format; I must provide JSON matching schema. Do not include accidental. Let's final.}]} Wait I need replace final. Can't include malformed. Let's produce exactly. 亚洲欧美? Need ensure not adding text. final: {`

使用此类配置从 Dockerfile 构建映像，然后从此映像派生一个容器。

Docker 使用 [docker 构建](https://docs.docker.com/engine/reference/commandline/build/) 命令从 Dockerfile 构建镜像，然后使用 [docker 运行](https://docs.docker.com/engine/reference/commandline/run/) 命令从该镜像启动容器。 萌萌哒？ Wait no trailing. Need final clean.}]} in final? I accidentally typed possible. Need final valid JSON. Let's craft complete. No commentary. Use response_format? final channel can be JSON. Need not annotate processData? In final plain object maybe. Ensure no extra. Also if using tool? Actually final response can be JSON following schema. We need ensure no accidental words. Let's formulate final. For object1 maybe

默认情况下，   Dockerfile   配置具有以下选项：

|  项  |  描述  |
| --- | --- |
|    名称    |  为运行配置指定一个名称，以便在编辑或运行时能快速识别。  |
|    允许多个实例    |     允许并行运行多个此运行配置实例。       默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，CLion建议停止正在运行的实例并启动另一个实例。 这在运行配置消耗大量资源且没有充分理由运行多个实例时非常有用。     |
|    存储为项目文件    |     将运行配置设置保存到文件中，以便与其他团队成员共享。 默认位置是  `.idea/runConfigurations` 。 但是，如果您不想共享  `.idea` 目录，您可以将配置保存到项目中的任何其他目录。       默认情况下，它是禁用的，并且 CLion 将运行配置设置存储在  `.idea/workspace.xml` 。     |
|    服务器    |  请选择要用于运行配置的 [Docker daemon connection](docker.html#connect_to_docker)。  |
|    Dockerfile    |  指定用于构建镜像的 Dockerfile 的名称和位置。  |
|    镜像标记    |     为生成的镜像指定一个可选名称和标签。       这对将来参考图像会有所帮助。 如果您将该字段留空，图像将只有一个随机唯一标识符。     |
|    容器名称    |     为容器指定一个可选名称。 如果留空，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))    |

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

|  项  |  描述  |
| --- | --- |
|    上下文文件夹    |  在构建过程中，指定 daemon 将使用的本地目录。 Dockerfile 中的所有主机路径将相对于此目录进行处理。 默认情况下，如果您将其留空，Docker 会使用 Dockerfile 所在的同一目录。  |
|    构建参数    |     指定构建时变量的值，这些变量在构建过程中可以像常规环境变量一样访问，但不会在中间或最终镜像中持久存在。       这与使用  `--build-args`  选项和  `docker build`  命令相似。       这些变量必须通过  `ARG`  指令在 Dockerfile 中定义。 例如，您可以为即将使用的基础镜像版本定义一个变量：       ```PLAINTEXT ARG PGTAG=latest  FROM postgres:$PGTAG  ```      在这种情况下，  `PGTAG`  变量将默认为  `latest` ，并且 Dockerfile 将会生成一个具有最新可用版本 PostgreSQL 的镜像，除非您将其重新定义为构建时参数。 如果您设置，  `PGTAG=9` ，Docker 将拉取  `postgres:9` ，这将运行一个 PostgreSQL 版本 9 的容器。       将  `PGTAG`  参数重新定义类似于设置以下命令行选项：       ```PLAINTEXT --build-arg PGTAG=9 ```      您可以提供用空格分隔的多个参数。     |
|    构建选项    |     设置支持的 [docker build     选项](https://docs.docker.com/reference/cli/docker/image/build/#options)。       例如，您可以使用  `--label`  选项为构建的镜像指定元数据。     |
|    运行已构建的镜像    |  如果选中，CLion 将在构建 Docker 镜像后运行该镜像。  |
|    随机发布所有 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`  选项。     |
|    显示命令预览    |     预览将用于执行运行配置的生成命令。     |

