如何从容器外部连接Docker Compose部署的PostgreSQL数据库

我用docker-compose.yaml部署了PostgreSQL数据库，配置如下：

services:
    ... 
    db:
        image: postgres:12.0-alpine
        volumes:
            - postgres_data:/var/lib/postgresql/data/
        environment:
            - POSTGRES_USER=username
            - POSTGRES_PASSWORD=password
            - POSTGRES_DB=dbname
        ports:
            - "5432:5432"
        expose: 
            - 5432

容器内部可以正常连接，命令如下：

docker exec -ti CONTAINER_NAME-db bash
bash-5.0# psql -U username -d dbname -h db
Password for user username: 
psql (12.0)
Type "help" for help.

dbname=# 

但从容器外部尝试连接时全部失败，尝试的三种方式及错误如下：

1. psql -U username -d dbname -h db
   无任何输出
2. psql -h localhost -p 5432 -U username -d dbname
   错误：psql: error: connection to server at "localhost" (127.0.0.1), port 5432 failed: FATAL: role "username" does not exist
3. psql -h 0.0.0.0 -p 5432 -U username -d dbname
   错误：psql: error: connection to server at "0.0.0.0", port 5432 failed: FATAL: role "username" does not exist

问题原因及解决步骤 #

PostgreSQL默认只允许容器内部的本地连接，且监听地址仅限localhost，外部请求即使通过端口映射进来也会被拒绝，这就是出现"role不存在"错误的核心原因（实际是连接未被允许，而非用户真的不存在）。

1. 修改PostgreSQL访问控制配置

进入容器内部编辑pg_hba.conf文件：

docker exec -ti CONTAINER_NAME-db bash

在/var/lib/postgresql/data/pg_hba.conf末尾添加一行，允许所有外部IP通过密码验证连接（如果要更安全，可以替换0.0.0.0/0为你的宿主机IP段，比如192.168.1.0/24）：

host    all             all             0.0.0.0/0               md5

2. 修改监听地址配置

编辑/var/lib/postgresql/data/postgresql.conf文件，找到listen_addresses参数，修改为：

listen_addresses = '*'

默认值是localhost，只允许容器内部访问，修改后允许监听所有网络地址。

3. 重启容器生效配置

docker restart CONTAINER_NAME-db

4. 外部连接的正确命令

在宿主机上直接用localhost连接，或者在其他机器上用宿主机的公网/局域网IP：

psql -h localhost -p 5432 -U username -d dbname

输入密码password即可正常连接。

之前尝试失败的原因 #

• 第一种方式用-h db：db是Docker Compose内部的服务域名，仅在容器所在的Docker网络内有效，外部网络无法解析这个名称，所以无输出。
• 第二、三种方式之前失败：因为PostgreSQL默认不允许外部连接，监听地址也没开放，导致连接请求被拦截，返回的错误信息有误导性，但本质是连接未被授权。

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