ENV指令用于在Dockerfile中设置持久化环境变量，作用于构建和运行两个阶段，变量写入镜像层、可被后续指令引用，并支持运行时通过-e或--env-file覆盖。

Dockerfile 中使用 ENV 指令可以为容器运行时设置环境变量，这些变量在构建阶段和运行阶段都有效，且对所有后续指令（包括 RUN、CMD、ENTRYPOINT）可见。

ENV 的基本语法和作用范围

ENV 有两种写法：

• ENV <key> <value>（推荐，单个变量）
• ENV <key>=<value> ...（支持多变量，空格分隔）

定义的变量会持久写入镜像层，成为容器默认环境的一部分。它不同于 ARG（仅构建时有效），ENV 变量在容器启动后依然存在，可通过 docker run --env 覆盖，但无法被 ARG 替代。

如何让 ENV 变量在构建阶段生效

ENV 设置后，后续的 RUN 命令能直接引用该变量（用 $VAR 或 ${VAR}）：

ENV NODE_ENV=production
ENV APP_HOME=/app
WORKDIR $APP_HOME
RUN echo "Running in $NODE_ENV mode" > /tmp/status.txt

注意：ENV 必须出现在使用它的 RUN 指令之前；变量不能跨 FROM 指令继承（多阶段构建中每个阶段需重新声明）。

minimax-mcp-docker版（适配极空间）

MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。

下载

覆盖与优先级注意事项

运行时传入的环境变量会覆盖 Dockerfile 中的 ENV：

• docker run -e NODE_ENV=development myimage → 容器内 NODE_ENV 为 development
• 若未指定，则沿用 Dockerfile 中定义的值
• docker run --env-file 加载的文件变量也具有相同覆盖能力

不建议在 ENV 中硬编码敏感信息（如密码），应改用 --secret 或挂载文件方式处理。

常见误用与替代建议

以下情况不适合用 ENV：

• 仅用于构建过程的临时值（改用 ARG + ENV 组合）
• 需要不同值的多个镜像变体（用 ARG 构建参数更灵活）
• 希望完全隔离环境配置（可结合 .env 文件 + 启动脚本动态加载）

例如，构建时区分版本但运行时固定：

ARG APP_VERSION
ENV APP_VERSION=${APP_VERSION:-1.0.0}