无法从Python连接Docker部署的PostgreSQL实例求助

让我来帮你拆解这个问题——我遇过好多次类似的Docker+PostgreSQL连接坑了，核心原因其实是你的PostgreSQL配置修改根本没生效，再加上初期的端口映射问题，导致外部无法建立TCP连接。

为什么docker exec能连，但外部不行？ #

docker exec是直接进入容器内部访问PostgreSQL，默认情况下PostgreSQL允许本地连接（不管是Unix socket还是localhost的TCP连接），所以不需要额外配置就能通。但容器外的Python或DbVisualizer是通过容器IP/宿主机IP发起的远程TCP连接，这就需要PostgreSQL开启监听外部地址，同时在pg_hba.conf里授权远程访问——而你的配置因为Docker镜像的初始化逻辑被覆盖了，等于白改。

看你的Dockerfile，你在构建镜像时直接修改了/var/lib/postgresql/data下的配置文件，但官方PostgreSQL镜像有个关键逻辑：当容器第一次启动时，如果/var/lib/postgresql/data目录是空的，会自动初始化数据库，生成全新的pg_hba.conf和postgresql.conf，这直接把你在Dockerfile里改的文件覆盖了，等于你的配置从来没生效过。

至于日志里的could not bind IPv6 socket: Cannot assign requested address，这个是小问题，只是容器没有分配IPv6地址，完全不影响IPv4的连接，可以忽略。

解决方案（按推荐程度排序） #

方案1：用自定义初始化脚本（最规范，适合生产） #

官方PostgreSQL镜像会在数据库第一次初始化完成后，自动执行/docker-entrypoint-initdb.d/目录下的脚本，这样修改的配置不会被初始化逻辑覆盖：

1. 新建一个init-postgres.sh脚本：

#!/bin/bash
set -e

# 允许所有IP用md5密码连接
echo "host all all 0.0.0.0/0 md5" >> /var/lib/postgresql/data/pg_hba.conf

# 让PostgreSQL监听所有网卡地址
echo "listen_addresses='*'" >> /var/lib/postgresql/data/postgresql.conf

# 启动PostgreSQL（必须用exec让进程成为容器PID1，保证信号能正确传递）
exec postgres

2. 修改你的Dockerfile，把脚本加进去：

# 用你原来的基础镜像或者官方postgres:9.6.5
FROM df:pg

# 复制初始化脚本到官方指定的目录
COPY init-postgres.sh /docker-entrypoint-initdb.d/

# 给脚本加执行权限
RUN chmod +x /docker-entrypoint-initdb.d/init-postgres.sh

EXPOSE 5432
VOLUME ["/etc/postgresql", "/var/log/postgresql", "/var/lib/postgresql", "/usr/lib/postgresql/"]

3. 重新构建镜像，然后启动容器时记得做端口映射：

docker run -d -p 5432:5432 --name my-pg df:pg

方案2：挂载本地配置文件（适合快速调试） #

如果你不想重新构建镜像，可以直接把自定义的配置文件挂载到容器里：

1. 先从一个临时容器里拷贝默认配置到本地：

# 启动临时容器
docker run --rm -it df:pg bash
# 在另一个终端里拷贝配置文件
docker cp <临时容器ID>:/var/lib/postgresql/data/pg_hba.conf ./pg_hba.conf
docker cp <临时容器ID>:/var/lib/postgresql/data/postgresql.conf ./postgresql.conf

2. 修改本地的配置：

• 在pg_hba.conf末尾加一行：host all all 0.0.0.0/0 md5
• 在postgresql.conf里找到listen_addresses这行，改成listen_addresses='*'（如果注释了就去掉#）

3. 启动容器时挂载配置：

docker run -d -p 5432:5432 \
  -v $(pwd)/pg_hba.conf:/var/lib/postgresql/data/pg_hba.conf \
  -v $(pwd)/postgresql.conf:/var/lib/postgresql/data/postgresql.conf \
  --name my-pg df:pg

方案3：启动时直接传参数（最快，适合测试） #

如果只是测试用，可以直接在启动容器时给PostgreSQL进程传参数，跳过配置文件修改：

docker run -d -p 5432:5432 \
  -e POSTGRES_PASSWORD=nunyabiznes \
  -e POSTGRES_DB=cookiebox \
  --name my-pg \
  df:pg -c listen_addresses='*'

这里通过-c listen_addresses='*'强制PostgreSQL监听所有地址，再配合POSTGRES_HOST_AUTH_METHOD=md5（如果需要的话）就能快速开启远程访问。

验证连接 #

配置好后，用Python测试的时候，因为做了端口映射，直接用localhost和5432端口就行，不用再用容器IP了：

import psycopg2
try:
    conn = psycopg2.connect(
        dbname='cookiebox',
        user='postgres',
        host='localhost',
        password='nunyabiznes'
    )
    cur = conn.cursor()
    cur.execute("SELECT 1;")
    print("连接成功！", cur.fetchone())
    cur.close()
    conn.close()
except Exception as e:
    print("连接失败：", e)

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