问问助手

Nacos 3 控制台独立了,鉴权要不要补

2026-09-24 Aryee 35

Nacos 3 控制台独立了,鉴权要不要补

过去流传最广的那份「打开鉴权」升级清单,前提已经变了:3.x 的鉴权默认就是开的。

更值得说的事情在另一处:一批管理接口的鉴权范围配错了,从 3.0.0 一直带到 3.2.3。

先把版本现状说清楚,再说哪些配置真的要动手。

一、先看版本现状(截至 2026 年 9 月)

按 GitHub 上的发布记录,3.0.0 正式版在 2025-04-27 发布。此后是 3.0.1、3.0.2、3.0.3、3.1.0、3.1.1、3.1.2、3.2.0、3.2.1、3.2.2、3.2.3。

最新常规发布版是 3.2.4(2026-08-27)。3.3.0 目前只到 RC(2026-09-21),还没正式发布。

2.5.4 也在 2026-08-27 发布,同一天。这说明 2.x 这条线还在收维护更新,停在 2.x 不是被迫,而是一个可以选的状态。

二、控制台独立出去,到底改了什么

官方给的理由是,从 Nacos 3.0 开始支持控制台独立部署,把高风险请求和高资源消耗的请求分开,从而提高安全性和稳定性。

这个理由站得住。控制台是低频、给人点的页面;服务端是高频、给程序调的接口。以前放在一个进程里,一个页面级的大查询能拖慢注册心跳。

分开之后,两部分可以按不同负载分别扩容,控制台还能只让办公网访问。

三、独立部署多了哪些运维动作

服务端照旧启动。控制台要单独起一个进程,把同一个发行包拷到另一台机器,再把服务端的地址写进控制台自己的配置文件。

控制台端口默认 8080,路径前缀可以改,连服务端时用的上下文路径也可以单独配。

一个容易忽略的硬条件:控制台进程要求 JDK 17+,服务端可以跑在更低版本上。这种不对称,通常升级当天才发现。

四、鉴权的默认值已经变了

Nacos 3.0 的发布说明里有一条「启用控制台鉴权」,权限文档写的是「从 3.0 起,控制台访问默认开启鉴权」。

现在的默认值:控制台鉴权开、管理员接口鉴权开、服务端鉴权开。

也就是说,「忘记打开鉴权」这个经典事故前提,在 3.x 上已经不明显成立。除非有人显式关掉,而文档明确不建议这么做。

五、默认开了不等于配好了

有几项默认是空的,空着会让服务起不来,或者控制台连不上服务端。

第一项是令牌,也就是系统之间用来证明身份的一串字符。这一项默认空,要填 Base64 字符串,解码后的原始密钥不少于 32 字符。用 openssl rand -base64 48 生成一个就行。

这里纠正一个流传很广的说法:过去说 Nacos 自带一个众所周知的默认密钥,但 3.2 的官方文档里,这一项的默认值写的是空。所以现在要查的不是「有没有改掉默认密钥」,而是「有没有真的填、长度够不够」。

另一条仍然成立:这个值不能出现在任何公开示例里。一旦被抄进教程,别人就有机会伪造令牌。

六、集群之间还有一对身份值

第二项是服务端身份键和值,默认空。集群节点之间、控制台到服务端的调用,都要用它。

三台节点上这一对值必须逐字符一致,否则控制台连不上服务端。

3.x 的启动脚本在这些关键项没配时,会交互式提示输入。这里有个新陷阱:手工在终端里启动成功的部署,不代表 systemd 或者容器(也就是把程序和环境打包在一起运行的方式)里能起来,因为非交互环境没人回答那个提示。一定要在没有终端的环境里单独验一次。

七、管理员口令不再内置

从 2.4.0 起,Nacos 没有内置默认管理员密码。首次启动要通过一个一次性初始化接口设置,接口是 POST /v3/auth/user/admin。

所以口令必须来自部署流程,不能靠某个人在浏览器里点一次。手工做那一次的结果是:没人记得密码怎么来的,换实例就得重来。

八、真正该关注的事:管理接口的权限范围

阿里云 MSE 官方安全公告(2026-08-31 更新)说:Nacos 社区公开披露了 3.X 版本部分接口鉴权范围设置错误的漏洞,并于 3.2.4 完成修复。

默认情况下应当鉴权的部分管理接口,实际没有鉴权。

可核对的要点有三条。受影响版本是 3.0.0 到 3.2.3,触发条件里包含鉴权开关没有设成 true。修复版本是 3.2.4(2026-08-27)。

