Nacos 快速开始

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

0. 版本选择

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

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

1. 预备环境准备

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

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

2. 下载安装包

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

官网
Github

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

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

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

3. 解压缩Nacos 发行包

  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的机器配置下运行。

Linux/Unix/Mac
Windows

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

sh startup.sh -m standalone

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

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

startup.cmd -m standalone

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运行文件。