服务注册与分布式协调 / 系统课时
用 Docker 启动本地 Nacos
用 Docker 启动本地 Nacos
本课把本地 Nacos 以可重复的 Docker 单机环境拉起来,并把数据、日志和端口都固定下来。完成后即使删除并重建容器,只要继续挂载同一数据目录,就能保留本地实验所需的持久化状态。
学习目标
- 确认 Docker 与本地端口满足 Nacos 单机启动条件。
- 使用固定镜像、环境变量和挂载目录启动 Nacos 3.2.4。
- 通过容器状态和启动日志判断 Nacos 是否真正完成启动。
启动前明确端口和目录
Nacos 3.x 将控制台与服务端主端口分开。这个本地环境只需要映射三个端口:8080 用于控制台,8848 用于 HTTP API,9848 用于客户端 gRPC。单机实验不需要把服务端内部通信端口暴露给宿主机。
持久化目录分成 data 与 logs。data 保存单机内嵌存储的数据,logs 便于容器重建后继续查看日志。它们都放在当前用户主目录下,避免把实验状态留在容器可写层。
| 宿主机端口 | 容器端口 | 用途 |
|---|---|---|
8080 |
8080 |
Nacos 控制台 |
8848 |
8848 |
HTTP/OpenAPI 与部分鉴权请求 |
9848 |
9848 |
Nacos 客户端 gRPC |
准备目录并启动容器
下面的命令会创建持久化目录、生成本地实验用的 Base64 鉴权密钥,然后启动单机容器。示例显式开启鉴权,使后续控制台登录和客户端凭据行为保持可预测。
set -euo pipefail
NACOS_HOME="$HOME/nacos-local"
mkdir -p "$NACOS_HOME/data" "$NACOS_HOME/logs"
NACOS_AUTH_TOKEN="$(
printf '%s' 'local-nacos-token-secret-key-2026-change-me-0123456789' \
| base64 \
| tr -d '\n'
)"
docker rm -f nacos-local >/dev/null 2>&1 || true
docker run -d \
--name nacos-local \
--restart unless-stopped \
-e MODE=standalone \
-e NACOS_AUTH_ENABLE=true \
-e NACOS_AUTH_TOKEN="$NACOS_AUTH_TOKEN" \
-e NACOS_AUTH_IDENTITY_KEY='local-server' \
-e NACOS_AUTH_IDENTITY_VALUE='local-server-secret' \
-p 8080:8080 \
-p 8848:8848 \
-p 9848:9848 \
-v "$NACOS_HOME/data:/home/nacos/data" \
-v "$NACOS_HOME/logs:/home/nacos/logs" \
nacos/nacos-server:v3.2.4
docker ps --filter name=nacos-local --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
docker logs --tail 30 nacos-local预期输出
<ID>
NAMES STATUS PORTS
nacos-local Up <TIME> 0.0.0.0:8080->8080/tcp, 0.0.0.0:8848->8848/tcp, 0.0.0.0:9848->9848/tcp
...
Nacos started successfully in standalone mode. use embedded storage<ID>、<TIME>、日志时间戳以及端口展示顺序会因 Docker 版本和宿主机而不同。判断成功的关键是容器保持 Up,并且启动日志包含 Nacos started successfully。
理解这套启动参数
MODE=standalone 让 Nacos 使用单机模式,适合本地开发和课程实验;它不是生产集群方案。NACOS_AUTH_TOKEN 用于鉴权令牌签名,两个 identity 参数用于服务端内部身份校验,本课的值仅限本机实验,生产环境必须换成独立且安全保存的值。
挂载 data 后,删除容器并不会自动删除已初始化的管理员信息和实验数据。因此后续重建时应继续使用同一个 $HOME/nacos-local/data;如果希望得到全新的环境,应先明确备份需求,再主动清理这个目录,而不是只执行 docker rm。
启动失败时先看哪里
容器立即退出时,先看 docker logs nacos-local,常见原因是端口已被占用、宿主机目录权限不足或鉴权参数不合法。容器持续运行但控制台打不开时,不要直接判断 Nacos 未启动,还要分别检查 8080、8848 和 9848 的映射,因为 Nacos 3.x 的控制台与服务端已经是不同端口。
完成这一步后,本地环境应具备三个明确特征:容器持续运行、日志显示启动成功、持久化目录位于宿主机。达到这些条件后,本地 Nacos 已以可重复方式运行,并具备后续功能实验所需的稳定基础。