Nacos

Nacos 快速开始

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

Nacos - 图1 注意

  • 快速开始旨在帮助您快速上手安装、部署及入门使用Nacos，本快速开始所生产出的Nacos服务为单机模式 及未开启客户端访问鉴权 ，建议仅在测试中使用，若在实际生产环境中部署，请部署集群模式 并开启鉴权 ，以避免存在稳定性和安全性 的风险。
  • Nacos定义为一个IDC内部应用组件，并非面向公网环境的产品，建议在内部隔离网络环境中部署，强烈不建议 部署在公共网络环境。

0. 版本选择

您可以通过Nacos的版本下载页面、release notes 及 发布声明中找到每个版本支持的功能的介绍，生产环境当前推荐的稳定版本为3.0.3.

1. 预备环境准备

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

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

2. 下载安装包

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

  • 官网
  • Github

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

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

进入Nacos Github 的 最新稳定版本 ，选择需要下载的Nacos版本，在Assets中点击下载 nacos-server-$version.zip 包。

3. 解压缩Nacos 发行包

Terminal window

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

4.启动服务器

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

  • Linux/Unix/Mac

  • Windows

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

sh startup.sh -m standalone

如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行：bash startup.sh -m standalone

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

startup.cmd -m standalone

随后启动程序会提示您输入3个鉴权相关配置（Nacos从3.0.0版本开始默认启用控制台鉴权功能，因此如下3个鉴权相关配置必须填写）如下所示：

`nacos.core.auth.plugin.nacos.token.secret.key` is missing, please set with Base64 string: ${your_input_token_secret_key}
nacos.core.auth.plugin.nacos.token.secret.key` Updated:
----------------------------------
`nacos.core.auth.server.identity.key` is missing, please set: ${your_input_server_identity_key}
`nacos.core.auth.server.identity.key` Updated:
----------------------------------
`nacos.core.auth.server.identity.value` is missing, please set: ${your_input_server_identity_key}
`nacos.core.auth.server.identity.value` Updated:
----------------------------------

Nacos - 图2 注意

若您已经在 conf/application.properties 中设置过这3个配置，则不会提示您输入。

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

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

Nacos started successfully in stand alone mode. use embedded storage

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

5.1. Nacos控制台页面

打开任意浏览器，输入地址：http://127.0.0.1:8080/index.html, 即可进入Nacos控制台页面。

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

5.2. 服务注册

curl -X POST 'http://127.0.0.1:8848/nacos/v3/client/ns/instance?serviceName=quickstart.test.service&ip=127.0.0.1&port=8080'

5.3. 服务发现

curl -X GET 'http://127.0.0.1:8848/nacos/v3/client/ns/instance/list?serviceName=quickstart.test.service'

5.4. 发布配置

Terminal window

## 登陆获取access token
curl -X POST 'http://127.0.0.1:8848/nacos/v3/auth/user/login' -d 'username=nacos' -d 'password=${your_password}'
## 使用access token，创建配置
curl -X POST 'http://127.0.0.1:8848/nacos/v3/admin/cs/config?dataId=quickstart.test.config&groupName=test&content=HelloWorld' -H "accessToken:${your_access_token}"

Nacos - 图3 注意

访问Admin API，默认需要使用access token, access token可通过POST /nacos/v3/auth/user/login接口获得

5.5. 获取配置

curl -X GET 'http://127.0.0.1:8848/nacos/v3/client/cs/config?dataId=quickstart.test.config&groupName=test'

6.关闭服务器

6.1. Linux/Unix/Mac

sh shutdown.sh

6.2. Windows

shutdown.cmd

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

相关项目