Docker容器无法连接本地Postgres及Zipkin端口问题求助

核心问题 #

容器内的localhost指向容器自身而非宿主机，这是连接拒绝的根本原因；另外Postgres默认仅监听本地回环地址，即便pg_hba配置了权限也无法被容器访问。

步骤1：修正应用连接配置 #

修改Spring Boot配置文件（如application.yml/application.properties）中的目标地址：

• 数据库URL：将jdbc:postgresql://localhost:5432/your_db改为jdbc:postgresql://host.docker.internal:5432/your_db
• Zipkin地址：将http://localhost:9411改为http://host.docker.internal:9411

若你的Docker环境不支持host.docker.internal（比如Linux原生Docker），直接替换为宿主机的实际局域网IP（如192.168.1.100）。

步骤2：调整Postgres监听配置 #

Postgres默认仅监听127.0.0.1，需修改postgresql.conf：

listen_addresses = '*'  # 允许监听所有网卡地址

修改后重启Postgres服务：

# Ubuntu/Debian
sudo systemctl restart postgresql

# CentOS/RHEL
sudo systemctl restart postgresql-15  # 版本号请按需调整

步骤3：正确使用Docker运行命令 #

根据需求选择以下一种方式：

方式A：使用host网络（共享宿主机网络栈）

容器与宿主机共用网络，此时容器内的localhost等价于宿主机，但无需端口映射（-p参数无效）：

docker run --network host media-service

⚠️ 注意：该方式下Postgres必须已配置监听*，否则仍无法连接。

方式B：默认桥接网络+添加host映射

隔离性更好的方案，需配合应用配置中的host.docker.internal地址：

docker run -p 8080:8080 --add-host host.docker.internal:host-gateway media-service

步骤4：验证pg_hba.conf配置生效 #

你已添加Docker子网权限，可先测试宽松配置（生产环境慎用）排除权限问题：

host    all        all      0.0.0.0/0   trust

修改后重启Postgres，确认连接正常后再换回严格的子网配置。

排查工具 #

若问题仍存在，用以下命令定位：

1. 进入容器测试端口可达性：

# 进入容器
docker exec -it <container-id> /bin/bash

# 测试Postgres端口
telnet host.docker.internal 5432
# 或用nc
nc -zv host.docker.internal 5432

# 测试Zipkin健康端点
curl http://host.docker.internal:9411/health

2. 检查宿主机防火墙是否拦截端口：

# Ubuntu/Debian
sudo ufw status

# CentOS/RHEL
sudo firewall-cmd --list-ports

若端口被拦截，添加放行规则：

# Ubuntu/Debian
sudo ufw allow 5432/tcp
sudo ufw allow 9411/tcp

# CentOS/RHEL
sudo firewall-cmd --add-port=5432/tcp --permanent
sudo firewall-cmd --add-port=9411/tcp --permanent
sudo firewall-cmd --reload

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