Nacos 安装与使用配置指南
目录
简介
Nacos 是阿里巴巴开源的一个动态服务发现、配置管理和服务管理平台,支持服务注册、配置管理、动态 DNS 服务等功能,适用于微服务架构和云原生环境。
安装
环境要求
- Java 8 或更高版本
- 操作系统:Linux、macOS、Windows
- 数据库(可选):MySQL(用于持久化配置)
下载与安装
-
下载 Nacos
- 访问 Nacos 官方下载页面 下载最新版本。
- 或使用以下命令下载:
wget https://github.com/alibaba/nacos/releases/download/2.0.3/nacos-server-2.0.3.tar.gz
-
解压安装包
tar -zxvf nacos-server-2.0.3.tar.gz cd nacos
启动 Nacos
-
单机模式启动
sh bin/startup.sh -m standalone -
集群模式启动
- 修改
conf/cluster.conf文件,配置集群节点:192.168.1.1:8848 192.168.1.2:8848 192.168.1.3:8848 - 启动 Nacos:
sh bin/startup.sh
- 修改
-
访问 Nacos 控制台
- 默认地址:
http://localhost:8848/nacos - 默认用户名和密码:
nacos/nacos
- 默认地址:
配置
单机模式配置
-
配置文件路径
- 配置文件位于
conf/application.properties。
- 配置文件位于
-
配置数据库(可选)
- 修改
application.properties,启用 MySQL 存储:spring.datasource.platform=mysql db.num=1 db.url.0=jdbc:mysql://127.0.0.1:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true db.user=root db.password=your_password
- 修改
集群模式配置
-
配置集群节点
- 修改
conf/cluster.conf,添加集群节点 IP 和端口。
- 修改
-
配置数据库
- 集群模式下必须使用外部数据库(如 MySQL)存储配置。
使用
服务注册与发现
-
注册服务
- 使用 Nacos 客户端注册服务:
NamingService naming = NamingFactory.createNamingService("127.0.0.1:8848"); naming.registerInstance("your_service_name", "127.0.0.1", 8080);
- 使用 Nacos 客户端注册服务:
-
发现服务
- 使用 Nacos 客户端发现服务:
List<Instance> instances = naming.getAllInstances("your_service_name");
- 使用 Nacos 客户端发现服务:
配置管理
-
发布配置
- 在 Nacos 控制台发布配置:
- Data ID:
example-config - Group:
DEFAULT_GROUP - 配置内容:
server: port: 8080
- Data ID:
- 在 Nacos 控制台发布配置:
-
获取配置
- 使用 Nacos 客户端获取配置:
ConfigService configService = NacosFactory.createConfigService("127.0.0.1:8848"); String content = configService.getConfig("example-config", "DEFAULT_GROUP", 5000);
- 使用 Nacos 客户端获取配置:
常见问题
-
Nacos 启动失败
- 检查 Java 环境是否正确安装。
- 检查端口
8848是否被占用。
-
服务注册失败
- 检查 Nacos 服务是否正常运行。
- 检查客户端配置是否正确。
-
配置无法获取
- 检查配置的 Data ID 和 Group 是否正确。
- 检查 Nacos 控制台是否已发布配置。
参考文档
以上是 Nacos 的安装与使用配置指南,更多详细信息请参考官方文档。