# Dockerfile 运行配置

> 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)  `| Dockerfile`

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

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

Docker 使用 [docker build](https://docs.docker.com/engine/reference/commandline/build/) 命令从 Dockerfile 构建镜像，然后使用 [docker run](https://docs.docker.com/engine/reference/commandline/run/) 命令从该镜像运行容器。

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

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

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

|  条目  |  描述  |
| --- | --- |
|    上下文文件夹​​​​    |  在构建过程中，指定 daemon 将使用的本地目录。 Dockerfile 中的所有主机路径将相对于此目录进行处理。 默认情况下，如果您将其留空，Docker 会使用 Dockerfile 所在的同一目录。  |
|    构建参数    |     指定构建时变量的值，这些变量在构建过程中可以像常规环境变量一样访问，但不会在中间或最终镜像中持久存在。       这类似于将  `--build-args`  选项与  `docker build`  命令配合使用。       这些变量必须通过  `ARG`  指令在 Dockerfile 中定义。 例如，您可以为即将使用的基础镜像版本定义一个变量：       ```PLAINTEXT ARG PGTAG=latest  FROM postgres:$PGTAG  ```      在这种情况下，  `PGTAG`  变量将默认为  `最新` ，并且 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`  选项为构建的镜像指定元数据。     |
|    运行已构建镜像    |  如果选中，IntelliJ IDEA 将在构建 Docker 镜像后运行该镜像。  |
|    随机发布所有已暴露端口    |     将所有已公开的容器端口发布到主机上的随机空闲端口。       这类似于在命令行上使用  `-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`  选项。     |
|    显示命令预览    |     预览将用于执行运行配置的结果命令。     |

