Docker部署的PostgreSQL无法远程连接，本地可连远程访问超时如何解决？

端口映射配置校验 #

• 检查docker-compose.yml的ports规则，确认未绑定本地回环地址，正确配置应为0.0.0.0:5432:5432，若写为127.0.0.1:5432:5432仅支持本地访问
• 在部署PostgreSQL的Windows服务器上执行netstat -ano | findstr "5432"，确认5432端口监听地址为0.0.0.0而非127.0.0.1
• 端口绑定错误时，修改docker-compose配置后执行docker-compose up -d --force-recreate重启容器生效

Windows主机与网络层校验 #

• 已关闭的ufw为容器内防火墙规则，需额外确认Windows服务器本身的Windows Defender防火墙、第三方安全软件是否配置了5432端口的入站允许规则
• 在内网环境下需确认上层网关/交换机未限制5432端口访问，若服务器为跨公网访问，需确认网关已配置5432端口DNAT映射到服务器内网IP
• 远程设备上执行telnet <服务器IP> 5432验证端口连通性，返回连接失败则优先排查网络层限制

容器内PostgreSQL配置校验 #

• 进入容器执行psql -U <数据库用户名> -c "show listen_addresses"，确认返回结果为*，与postgresql.conf中配置一致
• 进入容器执行cat /var/lib/postgresql/data/pg_hba.conf，确认已添加host all all 0.0.0.0/0 <加密方式>规则，无注释符号前缀

连通性快速验证 #

停止PostgreSQL容器后，在Windows服务器上执行python -m http.server 5432临时占用5432端口，远程设备访问http://<服务器IP>:5432，可正常访问则说明网络层无限制，问题出在PostgreSQL容器配置，否则优先排查网络层策略。

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