在 docker swarm 中跨机服务访问报 connection refused,通常是因为目标服务的端口未正确暴露、网络策略拦截了流量,或者服务实例尚未就绪。排查时,应优先检查服务是否绑定了所有接口(0.0.0.0),确认 swarm overlay 网络状态,并验证目标节点上的防火墙或安全组规则。

如何确认服务监听地址是否正确
如果服务只监听了 localhost (127.0.0.1),其他容器无法通过 Swarm 网络访问它。必须确保应用配置为监听 0.0.0.0 或特定网卡 IP。
docker service create \ --name web-app \ --network my-overlay \ -p 80:80 \ nginx
上述命令中,-p 80:80 默认会将宿主机的 80 端口映射到容器的 80 端口,且 Nginx 镜像默认监听 0.0.0.0。若自定义应用,需检查代码中的 bind address。
如何验证 Swarm 网络连通性
Swarm 使用 Overlay 网络实现跨主机通信。如果网络配置错误或节点间路由不通,会导致连接拒绝。可以使用 docker network inspect 查看网络状态和成员。
「在我电脑上明明能跑」——因为少了Docker。帮你写Dockerfile、构建镜像、配置多环境、编排docker-compose,从本地开发到服务器部署一条龙。支持Node.js/Python/Go/Java/前端全栈,覆盖CI/CD集成、安全加固、监控告警,告别环境不一致的噩梦。 触发词:Docker部署、容...
docker network inspect my-overlay
检查输出中的 Containers 字段,确认相关服务容器已加入该网络。同时,确保所有 Swarm 节点间的 TCP 端口(如 7946, 4789)是开放的。
当服务处于 Pending 状态时如何处理
如果服务因资源不足或约束条件不满足而处于 Pending 状态,它将无法接收流量,导致 Connection Refused。使用 docker service ps 查看具体原因。
docker service ps web-app
观察输出中的 CURRENT STATE 列。如果是 Pending,查看 ERROR 列获取详细信息,如 No available nodes 或 constraint 失败。解决后,服务将进入 Running 状态,此时再尝试访问即可成功。

















