从单机到多机：手把手教你用Docker Swarm编排Nacos 2.x生产级集群（含Nginx负载均衡与健康检查）

当你的微服务架构从开发环境走向生产环境时，单机部署的Nacos服务显然无法满足高可用需求。本文将带你从熟悉的Docker Compose单机部署，平滑过渡到基于Docker Swarm的多机集群编排，构建一个真正具备生产级可靠性的Nacos服务发现与配置中心。

1. 为什么选择Docker Swarm编排Nacos集群？

在微服务架构中，服务发现与配置中心如同神经系统般重要。Nacos作为阿里巴巴开源的核心组件，其集群部署的稳定性直接关系到整个系统的可靠性。相比传统的手动在多台机器上分别启动Nacos节点，Docker Swarm提供了更优雅的解决方案：

• 声明式部署：通过YAML文件定义整个集群的期望状态
• 自动调度：Swarm根据节点资源情况智能分配服务实例
• 滚动更新：零停机时间完成Nacos版本升级
• 故障自愈：节点故障时自动在其他健康节点重建服务
• 内置负载均衡：通过Swarm内置的DNS轮询实现服务发现

提示：虽然Kubernetes是更强大的编排工具，但对于中小团队来说，Docker Swarm的学习曲线更平缓，且完全兼容现有Docker生态，是过渡到生产环境的理想选择。

2. 搭建Docker Swarm集群环境

2.1 初始化Swarm集群

首先选择一台机器作为管理节点（manager），执行以下命令初始化Swarm：

# 在管理节点执行
docker swarm init --advertise-addr <MANAGER_IP>

命令执行后会输出加入集群的token，类似这样：

docker swarm join --token SWMTKN-1-49nj1cmql0jkz5s954yi3oex3nedyz0fb0xx14ie39trti4wxv-8vxv8rssmk743ojnwacrr2e7c 192.168.99.100:2377

2.2 加入工作节点

在其他服务器上运行上述join命令，将它们加入Swarm集群。可以通过以下命令检查节点状态：

docker node ls

理想输出应显示所有节点均为Ready状态：

ID                            HOSTNAME            STATUS              AVAILABILITY        MANAGER STATUS
d3cw2ks9f5q1z1q6q9q9q9q *     manager1            Ready               Active              Leader
kz9q9q9q9q9q9q9q9q9q9q       worker1             Ready               Active              
x1q9q9q9q9q9q9q9q9q9q9       worker2             Ready               Active

2.3 创建Overlay网络

为了让Nacos集群跨主机通信，我们需要创建一个overlay网络：

docker network create --driver overlay --attachable nacos_net

3. 部署Nacos集群Stack

3.1 准备Nacos Stack文件

创建nacos-cluster.yml文件，定义完整的Nacos服务栈：

version: '3.8'

services:
  nacos:
    image: nacos/nacos-server:v2.2.0
    deploy:
      replicas: 3
      update_config:
        parallelism: 1
        delay: 10s
      restart_policy:
        condition: on-failure
    environment:
      - MODE=cluster
      - SPRING_DATASOURCE_PLATFORM=mysql
      - MYSQL_SERVICE_HOST=mysql_host
      - MYSQL_SERVICE_DB_NAME=nacos
      - MYSQL_SERVICE_PORT=3306
      - MYSQL_SERVICE_USER=nacos
      - MYSQL_SERVICE_PASSWORD=nacos@123
      - NACOS_SERVERS=nacos.nacos_net:8848
      - PREFER_HOST_MODE=hostname
    volumes:
      - nacos_logs:/home/nacos/logs
    networks:
      - nacos_net
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8848/nacos/health"]
      interval: 30s
      timeout: 10s
      retries: 3

  nginx:
    image: nginx:1.23
    ports:
      - "8848:8848"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - nacos
    networks:
      - nacos_net

volumes:
  nacos_logs:

networks:
  nacos_net:
    external: true

3.2 关键配置解析

