Nacos 快速开始

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

0. 版本选择

本页说明 Nacos 3.3 的接入方式。请从版本下载页面选择实际已发布的目标版本，并阅读对应 release notes。验证 RC 时请使用对应的 RC 制品；生产环境选择稳定版本。

1. 预备环境准备

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

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

2. 下载并启动Nacos服务

2.1. 使用 nacos-setup 一键部署（推荐）

nacos-setup 提供一键自动化部署，自动处理下载、鉴权配置、端口检测和 Java 环境验证等操作。

安装 nacos-setup：

启动 Nacos 服务：

验证指定版本时，先将环境变量 NACOS_VERSION 设置为实际已发布的目标版本号。

# 本地一键部署一个最新版本的单机 Nacos
nacos-setup

# 本地一键部署指定版本的单机 Nacos
nacos-setup -v "${NACOS_VERSION}"

# 本地一键部署一个最新版本的集群 Nacos
nacos-setup -c cluster

# 全局配置使用外置存储，输入数据库地址端口账号密码，配置完成后重新运行 nacos-setup
nacos-setup --datasource-conf

更多用法请参考 使用 nacos-setup 一键部署。

2.2. 手动下载发行包部署

2.2.1. 下载安装包

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

2.2.2. 解压缩Nacos 发行包

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

2.2.3. 启动服务器

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

Nacos 3.3 默认开启 Client、Admin 和 Console 鉴权。启动脚本会在以下三项配置缺失时提示输入：token 签名密钥（有效 Base64，解码后不少于 32 字节）及节点间身份 key/value。这些服务端配置不是后续登录使用的用户名和密码。提示示例如下：

`nacos.plugin.auth.nacos.token.secret.key` is missing, please set with Base64 string: ${your_input_token_secret_key}
nacos.plugin.auth.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_value}
`nacos.core.auth.server.identity.value` Updated:
----------------------------------

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

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

Nacos started successfully in stand alone mode. use embedded storage

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

3.1. Nacos控制台页面

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

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

3.1.1. 获取访问 token

以下命令使用 Bash（Windows 可使用 Git Bash 或 WSL）。将密码替换为刚初始化的管理员密码，登录后将响应中的 accessToken 复制到 NACOS_ACCESS_TOKEN：

export NACOS_USERNAME='nacos'
export NACOS_PASSWORD='<your-initialized-password>'
curl -sS -X POST 'http://127.0.0.1:8848/nacos/v3/auth/user/login' \
  --data-urlencode "username=${NACOS_USERNAME}" \
  --data-urlencode "password=${NACOS_PASSWORD}"

export NACOS_ACCESS_TOKEN='<accessToken-from-login-response>'

下面的 Client API 和 Admin API 都需要该 token。token 过期后重新登录获取；应用接入时请使用具有所需权限的业务账号，参见配置访问凭据。

3.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' \
  -H "accessToken: ${NACOS_ACCESS_TOKEN}"

3.3. 服务发现

curl -X GET 'http://127.0.0.1:8848/nacos/v3/client/ns/instance/list?serviceName=quickstart.test.service' \
  -H "accessToken: ${NACOS_ACCESS_TOKEN}"

3.4. 发布配置

curl -X POST 'http://127.0.0.1:8848/nacos/v3/admin/cs/config?dataId=quickstart.test.config&groupName=test&content=HelloWorld' \
  -H "accessToken: ${NACOS_ACCESS_TOKEN}"

3.5. 获取配置

curl -X GET 'http://127.0.0.1:8848/nacos/v3/client/cs/config?dataId=quickstart.test.config&groupName=test' \
  -H "accessToken: ${NACOS_ACCESS_TOKEN}"

若返回鉴权失败，先检查用户名、密码、token 有效期及账号权限。仅在已有无凭据客户端的临时迁移场景中考虑显式关闭 Client 鉴权，处理方式见升级手册。

4.关闭服务器

4.1. Linux/Unix/Mac

sh shutdown.sh

4.2. Windows

shutdown.cmd

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

相关项目

• Nacos
• nacos-setup