如何向docker-entrypoint-initdb.d下的init.sql传递变量

官方PostgreSQL镜像默认不会对/docker-entrypoint-initdb.d/目录下的.sql文件做变量替换，你可以选以下两种方案实现变量传递：

方案1：Shell脚本包装（支持构建/运行时传参，最灵活） #

镜像执行初始化逻辑时，会自动运行目录下后缀为.sh的shell脚本，你可以在脚本里先完成变量替换生成最终SQL，再调用psql执行。

• 修改Dockerfile：

FROM postgres
# 支持构建时传参，也可运行容器时通过环境变量覆盖
ARG TABLE_NAME
ENV TARGET_TABLE=${TABLE_NAME}

# 添加shell初始化脚本，不要直接放原始sql
ADD init-db.sh /docker-entrypoint-initdb.d/
# 给脚本加执行权限
RUN chmod +x /docker-entrypoint-initdb.d/init-db.sh

• 新建init-db.sh替换原来的init.sql：

#!/bin/bash
set -e

# 替换变量生成最终SQL文件
cat > /tmp/final-init.sql <<EOF
CREATE TABLE ${TARGET_TABLE}(
id SERIAL PRIMARY KEY,
name VARCHAR(500) NOT NULL,
completed BOOLEAN NOT NULL);
EOF

# 调用镜像内置的psql执行SQL
psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" -f /tmp/final-init.sql

• 传参方式：
  • 构建镜像时传参：docker build --build-arg TABLE_NAME=my_task -t custom-postgres .
  • 运行容器时动态覆盖参数：docker run -e TARGET_TABLE=runtime_task -d custom-postgres

方案2：构建阶段直接替换SQL（适合参数固定的场景） #

如果变量不需要在运行时修改，可以直接在镜像构建阶段用sed替换SQL文件里的占位符，不需要额外写shell脚本。

• 修改Dockerfile：

FROM postgres
ARG SOME_ARGUMENT_HERE

# 先复制SQL模板
COPY init.sql /tmp/init.template.sql
# 替换占位符后放到初始化目录
RUN sed "s/\${SOME_ARGUMENT_HERE}/${SOME_ARGUMENT_HERE}/g" /tmp/init.template.sql > /docker-entrypoint-initdb.d/init.sql

• 传参方式：构建时加--build-arg SOME_ARGUMENT_HERE=my_table即可，参数会在构建阶段固化到init.sql里，运行容器时无法修改。

注意事项 #

• 如果变量内容来自外部不可信输入，不要直接拼接SQL，避免SQL注入风险，固定表名、字段名等内部配置场景可以放心用
• 运行时传参不要把敏感值硬编码在Dockerfile里，用docker run --env-file或者编排工具的密钥配置传递更安全

内容的提问来源于stack exchange，提问作者Inspiraller