基于postgres:9.6自定义容器替换pg_hba.conf失败求助

问题根源 #

直接在Dockerfile中执行COPY pg_hba.conf /var/lib/postgresql/data/会导致容器启动失败，核心原因有两点：

1. postgres官方镜像将/var/lib/postgresql/data声明为VOLUME，构建镜像时复制到该目录的文件，会在容器首次启动时被初始化脚本（initdb）生成的默认配置覆盖。
2. 直接COPY的文件权限属于root用户，而postgres进程以postgres用户运行，无权限读取该文件，触发启动错误。

解决方案 #

方案1：用初始化脚本替换pg_hba.conf #

这种方式在数据库初始化完成后替换配置，确保文件权限正确且不会被覆盖。

步骤1：修改Dockerfile

移除原有的COPY pg_hba.conf /var/lib/postgresql/data/，改为将配置文件复制到临时目录，并添加初始化脚本：

FROM postgres:9.6.24

ENV POSTGRES_HOST_AUTH_METHOD=trust

# Create folder Downloads in Docker
WORKDIR /Downloads

COPY /plv8_v.2.x ./Downloads

RUN dpkg -i Downloads/plv8-96_2.1.0-2_amd64.deb
RUN dpkg -i Downloads/v8_3.14.5.10-26_amd64.deb

COPY /postgresql /usr/share/postgresql/9.6/extension/

# 复制自定义pg_hba.conf到临时目录
COPY pg_hba.conf /tmp/pg_hba.conf

# 复制初始化脚本并赋予执行权限
COPY setup-pg-hba.sh /docker-entrypoint-initdb.d/
RUN chmod +x /docker-entrypoint-initdb.d/setup-pg-hba.sh

步骤2：创建初始化脚本setup-pg-hba.sh

脚本内容如下，负责将临时目录的配置文件复制到数据目录，并修正权限：

#!/bin/bash
set -e

# 替换pg_hba.conf并设置正确权限
cp /tmp/pg_hba.conf /var/lib/postgresql/data/pg_hba.conf
chown postgres:postgres /var/lib/postgresql/data/pg_hba.conf

步骤3：构建并启动容器

执行原有的构建和启动命令即可：

docker build -t my_image .
docker run --name my_container --restart=always -d -p 127.0.0.1:5432:5432 my_image

方案2：修改postgres配置模板（更简洁） #

postgres初始化时会使用/usr/share/postgresql/9.6/pg_hba.conf.template作为模板生成最终的pg_hba.conf，直接替换该模板即可：

修改Dockerfile，添加：

# 替换pg_hba.conf模板，初始化时会自动生成目标配置
COPY pg_hba.conf /usr/share/postgresql/9.6/pg_hba.conf.template

这种方式不需要额外脚本，适合需要长期固定配置的场景。

方案3：用sed命令直接修改默认配置（无需维护完整文件） #

如果只需要修改一行内容，不需要复制整个pg_hba.conf，可以用sed命令在初始化脚本中替换目标行：

创建setup-pg-hba.sh脚本：

#!/bin/bash
set -e

# 替换默认的IP规则为0.0.0.0/0
sed -i 's/host    all             all            127.0.0.1\/0             trust/host    all             all            0.0.0.0\/0                trust/' /var/lib/postgresql/data/pg_hba.conf

然后在Dockerfile中复制该脚本到/docker-entrypoint-initdb.d/并赋予执行权限即可。

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