PostgreSQL官方Docker镜像环境变量默认属root用户的原因及配置方法

问题 #

从Docker Hub的PostgreSQL官方镜像启动新容器实例时，环境变量默认在容器创建的Shell的root用户中定义并导出，而非postgres用户。

root用户执行env的输出：

PWD=/
HOME=/root
LANG=en_US.utf8
GOSU_VERSION=1.14
PG_MAJOR=15
PG_VERSION=15.1-1.pgdg110+1
TERM=xterm
SHLVL=1
POSTGRES_USER=postgres
PGDATA=/var/lib/postgresql/data
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/postgresql/15/bin
_=/usr/bin/env

postgres用户执行env的输出：

SHELL=/bin/bash
PWD=/var/lib/postgresql/data
LOGNAME=postgres
HOME=/var/lib/postgresql
TERM=xterm
USER=postgres
SHLVL=1
PATH=/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
MAIL=/var/mail/postgres
OLDPWD=/var/lib/postgresql/data/base
_=/usr/bin/env

请问出现该现象的原因是什么？是否有办法默认将这些变量设置到postgres用户中？

原因分析 #

• Docker容器启动时，所有环境变量都是在root用户的初始进程中注入的。官方PostgreSQL镜像使用gosu工具切换到postgres用户启动数据库服务，但gosu默认只会传递少数基础环境变量（如TERM），不会将root用户的全部环境变量继承给postgres用户。
• 镜像的入口脚本（/docker-entrypoint.sh）仅在root用户上下文使用这些PostgreSQL相关变量完成初始化（比如创建用户、配置PGDATA路径），切换到postgres用户后，脚本没有显式将这些变量导出给postgres用户的Shell环境，因为数据库服务本身运行时不需要依赖这些环境变量。

实现方法 #

方法1：修改镜像入口脚本（推荐用于自定义镜像） #

在官方镜像的/docker-entrypoint.sh中，切换到postgres用户之前，将需要的环境变量写入postgres用户的Shell配置文件（如~postgres/.bashrc）：

# 在脚本中gosu切换用户前添加以下内容
cat <<EOF >> /var/lib/postgresql/.bashrc
export PG_MAJOR=$PG_MAJOR
export PG_VERSION=$PG_VERSION
export POSTGRES_USER=$POSTGRES_USER
export PGDATA=$PGDATA
export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/postgresql/$PG_MAJOR/bin
EOF

构建自定义镜像后，启动容器时postgres用户登录Shell就能自动加载这些变量。

方法2：启动容器时显式传递变量 #

通过覆盖容器启动命令，在切换用户前导出环境变量：

docker run -d \
  --name postgres-demo \
  -e POSTGRES_USER=postgres \
  -e PG_MAJOR=15 \
  postgres:15 \
  bash -c '
    echo "export PG_MAJOR=$PG_MAJOR" >> /var/lib/postgresql/.bashrc;
    echo "export POSTGRES_USER=$POSTGRES_USER" >> /var/lib/postgresql/.bashrc;
    exec gosu postgres /docker-entrypoint.sh postgres
  '

这种方式不需要修改镜像，但要确保保留原入口脚本的执行逻辑，避免破坏数据库初始化流程。

方法3：容器运行后手动配置（临时场景） #

进入容器后，切换到postgres用户并修改Shell配置：

# 进入容器的root Shell
docker exec -it <container-id> bash
# 切换到postgres用户
su - postgres
# 添加环境变量到.bashrc
echo "export PG_MAJOR=15" >> ~/.bashrc
echo "export POSTGRES_USER=postgres" >> ~/.bashrc
# 立即生效
source ~/.bashrc

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