在 docker swarm 中，静态节点配置（如 --advertise-addr）一旦在初始化或加入集群时确定，就无法通过简单的重载命令直接修改。要重新加载或更改这些网络配置，必须将节点从集群中移除并重新加入，或者对 manager 节点执行完整的重新初始化流程。
Worker 节点如何更换 IP 地址并重新加入集群
对于 Worker 节点，如果其物理 IP 发生变化导致无法与 Manager 通信，需要先在旧节点上清理状态，然后在同一台机器上使用新的 IP 重新执行加入命令。这个过程不会丢失数据卷，但会短暂中断服务调度。
docker swarm leave --force docker swarm join \ --token <worker_token> \ <manager_ip>:2377 \ --advertise-addr <new_node_ip></new_node_ip></manager_ip></worker_token>
执行上述步骤后，节点将以新的 --advertise-addr 重新注册到集群中。Manager 节点会自动发现该节点的新地址并更新路由表。确保新 IP 可达且防火墙规则已更新，否则节点将保持 Down 状态。
Manager 节点更换 IP 地址的完整重置流程
Manager 节点的配置更为复杂，因为涉及 Raft 共识状态。如果 Manager 的 IP 改变，通常建议采用“滚动替换”的方式，即添加一个具有新 IP 的新 Manager 节点，然后逐步移除旧的 Manager 节点，而不是直接在原节点上修改配置。
Docker Hub (hub.docker.com)。此技能适用于所有 Docker Hub 操作，包括读取、创建、更新和删除数据。只要任务涉及 Docker Hub，就使用此技能。
# 在新 IP 的机器上初始化新的 Swarm (如果尚未初始化) docker swarm init --advertise-addr <new_manager_ip> # 获取新 Manager 的 Join Token docker swarm join-token manager # 在旧 Manager 节点上退出集群 docker swarm leave --force # 使用新 Token 将新 IP 节点加入现有集群 docker swarm join \ --token <manager_token> \ <existing_manager_ip>:2377 \ --advertise-addr <new_manager_ip></new_manager_ip></existing_manager_ip></manager_token></new_manager_ip>
通过这种方式，集群的 Raft 成员列表会更新为包含新 IP 的 Manager。当所有旧 Manager 都被替换后，集群的网络拓扑便完成了静态配置的迁移。此方法避免了直接修改运行时配置可能导致的脑裂或状态不一致问题。
为什么不能直接使用 reload 命令修改 advertise-addr
Docker Swarm 的 advertise-addr 是节点身份标识的一部分，用于其他节点建立连接。它被硬编码在节点的 Raft 状态和证书中。Docker 引擎没有提供类似 systemctl reload docker 这样的热重载机制来动态更新这些底层网络标识。任何试图通过修改配置文件而不重启或重新加入集群的行为，都会导致节点与集群其他部分失去同步，因为其他节点仍然尝试连接到旧的 IP 地址。因此，唯一的可靠方法是重新加入集群，让 Docker 引擎在启动时根据新的命令行参数生成新的证书和注册信息。
