Dockerfile 中应通过 entrypoint.sh 在容器启动时动态注入配置，利用 envsubst 渲染模板并优先使用挂载的配置文件，避免构建时硬编码。
在 dockerfile 中实现动态注入配置文件，通常不建议直接在构建阶段写死配置，而是通过启动时（容器运行时）注入。核心思路是：把配置生成逻辑放在启动脚本里，利用环境变量、挂载卷或 configmap（k8s）等外部输入，在容器启动时生成/覆盖配置文件，再执行真正服务命令。
用 entrypoint.sh 实现运行时配置生成
这是最常用且可移植的方式。你需要：
- 编写一个 shell 启动脚本（如 entrypoint.sh），负责读取环境变量（如 DB_HOST、REDIS_URL）并渲染配置模板
- 使用 envsubst 或 sed 替换模板中的占位符（例如
$$DB_HOST$$或${DB_HOST}） - 确保脚本有执行权限，并在 Dockerfile 中通过 ENTRYPOINT 调用它
示例：
准备 app.conf.template：
host = ${DB_HOST:-localhost}<br>port = ${DB_PORT:-5432}<br>timeout = ${TIMEOUT:-30}
对应 entrypoint.sh：
#!/bin/sh<br>set -e<br>envsubst < /app/app.conf.template > /app/app.conf<br>exec "$@"
Dockerfile 片段：
COPY app.conf.template /app/<br>COPY entrypoint.sh /app/<br>RUN chmod +x /app/entrypoint.sh<br>ENTRYPOINT ["/app/entrypoint.sh"]<br>CMD ["./myapp"]
支持挂载配置文件或跳过生成
增强健壮性：如果用户已挂载了完整配置文件（如 -v ./my.conf:/app/app.conf），脚本应优先使用它，避免覆盖。
- 在 entrypoint.sh 开头加判断：
if [ -f /app/app.conf ]; then exec "$@"; fi - 或者只在配置缺失时才生成：
[ ! -f /app/app.conf ] && envsubst < /app/app.conf.template > /app/app.conf
避免常见坑
- envsubst 默认只替换 $VAR 形式，不处理 ${VAR}；若模板用花括号，需传入 SHELL 变量或改用
envsubst '$$VAR'（注意单引号防提前展开） -
基础镜像可能不含
envsubst：Alpine 需apk add --no-cache gettext，Debian 系需apt-get install -y gettext-base -
ENTRYPOINT 和 CMD 组合要理解清楚：上面写法中
exec "$@"会执行 CMD 内容；若想固定命令，可把 CMD 移到 entrypoint.sh 末尾
进阶：多格式配置（JSON/YAML）可用轻量工具
对 JSON 配置，可用 jq 动态生成；对 YAML，可用 yq（v4+ 基于 jq）。例如：
echo '{"db": {"host": "${DB_HOST}", "port": ${DB_PORT}}}' | envsubst | jq -r '.' > config.json
只需在镜像中预装对应工具，并确保环境变量名与模板一致即可。
