Nacos 快速开始

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

环境需求

Nacos Native 是 Nacos 源码基于 GraalVM 打包而成，其运行不再依赖系统中单独的 JDK 程序。Nacos Native 目前提供了 Linux(GNU)、MacOS 三类操作系统所对应的可执行程序，当前 Nacos Native 对应的 Java Nacos 版本为 2.4.0，可执行程序可以在对应的 release 页面下进行下载。推荐使用完备（包含完备的 libstdc++ 库）的 64bit 的操作系统来运行 Nacos Native。

下载安装包

在对应页面下载得到程序包后进行解压，解压后检视文件是否完备：

1. 在 Linux 操作系统中应当包含 nacos-server 二进制程序、libinstrument.so 链接文件与相关其他配置。
2. 在 MacOS 操作系统中应当包含 nacos-server 二进制程序与相关其他配置。

对于其他操作系统未发布的 Nacos Native 版本，您可以选择在该操作系统上手动进行源码编译得到 Nacos Native 二进制程序包。

启动服务器

Nacos Native 的运行建议至少在 1C2G 60G 的机器配置下运行。对于 Linux/Unix/Mac 操作系统，启动命令为：

# standalone 代表着单机模式运行，非集群模式
sh startup.sh -m standalone

若要启动 Nacos Native 集群，则需要在相应的 conf 文件夹位置下包含对应的 cluster.conf 文件，该步骤与 Java Nacos 保持一致，在启动 Nacos Native 集群后会自动扫描并获取集群 IP。

关闭服务器

对于 Linux/Unix/Mac 操作系统，关闭命令为：

sh shutdown.sh

日志检视

以 Linux/Unix 操作系统为例，Nacos Native 的运行日志会被记录在 /root/nacos/logs 目录中，其日志结构与 Java Nacos 保持一致。

构建原生Nacos

Nacos Native 提供了不同操作系统对应的构建配置，通过 Maven 可以快速构建对应操作系统下的原生 Nacos 程序。参考构建指令进行构建：

# 在 win x64 环境下构建 Native Nacos
mvn clean install -DskipTests=true -Pnative -Pnative-win64
# 在 macos x86_64 环境下构建 Native Nacos
mvn clean install -DskipTests=true -Pnative -Pnative-osx-x86_64
# 在 linux x64 环境下构建 Native Nacos
mvn clean install -DskipTests=true -Pnative -Pnative-linux64

其中 -Pnative 配置为基本 native 构建配置，-Pnative-<os type> 为操作系统类型，改配置主要引导 rocksdb 库能够正确地被 Nacos Native 打包。值得注意的是，虽然 Nacos Native 提供了 musl 类型的打包配置，但 GraalVM 本身仍然需要在支持 GNU 的操作系统下进行编译，因此与 musl 相关的编译不推荐使用。

编译成功后，相关文件会发布在 /console/target 目录下，根据“下载安装包”中对应的文件完备性检视引导取用编译文件即可。

相关项目

• Nacos