服务注册与分布式协调 / 系统课时
检查控制台与服务健康状态
检查控制台与服务健康状态
容器显示 Up 只能证明进程仍在运行,不能证明控制台可登录、服务端可读或端口链路正常。本课用控制台登录、容器配置检查和四个公开健康接口逐层验证本地 Nacos,最终把“进程活着”和“服务可用”区分开。
学习目标
- 正确访问 Nacos 3.x 控制台并完成首次管理员初始化或登录。
- 分别检查控制台与 Nacos Server 的 liveness、readiness。
- 根据失败发生在
8080、8848还是容器层,快速缩小故障范围。
先确认容器参数没有跑偏
先确认名为 nacos-local 的目标容器仍在运行,并核对单机模式与鉴权开关。这里直接读取容器配置,不依赖控制台,因此适合在页面打不开时做第一层排查。
set -euo pipefail
docker ps --filter name=nacos-local --format '{{.Names}}|{{.Status}}|{{.Ports}}'
docker inspect nacos-local \
--format '{{range .Config.Env}}{{println .}}{{end}}' \
| grep -E '^(MODE|NACOS_AUTH_ENABLE)='预期输出
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
MODE=standalone
NACOS_AUTH_ENABLE=true<TIME> 和端口展示顺序可能不同。如果容器不是 Up,应先回到启动日志处理容器退出问题,而不是继续检查浏览器。
登录控制台确认管理面可用
浏览器访问 http://127.0.0.1:8080/。启用鉴权且数据目录中还没有管理员时,首次进入会要求初始化管理员用户 nacos 的密码;设置一个仅用于本地实验的强密码并保存。若挂载的数据目录已经初始化过,页面会直接进入登录流程,此时使用之前设置的密码,不要假设存在默认密码。
登录后能正常进入控制台,只能证明控制台请求链路和认证流程基本可用。Nacos 3.x 的控制台端口是 8080,服务端主端口是 8848,因此还需要单独检查服务端健康接口。

用健康接口验证可用性
下面一次检查四个端点。liveness 回答“进程是否能响应”,readiness 更进一步回答“当前是否已准备好提供读取能力”。两类接口都成功,才说明控制台与服务端处于可用状态。
set -euo pipefail
for url in \
'http://127.0.0.1:8848/nacos/v3/admin/core/state/liveness' \
'http://127.0.0.1:8848/nacos/v3/admin/core/state/readiness' \
'http://127.0.0.1:8080/v3/console/health/liveness' \
'http://127.0.0.1:8080/v3/console/health/readiness'
do
printf '%s -> ' "$url"
curl -fsS "$url"
printf '\n'
done预期输出
http://127.0.0.1:8848/nacos/v3/admin/core/state/liveness -> {"code":0,"message":"success","data":"ok"}
http://127.0.0.1:8848/nacos/v3/admin/core/state/readiness -> {"code":0,"message":"success","data":"ok"}
http://127.0.0.1:8080/v3/console/health/liveness -> {"code":0,"message":"success","data":"ok"}
http://127.0.0.1:8080/v3/console/health/readiness -> {"code":0,"message":"success","data":"ok"}四行都返回 data 为 ok 时,可以认为本地控制台与 Nacos Server 的基础健康状态正常。若刚启动容器就执行检查,readiness 可能在短时间内尚未就绪,应结合日志判断是正常初始化还是持续失败。
根据失败位置缩小范围
如果 docker ps 看不到运行中的容器,问题在进程或启动参数层;如果 8848 健康接口正常但 8080 失败,优先检查控制台端口映射和控制台自身状态;如果 liveness 正常而 readiness 长时间不为 ok,说明进程仍活着,但内部模块尚未达到可读状态,应继续查看启动日志而不是只重启浏览器。
如果四个健康接口都正常,但浏览器仍打不开页面,重点检查浏览器代理、宿主机防火墙或访问地址是否写错。若页面可打开却无法登录,则确认当前挂载的 data 是否来自旧环境,因为管理员初始化状态会随持久化数据保留。
当容器为 Up、四个健康端点都返回 ok 且控制台能够登录时,本地 Nacos 的进程、网络、服务端与管理面才算完成了一次闭环验证。