跳转到内容

Nacos 快速开始

这个快速开始手册是帮忙您快速在您的电脑上,下载、安装并使用 Nacos。

0. 版本选择

您可以通过Nacos的版本下载页面release notes发布声明中找到每个版本支持的功能的介绍,3.0.0还处于Alpha阶段,推荐在测试环境中使用,生产环境当前推荐的稳定版本为2.4.3.

注意:Nacos 3.0.0-ALPHA 版本暂不支持从旧版本升级,升级会导致旧配置无法获取和查看。

1. 预备环境准备

Nacos 依赖 Java 环境来运行,请确保是在以下版本环境中安装使用:

  1. 64 bit OS,支持 Linux/Unix/Mac/Windows,推荐选用 Linux/Unix/Mac。
  2. 64 bit JDK 1.8+;下载 & 配置

2. 下载安装包

你可以通过Nacos官网网站及Github两种方式来获取 Nacos 发行包

进入Nacos官网版本下载页面,选择 稳定版本, 然后点击二进制包下载列中的${nacos.version}.zip进行下载。

注意:有时大量用户同时进行下载时,可能会遇到下载限流失败的情况,若出现下载限流失败,请稍等后重试,或采用从 Github 下载方式

3. 解压缩Nacos 发行包

Terminal window
unzip nacos-server-$version.zip
# 或者 tar -xvf nacos-server-$version.tar.gz
cd nacos/bin

4. 修改鉴权配置

启动之前需要修改鉴权相关的配置,否则无法顺利启动或Nacos控制台将无法使用,在conf目录下,修改application.properties文件

### 用于生成JWT令牌的密钥(Base64 String):
### 推荐设置为Base64编码的字符串,且原始密钥长度不得低于32字符
nacos.core.auth.default.token.secret.key=$custom_base64_token_secret_key
### 配置自定义身份识别的key(不可为空)和value(不可为空)
nacos.core.auth.server.identity.key=$custom_server_identity_key
nacos.core.auth.server.identity.value=$custom_server_identity_value

5.启动服务器

  • 注:Nacos的运行建议至少在2C4G 60G的机器配置下运行。

启动命令(standalone代表着单机模式运行,非集群模式):

sh startup.sh -m standalone

如果您使用的是ubuntu系统,或者运行脚本报错提示[[符号找不到,可尝试如下运行:

6.验证Nacos服务是否启动成功

进入${nacos.home}/logs/ 目录下, 使用tail -f start.out 查看日志,如果看到如下日志,说明服务启动成功。

Nacos started successfully in stand alone mode. use embedded storage

可以通过下列服务,快速检验Nacos的功能。

6.1. 服务注册

curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'

6.2. 服务发现

curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=nacos.naming.serviceName'

6.3. 发布配置

curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=HelloWorld"

6.4. 获取配置

curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"

6.5. Nacos控制台页面

打开任意浏览器,输入地址:http://127.0.0.1:8848/nacos,即可进入Nacos控制台页面。

注意:首次打开会要求初始化管理员用户nacos的密码。

7.关闭服务器

7.1. Linux/Unix/Mac

sh shutdown.sh

7.2. Windows

shutdown.cmd

或者双击shutdown.cmd运行文件。

相关项目