Docker Playground中Docker Swarm网络配置显示异常求助

核心结论 #

这大概率是Docker Playground临时环境的稳定性问题，而非Docker官方Swarm网络结构的变更。

标准Swarm网络行为参考 #

正常初始化Swarm集群后：

• 管理节点会自动创建ingress（覆盖网络，负责Swarm服务的负载均衡流量）和docker_gwbridge（网关桥接网络，负责容器与外部网络通信），执行docker network ls应能看到这两个网络。
• 工作节点加入Swarm后，会同步创建ingress和docker_gwbridge网络。
• ingress_sbox是ingress网络的配套沙盒容器，默认存在于管理节点，用于处理集群流量转发。

异常原因分析（针对Docker Playground） #

Docker Playground是共享临时环境，容易出现以下导致网络异常的情况：

• 管理节点的docker_gwbridge网络内核接口已创建（所以ip a能看到），但由于资源限制或初始化时的通信故障，未被Docker daemon正确注册到网络列表，导致docker network ls无法显示。
• 工作节点加入Swarm时，集群网络同步流程失败，导致ingress网络未被创建。
• ingress_sbox缺失直接关联ingress网络初始化失败，同样和Playground环境的临时稳定性有关（比如资源不足、环境残留配置干扰）。

验证与修复步骤 #

1. 重置管理节点Swarm环境：

   docker swarm leave --force
   docker swarm init
   

   执行后再次运行docker network ls和docker inspect ingress，检查网络和ingress_sbox是否正常出现。

2. 重置工作节点：

   docker swarm leave --force
   # 复制管理节点输出的加入命令重新加入
   docker swarm join --token <your-join-token> <manager-ip>:2377
   

   加入后检查docker network ls是否显示ingress网络。

3. 查看Docker日志排查具体错误：

   # 适用于systemd管理的Docker环境
   journalctl -u docker.service | grep -E "ingress|docker_gwbridge"
   

   日志中会显示网络初始化时的具体报错（比如权限不足、资源耗尽等）。

关于Docker版本变更的排除 #

执行docker version查看当前环境的Docker版本，截至2024年，Docker官方稳定版本并未修改Swarm默认网络的创建逻辑，ingress和docker_gwbridge仍是Swarm集群的核心默认网络，不存在官方移除或变更的情况。

内容的提问来源于stack exchange，提问作者ashtrix-001