• replicas: 3：确保Nacos有3个实例运行，满足集群最小节点数
• healthcheck：定义健康检查，Swarm会根据此判断服务状态
• NACOS_SERVERS：使用服务名而非IP，利用Docker内置DNS
• update_config：控制滚动更新行为，避免同时重启所有实例

3.3 部署Stack

执行以下命令部署整个应用栈：

docker stack deploy -c nacos-cluster.yml nacos

查看服务状态：

docker service ls

4. 配置Nginx负载均衡

4.1 Nginx配置文件

创建nginx.conf文件，配置对Nacos集群的负载均衡：

upstream nacos_cluster {
    server nacos:8848;
}

server {
    listen 8848;
    
    location / {
        proxy_pass http://nacos_cluster;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        
        # 长连接优化
        proxy_http_version 1.1;
        proxy_set_header Connection "";
        
        # 超时设置
        proxy_connect_timeout 5s;
        proxy_read_timeout 60s;
        proxy_send_timeout 30s;
    }
    
    # 健康检查端点
    location /nacos/health {
        access_log off;
        proxy_pass http://nacos_cluster/nacos/health;
    }
}

4.2 动态解析优化

由于Swarm可能会重新调度Nacos实例，传统IP硬编码的方式不再适用。我们的配置中：

• 使用服务名nacos而非具体IP
• Swarm内置的DNS会解析到当前健康的Nacos实例
• Nginx会自动感知后端实例变化

5. 集群健康检查与高可用保障

5.1 多层级健康检查设计

检查层级	检查方式	频率	作用
容器级	Docker健康检查	30秒	重启不健康的容器
服务级	Swarm服务副本	持续	维持指定副本数
应用级	Nacos集群选举	持续	保证Leader存在
接入层	Nginx健康检查	实时	流量只路由到健康节点

5.2 模拟故障测试

验证集群的高可用性：

# 随机停止一个Nacos容器
docker container ls | grep nacos | awk '{print $1}' | xargs -I {} docker stop {}

# 观察服务自动恢复
watch -n 1 docker service ps nacos_nacos

5.3 监控建议

在生产环境中，建议添加以下监控：

• Prometheus监控：通过Nacos暴露的metrics接口收集指标
• 日志收集：将Nacos日志统一收集到ELK或类似系统
• 报警规则：
  • Nacos实例数 < 3持续5分钟
  • Leader切换频率异常
  • 配置变更失败率升高

6. 生产环境优化建议

6.1 性能调优参数

在nacos-cluster.yml的环境变量中添加：

environment:
  - NACOS_AUTH_ENABLE=true  # 开启鉴权
  - NACOS_CORE_AUTH_ENABLED=true
  - JVM_XMS=2g  # JVM初始内存
  - JVM_XMX=2g  # JVM最大内存
  - NACOS_SERVER_IP=${HOST_IP}  # 显式声明IP

6.2 数据库优化

对于MySQL后端，建议：

• 使用主从架构，配置读写分离
• 优化以下MySQL参数：

innodb_buffer_pool_size = 4G
innodb_log_file_size = 1G
sync_binlog = 1
innodb_flush_log_at_trx_commit = 1

6.3 备份策略

• 配置备份：定期导出Nacos配置到版本控制系统
• 数据库备份：设置MySQL定时全量备份+binlog
• 快照备份：对重要环境制作整个Stack的Docker镜像快照

7. 版本升级与回滚

7.1 滚动升级流程

# 更新Stack文件中的镜像版本
sed -i 's/nacos-server:v2.2.0/nacos-server:v2.2.1/g' nacos-cluster.yml

# 应用更新
docker stack deploy -c nacos-cluster.yml nacos

# 观察升级过程
watch -n 1 docker service ps nacos_nacos

7.2 回滚方案

如果新版本出现问题，快速回滚到旧版本：

# 回滚到之前的版本
docker service update --image nacos/nacos-server:v2.2.0 nacos_nacos

在实际项目中，我们遇到过Nacos版本升级后配置项不兼容的情况。通过预先在测试环境验证，并确保有完整的备份和回滚方案，最终将生产环境的影响降到了最低。