无法从本地连接PostgreSQL Docker容器，端口转发疑似失效

• 确认容器运行状态

  • 执行docker ps，检查目标postgres容器的STATUS为Up，PORTS列显示0.0.0.0:5432->5432/tcp, :::5432->5432/tcp（确保IPv4/IPv6端口转发都生效）
  • 若容器未运行，执行docker logs <容器ID/名称>查看启动日志，排查初始化失败原因（如挂载目录权限错误）

• 验证容器内部服务可用性

  • 进入容器：docker exec -it <容器ID/名称> bash
  • 容器内直接连接数据库：psql -U root -d ny_taxi，若连接失败，说明容器内PostgreSQL服务本身异常，与端口转发无关
  • 容器内检查监听状态：执行netstat -tulpn（需先安装apt update && apt install net-tools），确认PostgreSQL监听0.0.0.0:5432和:::5432，而非仅本地回环127.0.0.1

• 排查端口转发与本地网络问题

  • 本地检查端口监听：ss -tulpn | grep 5432，确认docker-pr监听0.0.0.0:5432和:::5432
  • 尝试用容器IP连接：通过docker inspect <容器ID/名称> | grep "IPAddress"获取容器IP，执行psql -h <容器IP> -U root -d ny_taxi，若能连接则说明localhost端口转发异常，可重置Docker iptables规则：
    1. 停止Docker：sudo systemctl stop docker
    2. 清理iptables：sudo iptables -F && sudo iptables -t nat -F && sudo iptables -t mangle -F && sudo iptables -X
    3. 重启Docker：sudo systemctl start docker，再重启postgres容器

• 检查挂载目录权限

  • 本地执行ls -ld /my/absolute/path/to/my/local/folder/ny_taxi_postgres_data，确认目录所有者UID为999（容器内postgres用户的UID）
  • 若权限不符，执行sudo chown -R 999:999 /my/absolute/path/to/my/local/folder/ny_taxi_postgres_data，随后重启容器

• 额外排查项

  • 改用后台模式启动容器：去掉-it参数，使用docker run -d ...避免终端退出导致容器停止
  • 检查Ubuntu防火墙：执行sudo ufw status，若5432端口被禁止，执行sudo ufw allow 5432/tcp

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