首页/云/Docker 容器速查/ENV 设置环境变量
镜像与构建107 条

ENV 设置环境变量

定义镜像内持久环境变量:构建后续指令与容器运行时都可见,是配置镜像行为与固定时区/编码的常规手段。

Docker 容器速查云更新于 2026-10-12
用途持久化环境变量
语法ENV KEY=VALUE(可一行多个赋值)
生效范围构建期 + 运行期(写入镜像配置)

示例

示例
ENV NODE_ENV=production
ENV LANG=C.UTF-8 TZ=Asia/Shanghai
RUN echo "env=$NODE_ENV" > /tmp/probe.txt
运行时可用 docker run -e 覆盖 ENV 值;ENV 应只放非敏感配置,密钥不进入镜像配置。

易错点

  • 旧式写法 ENV KEY VALUE 会把空格后的整串当作值,统一用 KEY=VALUE 避免踩坑
  • 修改 ENV 会使其后所有层缓存失效,微小改动也可能触发长构建

数据来源与参考

  • Docker 官方文档:Dockerfile ENV(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