Docker Swarm集群中PostgreSQL端口无法暴露，如何实现局域网访问？

问题根源 #

你之前的命令同时使用了--net=host和-p参数，这两者存在冲突：

• 在Docker Swarm服务模式下，--net=host会让容器直接复用宿主机的网络命名空间，此时-p端口映射参数完全失效
• 即便使用host网络，若PostgreSQL绑定127.0.0.1（不过官方postgres镜像默认已设置listen_addresses='*'），也会导致外部无法访问

推荐配置（使用Swarm Overlay网络） #

这是Swarm集群的标准实践，能利用Swarm路由网格功能，让局域网机器通过任意集群节点的IP访问服务：

1. 先创建一个overlay类型的集群网络（如果还未创建）：

docker network create --driver overlay pg-swarm-net

2. 创建PostgreSQL服务：

docker service create --replicas 1 --name postgres \
  -e POSTGRES_PASSWORD=a \
  -p 5432:5432 \
  --network=pg-swarm-net \
  postgres

关键说明 #

• -p 5432:5432：Swarm会在所有集群节点上发布5432端口，路由网格会自动把请求转发到运行PostgreSQL服务的节点
• 官方postgres镜像默认已配置listen_addresses='*'，无需额外修改配置文件
• 局域网内的机器可以直接通过任意Swarm节点的IP:5432连接PostgreSQL

特殊场景：必须使用host网络的情况（不推荐） #

如果因特殊需求必须使用host网络，需注意以下几点：

1. 去掉-p参数，因为host网络下容器直接使用宿主机端口，无需映射
2. 限制服务只能部署在特定节点（避免多节点端口冲突）
3. 确保PostgreSQL监听0.0.0.0（官方镜像已满足）

命令示例：

docker service create --replicas 1 --name postgres \
  -e POSTGRES_PASSWORD=a \
  --net=host \
  --constraint node.hostname==your-node-name \
  postgres

此时局域网机器需要通过该宿主机的IP:5432访问服务，且该节点不能再运行其他占用5432端口的服务。

验证连接 #

• 查看服务状态：docker service ps postgres
• 测试端口连通性：在局域网其他机器上执行telnet <节点IP> 5432，或者用PostgreSQL客户端测试：psql -h <节点IP> -U postgres

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