Docker容器内Go应用访问本地PostgreSQL失败问题求助

问题根源 #

容器内的127.0.0.1指向容器自身的网络命名空间，而非宿主机器，因此无法通过该地址访问宿主上运行的PostgreSQL。

解决方案 #

1. 替换连接串中的宿主地址

• Docker Desktop（Windows/macOS）：使用Docker提供的特殊域名host.docker.internal替代127.0.0.1，示例连接串：

  host=host.docker.internal:5432 user=你的用户名 database=你的数据库名
  

• Linux原生Docker：
  • 方式一：直接使用宿主机器的局域网IP（如192.168.1.100）作为host
  • 方式二：启动容器时添加--network host参数，让容器共享宿主网络栈，此时容器内的127.0.0.1将指向宿主，但该方式会消除容器的网络隔离，按需使用

2. 配置PostgreSQL允许远程连接

宿主上的PostgreSQL默认仅允许本地连接，需修改以下配置：

• 编辑postgresql.conf，设置listen_addresses = '*'，允许监听所有IP地址
• 编辑pg_hba.conf，添加规则允许容器所在网段的连接，例如Docker默认网桥网段为172.17.0.0/16，添加：

  host all all 172.17.0.0/16 md5
  

• 重启PostgreSQL服务使配置生效

3. 启动容器时传递正确的连接参数

运行容器时，通过命令行参数或环境变量覆盖默认连接串：

• 命令行参数方式：

  docker run image_name --postgresdb-addr="host=host.docker.internal:5432 user=你的用户名 database=你的数据库名"
  

• 环境变量方式（若应用支持从环境变量读取配置）：

  docker run -e POSTGRESDB_ADDR="host=host.docker.internal:5432 user=你的用户名 database=你的数据库名" image_name
  

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