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

部署 Nacos 3.2 开发环境

部署 Nacos 3.2 开发环境

这节课用 Docker 启动一套可重复使用的 Nacos 3.2 单机环境,并固定到 3.2 系列镜像。完成后,你将能访问控制台、通过就绪探针确认服务状态,并用持久化卷保留本地数据,为后续 MCP Server 注册与目录查询做好准备。

学习目标

  • 用 Docker 启动启用完整功能模式的 Nacos 3.2 单机节点
  • 验证镜像版本、Server 就绪状态和控制台入口
  • 确认 Derby 数据目录已挂载到持久化卷,并能处理常见启动失败

启动前确认

本地需要可用的 Docker Engine 或 Docker Desktop,并确保 8080、8848、9848 三个端口未被占用。本课使用内置 Derby,适合开发和验证,不用于生产高可用部署。

这里固定使用 nacos/nacos-server:v3.2.4,避免 latest 随时间漂移。8080 提供控制台,8848 提供 Nacos Server HTTP API,9848 用于客户端长连接;端口只绑定到 127.0.0.1,避免把开发环境直接暴露到外部网络。

启动单机容器

下面的主示例创建数据卷与日志卷,生成本地开发用的 Base64 鉴权密钥,并以 standalone、all 功能模式启动 Nacos。显式使用 FUNCTION_MODE=all 的目的,是确保 AI Registry 模块随节点加载。

bash
docker volume create nacos-ai-data
docker volume create nacos-ai-logs

export NACOS_AUTH_TOKEN="$(printf '%s' 'anystack-nacos-ai-registry-local-secret-2026' | base64 | tr -d '\n')"

docker run -d \
  --name nacos-ai-registry \
  -e MODE=standalone \
  -e FUNCTION_MODE=all \
  -e NACOS_AUTH_TOKEN="$NACOS_AUTH_TOKEN" \
  -e NACOS_AUTH_IDENTITY_KEY=nacos-ai-local-key \
  -e NACOS_AUTH_IDENTITY_VALUE=nacos-ai-local-value \
  -p 127.0.0.1:8080:8080 \
  -p 127.0.0.1:8848:8848 \
  -p 127.0.0.1:9848:9848 \
  -v nacos-ai-data:/home/nacos/data \
  -v nacos-ai-logs:/home/nacos/logs \
  nacos/nacos-server:v3.2.4

预期输出

text
nacos-ai-data
nacos-ai-logs
<ID>

其中 <ID> 是 Docker 返回的容器 ID,实际值每次运行都不同。首次拉取镜像时会先下载镜像层,命令完成不代表 Nacos 已经就绪,因此还需要继续做健康验证。

验证版本、持久化与健康状态

等待容器启动后,依次检查镜像、数据卷挂载和就绪端点。就绪检查只取 HTTP 状态码,避免把不同补丁版本可能变化的响应体写成固定结果。

bash
docker inspect nacos-ai-registry --format '{{.Config.Image}}'
docker inspect nacos-ai-registry --format '{{range .Mounts}}{{if eq .Destination "/home/nacos/data"}}{{.Name}}{{end}}{{end}}'
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8848/nacos/v3/admin/core/state/readiness

预期输出

text
nacos/nacos-server:v3.2.4
nacos-ai-data
200

如果最后一行暂时不是 200,先等节点完成初始化再重试。数据卷检查返回 nacos-ai-data,说明 Derby 数据目录 /home/nacos/data 不依赖容器可写层;后续即使重建同名容器,只要继续挂载该卷,本地实验数据就可以保留。

检查控制台与 AI Registry

浏览器打开 http://127.0.0.1:8080/。首次进入时如果页面要求初始化管理员密码,按提示完成设置;管理员密码与前面配置的 NACOS_AUTH_TOKEN 不是同一个概念;后者是鉴权机制使用的 token 签名密钥。

进入控制台后,应能看到 AI Registry 相关管理入口,例如 MCP、Prompt、Skill 等资源。如果基础配置管理和服务发现可见,但 AI 相关入口缺失,优先检查容器是否以完整功能模式启动,以及 AI 模块是否被显式关闭。

处理典型启动失败

端口冲突通常表现为容器创建失败并提示端口已被占用。先释放宿主机上的 8080、8848 或 9848,再重新创建容器,不要随意改动一个端口后忘记同步后续访问地址。

容器名冲突说明本机已经存在名为 nacos-ai-registry 的容器。确认旧容器是否仍需要;开发环境里应避免让多个实验容器共用同一个名称和同一组宿主机端口。

AI 菜单缺失时,重点确认功能模式不是仅加载微服务模块的模式,并检查是否把 AI 模块开关设成关闭。对于这门课,保留 FUNCTION_MODE=all 可以避免后续注册 MCP Server 时才发现 AI Registry 根本没有加载。

当镜像版本、数据卷和就绪探针三项都通过,并且控制台可以进入 AI Registry 区域,这套开发环境就达到了后续实验所需的最低可用状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

部署 Nacos 3.2 开发环境

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

登录哪都通