Nacos 3 控制台独立了,鉴权要不要补
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,两处都应该访问不到。