在 docker swarm 中，如果集群节点被误删（例如执行了 docker swarm leave --force 或节点彻底离线），恢复集群状态的核心做法是：使用 docker node update --availability active 将节点重新激活，并让 swarm 调度器自动将任务迁移回该节点。swarm 的分布式状态由 raft 协议维护，只要管理节点（manager）未丢失且数据卷（volume）和配置（config）未被删除，节点本身的状态是可以无损恢复的。
如何确认节点是否真的从集群中移除
要判断节点是被“离开”还是被“强制移除”，需要检查节点的可用性状态。如果节点只是离开了集群但 ID 还在列表中，它处于 Down 状态；如果被强制移除，它可能完全消失。通过 docker node ls 可以查看当前所有已知节点及其状态。
docker node ls ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS ENGINE VERSION u7q... worker-1 Down Active 24.0.7 k8r... manager-1 Up Leader Leader 24.0.7
在上述输出中，worker-1 显示为 Down 但 AVAILABILITY 仍为 Active，这意味着它仍在集群注册表中，只是不可用。此时只需将其重新激活即可恢复。如果节点已经不在列表中，则需要重新加入集群。
如何将已知的离线节点重新激活并恢复服务
对于仍在列表中的 Down 节点，最直接的恢复方法是更新其可用性。Swarm 会自动检测节点重新上线，并将之前分配给该节点的任务（Tasks）重新调度回来。这个过程是无损的，因为容器镜像、网络配置和数据卷都保留在节点本地或共享存储中。
# 假设节点 ID 为 u7q... docker node update --availability active u7q... # 观察任务迁移情况 docker service ps <service_name>
执行 docker node update --availability active 后，Swarm 调度器会立即开始工作。它会检查哪些任务应该运行在该节点上，并尝试启动它们。如果节点上的容器镜像存在，启动速度会很快。如果镜像不存在，Swarm 会从仓库拉取。数据卷（Volumes）通常挂载在宿主机上，因此数据不会丢失。网络（Networks）如果是 Overlay 类型，会在节点重新加入时自动重建连接。
如果节点完全消失且无法重新加入怎么办
如果节点不仅离线，而且其记录也从 docker node ls 中消失（例如执行了 docker swarm leave --force 且其他节点已同步），或者节点硬件损坏导致无法重新安装 Docker，那么“无损恢复”的定义就变成了“恢复服务状态而非节点本身”。在这种情况下，你需要在其他健康节点上重新部署服务，并确保数据持久化。
首先，确认你的服务使用了持久化存储。如果使用 local 驱动的数据卷，数据存储在节点本地，节点丢失意味着数据永久丢失。如果使用 nfs、ceph 或云厂商提供的块存储，数据是安全的。其次，重新创建服务或使用现有服务定义进行部署。Swarm 会根据当前的副本数要求，在其他可用节点上启动新的容器实例。
# 查看服务定义
docker service inspect --format='{{json .Spec}}' <service_name>
# 如果需要重新部署，确保副本数正确
docker service scale <service_name>=3
在这个过程中，虽然原节点上的进程消失了，但服务整体可用性可以通过增加其他节点的负载来维持。关键在于事前规划：使用外部存储后端和健康的副本策略，才能在节点故障时实现真正的业务无损。
