服务注册与分布式协调 / 系统课时

用 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 鉴权密钥,然后启动单机容器。示例显式开启鉴权,使后续控制台登录和客户端凭据行为保持可预测。

bash
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

预期输出

text
<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 已以可重复方式运行,并具备后续功能实验所需的稳定基础。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Docker 启动本地 Nacos

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通