导语:Wiki.js XSS 漏洞(CVE-2026-120697)是 2026 年 Node.js 生态中最值得警惕的存储型脚本注入案例之一——一个仅有
write:pages权限的普通编辑者,竟能借助 Vue 指令白名单缺陷,在管理员浏览页面时以管理员会话执行任意脚本。本文以一线架构师视角,完整拆解这条攻击链的每一个环节、源码根因与工业级修复方案。
一、Wiki.js XSS 漏洞的事件全景与威胁定级
CVE-2026-120697 的官方描述非常克制,但信息量极大:Wiki.js 在 2.5.315 之前的版本中,server/modules/rendering/html-security/renderer.js 将 v-slot:tabs 与 v-slot:content 这两个可执行 Vue 指令加入了 DOMPurify 的允许列表(allowlist)。这意味着 HTML 净化器不再剥离它们,而净化后的输出会被当作“已渲染页面 HTML”插入 DOM,随后由 Vue 2 的运行时编译器(runtime compiler)重新编译执行。
从架构视角看,这不是一个普通的“过滤不严”问题,而是一次信任边界错配:净化层(DOMPurify)认为这些属性是安全的静态标记,而编译层(Vue 2 runtime compiler)却把它们当作可执行代码。两个安全模型之间的语义鸿沟,正是攻击者的立足点。
攻击者不需要 write:scripts 权限,也不需要管理员身份。只要拥有最基础的 write:pages 权限(多数 Wiki 站点会授予内容编辑者),即可完成存储型注入。脚本以浏览者的浏览器会话执行——当管理员打开该页面时,攻击者即获得管理员权限下的 GraphQL 操作能力。
企业级架构规范
flowchart TD
subgraph 攻击者层 ["攻击者与低权限入口 (Attacker Tier)"]
A["持有 write:pages 的编辑者"] --> B["提交含 v-slot 指令的页面 HTML"]
end
subgraph 净化层 ["服务端渲染与净化层 (Sanitize Tier)"]
B --> C["html-security/renderer.js 加载 DOMPurify"]
C --> D{"v-slot:tabs / v-slot:content 在白名单?"}
D -->|"是 (漏洞版本)"| E["指令原样保留,输出净化 HTML"]
D -->|"否 (2.5.315+)"| F["指令被剥离,攻击链中断"]
end
subgraph 编译层 ["客户端编译与执行层 (Vue Runtime Tier)"]
E --> G["页面 HTML 插入 DOM"]
G --> H["Vue 2 运行时编译器解析指令"]
H --> I["表达式在 Wiki.js 同源上下文执行"]
end
subgraph 影响层 ["会话与权限影响面 (Impact Tier)"]
I --> J["读取同源数据 / 篡改展示内容"]
I --> K["以浏览者会话调用 GraphQL"]
K --> L["管理员打开页面则触发特权操作"]
end
二、攻击链逐环拆解:为什么 DOMPurify 没能拦住
2.1 第一环:白名单的语义误判
DOMPurify 的设计哲学是“默认拒绝、显式允许”。它本身并不理解 Vue 指令的语义,只按属性名做匹配。Wiki.js 为了让页面模板中的标签页组件正常工作,主动把 v-slot:tabs、v-slot:content 加进了允许列表——这一步在功能上是合理的,在安全上却是致命的,因为 Vue 2 的 v-slot 值支持完整 JavaScript 表达式。
换句话说,净化器放行的不是一个“展示属性”,而是一个“代码执行入口”。这是典型的净化层与执行层语义不一致漏洞模式,与历史上 Angular 模板注入、Markdown 渲染器 XSS 属于同一族谱。
2.2 第二环:服务端净化 ≠ 客户端安全
很多团队存在一个认知误区:只要服务端做了 HTML 净化,前端就是安全的。但 Wiki.js 的渲染管线是两段式的:
- 服务端阶段:Markdown/HTML 经渲染器处理,DOMPurify 净化后落库或直接返回;
- 客户端阶段:净化后的 HTML 被插入页面容器,Vue 2 运行时编译器对容器内内容做二次编译。
问题在于,DOMPurify 的威胁模型是“浏览器原生 HTML 解析”,而 Vue 编译器的威胁模型是“模板表达式求值”。前者认为安全的字符串,后者可能视为可执行代码。安全边界在组件边界处发生了漂移,而没有任何一层对此负责。
在“服务端净化 + 客户端模板编译”的混合渲染架构中,净化白名单必须与模板引擎的可执行语法集合做交集校验,而不是与“功能所需属性”做并集。任何进入白名单的属性,都必须回答一个问题:它的值是否会被任何下游引擎当作代码求值?
2.3 第三环:会话上下文即权限放大器
存储型 XSS 的危害从来不在注入本身,而在执行时的身份。Wiki.js XSS 漏洞的脚本运行在 Wiki.js 同源上下文,因此攻击者可以:
- 读取同源下的页面内容、用户信息与本地存储令牌;
- 篡改页面展示内容,构造钓鱼表单诱导二次凭证泄露;
- 以浏览者身份发起同源 GraphQL 请求——当浏览者是管理员时,这些请求天然携带管理员权限,可执行页面删除、用户管理、权限变更等特权操作。
这就是 CVSS 8.7 的由来:攻击复杂度低(Low)、无需特权(PR:L 仅需低权限)、影响范围改变(S:C,从编辑者跨越到浏览者会话)、机密性与完整性双高。它本质上是一条从内容编辑权限到管理员权限的横向提权链。
三、源码根因定位:renderer.js 中的那一行白名单
漏洞的根因高度集中。在受影响版本中,HTML 安全渲染器的核心逻辑等价于如下结构(示意,非逐字源码):
// 漏洞版本:将 Vue 可执行指令加入 DOMPurify 允许列表
const ALLOWED_ATTRS = [
'class', 'id', 'href', 'src', 'alt', 'title',
// ... 常规展示属性
'v-slot:tabs', // ⚠️ 可执行 Vue 指令,值支持 JS 表达式
'v-slot:content' // ⚠️ 同上
];
function render(pageHtml) {
return DOMPurify.sanitize(pageHtml, {
ADD_ATTR: ALLOWED_ATTRS,
// 净化后的输出被直接作为已渲染 HTML 返回
});
}
// 下游:客户端将返回值插入 DOM 后由 Vue 2 runtime compiler 编译
// 于是 v-slot 的值被当作表达式求值 → 任意脚本执行
修复版本 2.5.315 的核心动作,就是把这两个指令从允许列表中移除,让 DOMPurify 恢复对它们的剥离行为。这是一个“最小必要修复”,但它也提示我们:如果 Wiki.js 未来引入其他可执行指令(如 v-html、v-on 的变体),同类问题可能以新形态复现。
仅升级到 2.5.315 可以阻断本 CVE,但历史已落库的恶意页面不会被自动清理。攻击者可能在修复前已写入 payload,升级后这些页面仍可能在其他渲染路径(如自定义主题、第三方插件)中被重新编译。升级后必须配合存量内容审计。
四、应急响应与生产加固清单
4.1 立即处置:升级与验证
处置优先级最高的动作是升级到 2.5.315 或更高版本。对于使用容器化部署的团队,建议同时锁定镜像标签并校验构建产物。
点击展开:升级命令、版本校验与存量内容审计脚本
# 1) 备份数据库与页面内容(务必先做)
# 2) 升级到修复版本
npm install wiki.js@2.5.315
# 或 Docker 部署
# docker pull requarks/wiki:2.5.315
# 3) 校验运行版本
node -e "console.log(require('./package.json').version)"
# 4) 存量内容审计:检索历史页面中的可疑 Vue 指令
# 以 PostgreSQL 为例,定位包含 v-slot 的页面
psql -d wikijs -c "SELECT id, path, title FROM pages WHERE content ILIKE '%v-slot%';"
# 5) 对命中页面做人工复核,必要时回滚或删除
4.2 纵深防御:即使升级也要做的加固
- 启用严格 CSP:禁止内联脚本与未授权脚本源,可显著降低 XSS 成功后的利用面,即使净化被绕过也能兜底;
- 收紧 write:pages 授权:按最小权限原则重新评估编辑者名单,对高敏感空间实施审批流;
- Cookie 加固:会话 Cookie 设置
HttpOnly、Secure、SameSite=Lax/Strict,降低令牌被脚本读取的风险; - GraphQL 侧二次鉴权:对特权操作增加 CSRF Token 或二次确认,避免同源脚本直接调用敏感 mutation;
- 内容变更审计:对页面写入操作记录操作者、时间与 diff,便于事后溯源。
4.3 修复前后对比矩阵
| 评估维度 | 受影响版本 (< 2.5.315) | 修复版本 (≥ 2.5.315) | 架构收益 |
|---|---|---|---|
| v-slot 指令处理 | 加入 DOMPurify 白名单,原样保留 | 从白名单移除,净化时剥离 | 攻击链源头阻断 |
| 低权限用户注入面 | write:pages 即可注入可执行表达式 | 注入内容被净化,无法执行 | 权限边界收敛 |
| 管理员会话风险 | 浏览恶意页面即触发特权 GraphQL | 无脚本执行,会话安全 | 横向提权链切断 |
| 存量内容 | 可能已存在恶意 payload | 需配合审计脚本人工复核 | 可审计可追溯 |
五、从 Wiki.js XSS 漏洞看混合渲染架构的安全范式
这起 CVE 给所有“服务端渲染 + 客户端模板编译”的 Node.js 应用敲响了警钟。我的核心结论有三条:
第一,净化白名单必须按“执行语义”而非“功能需求”来设计。任何属性进入白名单前,都要评估其值是否会被下游模板引擎、表达式引擎或脚本引擎求值。功能团队与安全团队必须在白名单评审上形成强制卡点。
第二,信任边界要显式化。DOMPurify 的输出不应被默认视为“安全 HTML”,而应被视为“经过一层净化的不可信内容”。在插入 Vue 编译容器前,应增加第二道校验或使用 v-pre 等机制阻止二次编译。
第三,CSP 是 XSS 的最后一道防线。Wiki.js XSS 漏洞的修复是点状的,但同类问题会以新形态出现。严格 CSP 配合 HttpOnly Cookie,能把“注入成功”与“利用成功”解耦,为修复争取时间窗口。
对于自建 Wiki、知识库、CMS 类系统,建议把“渲染管线安全评审”纳入上线检查单:净化器白名单、模板编译范围、CSP 策略、Cookie 属性、特权 API 二次鉴权,五项缺一不可。Wiki.js XSS 漏洞不是孤例,而是这类系统共性风险的集中暴露。
