Skip to main content

Nacos 部署与使用指南

Nacos 部署与使用指南

Nacos 是阿里巴巴开源的服务发现和配置管理平台，支持服务注册、配置管理、服务健康监测等功能。以下是 Nacos 的完整部署与使用手册。

一、Nacos 部署方案

1. 单机模式（开发环境）

1.1 下载与启动

# 下载最新稳定版
wget https://github.com/alibaba/nacos/releases/download/2.2.3/nacos-server-2.2.3.tar.gz
tar -zxvf nacos-server-2.2.3.tar.gz
cd nacos/bin

# 启动（Linux/Mac）
sh startup.sh -m standalone

# Windows
startup.cmd -m standalone

访问 http://localhost:8848/nacos (默认账号 nacos/nacos)

1.2 Docker 方式

docker run --name nacos-standalone -e MODE=standalone -p 8848:8848 -d nacos/nacos-server:v2.2.3

2. 集群模式（生产环境）

2.1 准备3台服务器

# 每台服务器修改配置文件 conf/cluster.conf
192.168.1.101:8848
192.168.1.102:8848
192.168.1.103:8848

2.2 配置数据库（MySQL）

# 创建数据库
CREATE DATABASE nacos_config CHARACTER SET utf8mb4;

# 初始化表结构
USE nacos_config;
SOURCE conf/nacos-mysql.sql

2.3 修改配置文件

# conf/application.properties
spring.datasource.platform=mysql
db.num=1
db.url.0=jdbc:mysql://127.0.0.1:3306/nacos_config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true
db.user=root
db.password=yourpassword

2.4 启动集群

# 每台服务器执行
sh startup.sh

二、核心功能使用

1. 服务注册与发现

1.1 Spring Cloud 集成

<!-- pom.xml -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>2022.0.0.0</version>
</dependency>

# application.yml
spring:
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848

1.2 手动注册服务

curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=example-service&ip=192.168.1.100&port=8080'

2. 配置管理

2.1 创建配置

  1. 登录控制台 → 配置管理 → 配置列表
  2. 新建配置：
    • Data ID: example.properties
    • Group: DEFAULT_GROUP
    • 配置格式: Properties
    • 内容: 
      server.port=8080
spring.datasource.url=jdbc:mysql://localhost:3306/test

2.2 Spring Boot 获取配置

@RefreshScope
@RestController
public class ConfigController {
    
    @Value("${server.port}")
    private String port;
    
    @GetMapping("/config")
    public String getConfig() {
        return port;
    }
}

3. 命名空间与分组

3.1 创建命名空间

  1. 控制台 → 命名空间 → 新建
  2. 填写命名空间ID和名称

3.2 使用命名空间

spring:
  cloud:
    nacos:
      config:
        namespace: your-namespace-id
        group: YOUR_GROUP

三、生产环境最佳实践

  1. 高可用架构：

    • 至少3节点集群
    • 使用独立MySQL集群

  2. 安全配置：

    # conf/application.properties
nacos.core.auth.enabled=true
nacos.core.auth.system.type=nacos
nacos.core.auth.server.identity.key=yourkey
nacos.core.auth.server.identity.value=yourvalue

  3. 监控告警：

    • 集成Prometheus
    • 配置健康检查告警规则

  4. 备份策略：

    • 定期备份MySQL数据
    • 导出重要配置

四、常见问题排查

  1. 服务注册失败：

    # 检查Nacos服务状态
curl http://127.0.0.1:8848/nacos/v1/ns/service/list

# 查看日志
tail -f logs/nacos.log

  2. 配置不生效：

    • 检查namespace和group是否匹配
    • 确认配置已发布
    • 检查客户端是否有@RefreshScope注解

  3. 性能优化：

    # 调整JVM参数
JAVA_OPT="${JAVA_OPT} -Xms2g -Xmx2g -Xmn1g"

五、版本升级

# 1. 备份数据和配置
# 2. 停止旧版本
sh shutdown.sh
# 3. 替换新版本
# 4. 启动新版本
sh startup.sh

通过本指南，您可以快速部署Nacos服务并应用于生产环境。Nacos作为微服务架构的核心组件，能够有效管理服务发现和配置中心，提高系统可靠性和可维护性。

No Comments
Back to top