采用host网络模式启动自定义PostgreSQL容器时的数据库连接异常求助

• Host网络模式不存在独立容器IP：你之前执行docker inspect看到IPAddress为空、无独立网络配置是完全正常的。Host模式的核心是容器直接共享宿主机的全部网络栈，没有独立的隔离网段、网关和专属IP，之前参考文档里提到的“替换连接地址为容器IP”的方案，仅适用于默认bridge网络下的容器，对host模式完全无效。
• 密码认证失败的核心原因：Postgres官方镜像只会在数据目录完全为空、首次启动完成数据库实例初始化时，读取启动传入的POSTGRES_PASSWORD环境变量设置超级用户密码。如果你是在自定义镜像构建阶段就把初始化好的数据目录打进镜像层，或者之前启动时根本没传密码相关的环境变量，后续启动时传再多配置也不会覆盖已有密码，自然会出现认证失败。
• 非host模式下Connection Refused的常见诱因：端口映射方向写反、宿主机原生Postgres服务抢占了5432端口、Postgres容器因初始化参数错误未正常启动、未监听外部连接请求。

• 清理无效残留：先删除之前启动失败的容器，避免旧进程占用端口
  执行命令：docker rm -f my-postgres-container
  如果之前自定义的my-postgres-image内置了旧的数据库初始化目录，需要重新构建镜像，不要把已生成的pgdata目录打包进镜像层。
• 正确启动容器：启动时必须显式传入初始化需要的环境变量，不要依赖镜像默认配置
  参考启动命令：

  docker run -d --net host \
  --name my-postgres-container \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=你自定义的登录密码 \
  -e POSTGRES_DB=test_database \
  postgres:15
  

  注意事项：
  • Host模式下不需要添加-p参数做端口映射，容器内的Postgres服务直接占用宿主机的5432端口
  • 如果宿主机本地已经安装过原生Postgres服务、占用了5432端口，需要先停掉宿主机的Postgres服务，否则容器会因为端口冲突启动失败
• 验证启动状态：查看容器日志确认初始化完成，看到database system is ready to accept connections的输出，就说明服务正常可访问了
  执行日志查看命令：docker logs my-postgres-container

• 连接地址直接填写127.0.0.1或者localhost即可，不需要查找容器IP
• 端口填写5432（未修改默认Postgres监听端口的情况下）
• 用户名、密码填写你在启动命令中通过-e参数传入的对应值
• 数据库名填写你设置的POSTGRES_DB对应的名称，默认和超级用户同名的postgres库也可正常连接

• 如果要回到默认bridge网络模式运行，端口映射格式要严格遵循「宿主机端口:容器端口」的规则，正确格式示例为-p 5432:5432，不要把两个端口顺序写反
• 只要端口映射配置正确、容器正常完成初始化，DBeaver连接时同样直接填写localhost+映射的宿主机端口即可，不需要填写容器内部IP
• 遇到Connection Refused报错时，优先排查容器启动日志是否有初始化错误、宿主机防火墙是否放行了对应端口，不要浪费时间查询容器独立IP。

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