树莓派集群中Docker Swarm加入失败求助：RPC连接不可用

这种grpc连接不可用的问题在树莓派Swarm部署场景里挺常见的，我帮你梳理几个最可能的故障点和对应的解决步骤：

1. 优先排查网络连通性 #

这是最常见的原因，先确认worker节点能正常访问manager节点的Swarm端口：

• 在你的worker树莓派上执行测试命令：

  nc -zv 192.168.1.2 2377
  

  如果返回“Connection refused”或者超时，说明网络不通：
  • 检查manager节点的防火墙：Raspbian默认用ufw的话，需要开放2377端口：sudo ufw allow 2377/tcp，开放后重启ufw：sudo ufw reload
  • 确认两台树莓派在同一个局域网段，没有被VLAN或者路由器隔离，尝试ping 192.168.1.2看是否能通
  • 检查manager节点的Docker Swarm是否正常运行：在manager上执行docker swarm info，确保输出里显示Active Managers状态正常

2. 检查Docker版本兼容性 #

虽然你说都是全新安装，但树莓派的Raspbian仓库里的Docker版本可能存在差异，Swarm对版本一致性要求较高：

• 在两个节点上分别执行docker --version，确保主版本号一致（比如都是24.x.x系列）
• 如果版本不同，统一升级到最新稳定版：

  sudo apt update
  sudo apt upgrade docker-ce docker-ce-cli containerd.io
  

  升级完成后重启Docker服务：sudo systemctl restart docker

3. 确认Swarm Join Token有效性 #

有可能你使用的token已经过期或者对应错误的节点角色：

• 在manager节点上重新生成worker节点的join token：

  docker swarm join-token worker
  

  复制输出里的完整docker swarm join命令，在worker节点上重新执行

4. 检查Docker守护进程配置 #

有时候Docker daemon的配置会影响Swarm的连接：

• 查看worker节点的Docker配置文件/etc/docker/daemon.json，如果文件中有自定义配置，确保没有禁用grpc或者Swarm相关的选项
• 如果配置文件没问题，尝试重启Docker守护进程：sudo systemctl restart docker，然后再执行join命令

5. 升级树莓派系统内核 #

树莓派的ARM架构内核版本过低可能导致Swarm的grpc连接异常：

• 执行系统全量升级：

  sudo apt update && sudo apt full-upgrade
  

  升级完成后重启树莓派，再尝试加入Swarm集群

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