docker中可用arg+run动态生成配置文件，支持直接拼接、envsubst模板替换或shell脚本逻辑生成，需注意arg作用域、run独立性及敏感信息保护。
在 Docker 构建阶段，RUN 指令本身不支持“动态参数注入”，但它可以结合 ARG（构建参数）和 shell 命令，在镜像构建时实时生成配置文件——关键在于让 RUN 能读取 ARG 的值，并用 echo、cat、sed、envsubst 等工具写入内容。
用 ARG + RUN 直接拼接生成配置文件
这是最常用、最轻量的方式。先声明带默认值的 ARG，再在 RUN 中用 shell 语法生成文件：
Dockerfile 片段示例：
ARG APP_VERSION=1.0.0
ARG ENVIRONMENT=staging
RUN echo "version: ${APP_VERSION}" > /app/config.yaml && \
echo "env: ${ENVIRONMENT}" >> /app/config.yaml && \
echo "build_time: $(date -u +%Y-%m-%dT%H:%M:%SZ)" >> /app/config.yaml
构建时可覆盖：
docker build --build-arg APP_VERSION=2.3.1 --build-arg ENVIRONMENT=production -t myapp .
生成的 /app/config.yaml 就会包含实际传入的值，且时间戳是构建时刻的真实输出。
用 envsubst 替换模板文件（推荐用于复杂配置）
适合已有 YAML/JSON/INI 模板，需安全替换多处变量的场景。需先安装 gettext-base（Debian/Ubuntu）或 gettext（Alpine）：
- 准备模板：
config.template.yaml（内容含$APP_VERSION、${ENVIRONMENT}等） - Dockerfile 中：
COPY config.template.yaml /tmp/config.template.yaml RUN apt-get update && apt-get install -y gettext-base && \ envsubst /app/config.yaml && \ rm /tmp/config.template.yaml - 注意：
envsubst只替换已声明为 ARG（且在当前构建阶段可见）的变量，未定义的变量会被留空或报错（加-no-empty可跳过）
用脚本生成（适合逻辑判断或组合逻辑）
当配置需根据条件分支生成（如：开发环境开调试日志，生产环境关），可写一个小型 shell 脚本：
- 新建
gen-config.sh（放在项目根目录）：#!/bin/sh echo "log_level: ${LOG_LEVEL:-info}" if [ "$ENVIRONMENT" = "production" ]; then echo "debug: false" echo "metrics_enabled: true" else echo "debug: true" echo "metrics_enabled: false" fi - Dockerfile 中：
COPY gen-config.sh /tmp/gen-config.sh RUN chmod +x /tmp/gen-config.sh && \ /tmp/gen-config.sh > /app/config.yaml
注意事项与避坑点
- ARG 作用域有限：若使用多阶段构建，每个阶段需单独声明所需 ARG；FROM 后声明的 ARG 对之前指令不可见
- RUN 是独立层：每次 RUN 启动新 shell，变量不会跨 RUN 持久化（所以不能在前一个 RUN export，后一个 RUN 直接用）
-
敏感信息勿硬写：避免在 RUN 中 echo 密码或 token；如必须，优先用 BuildKit 的
--secret机制替代 ARG -
路径权限：确保目标目录（如
/app）已用RUN mkdir -p /app创建，否则写入失败
