运行PostgreSQL容器时执行psql命令失败的问题求助

问题根源 #

• 你执行的docker run -it --rm postgres psql覆盖了postgres镜像的默认启动逻辑。postgres镜像默认会启动PostgreSQL服务器进程，但你在命令末尾指定了psql，这会让容器直接启动psql客户端程序，而不会启动PostgreSQL服务——这就是容器内找不到/var/run/postgresql/.s.PGSQL.5432 socket文件的原因。
• 主机上的socket文件属于主机本地运行的PostgreSQL服务，容器默认拥有独立的文件系统和网络空间，无法直接访问主机的socket资源。

对应解决办法 #

场景1：用容器内的psql连接容器内的PostgreSQL服务

需要先让容器启动PostgreSQL服务，再执行psql客户端：

• 分步操作：

# 后台启动PostgreSQL容器并命名
docker run -d --name my-postgres postgres
# 进入容器执行psql（默认用户是postgres）
docker exec -it my-postgres psql -U postgres

• 一次性命令（通过shell串联启动服务和客户端，需给服务留启动时间）：

docker run -it --rm postgres sh -c "postgres & sleep 5 && psql -U postgres"

场景2：用容器内的psql连接主机上的PostgreSQL服务

需要配置主机服务允许外部连接，并让容器能访问主机：

1. 调整主机的PostgreSQL配置：
   • 修改pg_hba.conf，添加允许容器所在网段的连接规则（比如host all all 172.17.0.0/16 md5）
   • 修改postgresql.conf，设置listen_addresses = '*'
   • 重启主机的PostgreSQL服务
2. 运行容器并指定主机地址：

# Docker Desktop环境用host.docker.internal指向主机
docker run -it --rm postgres psql -h host.docker.internal -U postgres

# Linux环境可直接用主机局域网IP，或者加--network host参数
docker run -it --rm --network host postgres psql -U postgres

内容的提问来源于stack exchange，提问作者it.drive.view