机制上,社区分析指向用户和角色相关接口缺少管理员接口的权限标记。意思是认证过了,但权限边界没判,于是可以自己建管理员。

这种「权限范围配错」比「完全没鉴权」隐蔽得多,因为你的鉴权开关确实是开着的。

九、编号要说准确

流传的编号 QVD-2026-59388 是 QVD 编号,不是 CVE,也不是 GHSA。

我核过 alibaba/nacos 的已发布 GHSA 列表是空的,OSV 里也没有 nacos 条目。所以目前没有 CVE 编号,引用时不要写成 CVE。

顺带记一笔,避免混淆:CVE-2025-53506 是 Apache Tomcat Coyote 的拒绝服务问题,只是在 Nacos 2.5.1 和 3.0.1 的问题记录里被当作依赖提出来,不是 Nacos 自身的漏洞。

这类「扫出来的 CVE 其实属于依赖」的情况,占了中间件安全单里相当一部分。

十、3.2.4 不只是修一个洞

3.2.4 还加固了几处:集群通信的服务端身份认证、多条访问路径的权限判断、用户名枚举、禁止不安全的数据库连接选项,以及 MCP 导入白名单。

这一串改动指向很清楚:它是一次安全集中修订,不是普通的小修版本。

所以 3.0.0 到 3.2.3 之间的部署,应当直接排到 3.2.4。理由不是版本新,而是这一版的改动全落在对外可访问的地方。

十一、升 3.x 会撞上的配置改名

有几条不在安全公告里,但会让升级当场失败。

服务端端口的老配置名不再生效,不跟着改,端口会回到默认。访问路径的配置名也变了,改完访问路径才一致。

public 命名空间的 id 从空串变成了 public。3.2.x 起变了,配置里按空串找 public 的脚本会拿不到。

PostgreSQL 场景从 3.2.2 起会校验租户字段不能为空。存量脏数据会让服务启动失败,不是运行时报错。

第三条要特别当回事:命名空间 id 是配置的坐标的一部分。存量数据里如果是空串,升级后同一份配置就落在另一个命名空间里,表现是「配置莫名其妙丢了」,这比报错难查得多。

升级前在测试库上把配置表的租户字段分布看一遍。

十二、还有一个被当成好消息的默认行为

如果启用了单点登录,而授权地址留空,非管理员的授权默认是放行的。

「接了单点登录」和「做了授权」是两件事,这一条把这两个动作的差距暴露得很直白。

十三、AI Registry 是什么,成熟度怎么说

Nacos 3.x 的另一条主线,是把 AI 资源也纳入注册体系。

3.0.0 提供 MCP 管理,3.1.x 加深 A2A 和代理端点批量注册,3.2.0 补齐 Prompt 和 Skill 两类注册。

官方落地页现在列了五类资源:Skill、MCP、Agent、Prompt、AgentSpec,并说明「内置于 Nacos 3.2,无需额外部署」。

成熟度要说得准确:官方没有把它标成 GA,也没有放进「实验性功能」目录,那个目录里只有分布式锁和 K8s 生态。

同时 3.2.4 的说明里提到「默认关闭部分已废弃的 v3 AI API」,并留了兼容开关。

所以严谨的说法是:它已经是 3.2 的标准组成部分,但 v3 早期那批 AI 接口正在被逐步关掉。要接就按新接口接,别复用旧样例。

十四、上线前要逐项验的事

第一项,查版本。3.0.0 到 3.2.3 一律排到 3.2.4。

第二项,发一次真实的匿名请求调管理接口,应该返回 403,而不是数据。不要靠读配置文件判断鉴权是否生效,环境变量、启动参数、集群配置都能覆盖文件里的值。

第三项,查令牌密钥:非空、Base64、解码后不少于 32 字符、不出现在任何公开教程里。

第四项,逐台对比集群节点的身份键和值,必须完全一致。

第五项,用 systemd 或容器启动一次,确认不卡在交互式提示上。

第六项,重启一个实例后再登录,确认管理员还能进。

第七项,查配置表里的命名空间 id 分布,确认没有空串残留。

第八项,分别从业务网段和公网访问 8080,两处都应该访问不到。

引用这一篇
https://www.aryee.cn/archives/nacos-3-console-auth.html

转载或引用请注明出处与链接。

你手上那套系统,卡在哪一步?

留个手机号和方便的时间,我打过来先听你说现状和限制,再给一个能执行的判断:这套系统该继续修、该动哪里,还是重做一版更省。

约一次沟通不接纯 UI 外包,只做系统层面的问题。不方便留号码,也可以直接跟助手说一句话。