Nacos 安装与启动

Nacos 服务端是一个独立可运行的 Java 程序，解压发行包即可启动。本章以 2.x 为例演示单机安装、启动与验证，集群部署见第 12 章。

下载与解压

从 GitHub Releases 或官网下载 nacos-server 发行包（tar.gz 或 zip），解压到安装目录：

cd /opt
wget https://github.com/alibaba/nacos/releases/download/v2.3.2/nacos-server-2.3.2.tar.gz
tar -zxvf nacos-server-2.3.2.tar.gz
cd nacos
ls
# 输出：bin  conf  target  （logs 目录启动后生成）

单机模式启动

Linux/macOS 用 startup.sh，加 -m standalone 表示单机模式（不配 -m 默认按集群模式启动，会因缺节点而失败）：

cd /opt/nacos/bin
sh startup.sh -m standalone
# 输出：nacos is starting with standalone

Windows 使用同目录下的启动脚本：

startup.cmd -m standalone

启动约需十几秒，观察启动日志确认成功：

tail -f /opt/nacos/logs/start.out
# 输出：Nacos started successfully in stand alone mode. use embedded storage

访问控制台

浏览器打开 http://localhost:8848/nacos，出现登录页即启动成功；默认账号密码都是 nacos，登录后请尽快修改（见第 15 章）。

# 命令行验证端口在监听
curl -s http://127.0.0.1:8848/nacos/v1/ns/operator/metrics
# 输出：{"status":"UP","serviceCount":0,"instanceCount":0,...}

端口说明

2.x 除了 8848 还会占用 gRPC 端口，规划防火墙时都要放行：

端口	用途
8848	主端口：HTTP、控制台、OpenAPI
9848	8848+1000，2.x 客户端 gRPC 通信端口

若 9848 被占用，Nacos 2.x 会启动失败或客户端连不上，务必保持 8848/9848 同时可用。

Docker 方式运行

已有 Docker 环境时，用官方镜像一条命令跑单机版（同样映射两个端口）：

docker run -d --name nacos -p 8848:8848 -p 9848:9848 \
  -e MODE=standalone nacos/nacos-server:v2.3.2
# 输出：一串容器 ID
docker logs -f nacos
# 输出：Nacos started successfully in stand alone mode

关闭与日志位置

单机学习环境直接停进程即可，正式关闭走脚本：

sh /opt/nacos/bin/shutdown.sh
# 输出：nacos is stopping...

日志默认输出在安装目录 logs/ 下：start.out（启动日志）、nacos.log（主日志）、naming-server.log、config-server.log（分模块日志），排错时优先看这几个文件。

小结

单机安装就四步：下载解压 nacos-server → bin 下用 -m standalone 启动 → 浏览器访问 8848/nacos → 记得放行 8848 与 9848 端口。跑通后就可以进入控制台与注册、配置功能的学习。