用户脚本的安全底线:LDStatusPro 的 OAuth 认证、XSS 防护与 SQL 注入防御机制剖析
用户脚本的安全底线:LDStatusPro 的 OAuth 认证、XSS 防护与 SQL 注入防御机制剖析
LDStatusPro 是一款 Linux.do 社区增强工具的开源项目,包含论坛用户脚本、LD 士多前端源码和官网源码。当你在浏览器里安装一个用户脚本时,等于把账号、阅读数据交给了第三方工具——它如何保证安全?本文剖析 LDStatusPro 在 OAuth 认证、XSS 防护与 SQL 注入防御上的完整实践,帮你看懂一个开源项目是怎么守住安全底线的。
为什么用户脚本要重点防范三大安全风险?
用户脚本运行在你的浏览器里,直接触碰三样东西:登录凭据、用户输入、后端数据。对应的就是三大经典攻击面:
| 风险 | 攻击目标 | LDStatusPro 的对策 |
|---|---|---|
| 凭据窃取 | OAuth Token | OAuth 2.0 + JWT,全链路时效与签名校验 |
| XSS 跨站脚本 | 浏览器与用户输入 | HTML 转义 + 链接白名单 + CSP 内容安全策略 |
| SQL 注入 | 后端数据库 | 统一参数化查询,移除动态 SQL 拼接 |
这套安全需求最初就写进了项目需求文档,见 prd.md 中的「安全需求」章节:所有用户输入必须转义、认证采用 OAuth 2.0 + JWT、数据库操作使用参数化查询、传输层走 HTTPS 并对 CDK 卡密做 AES 加密。
LD 士多是该项目的商城产品,用户会在这里用社区积分兑换虚拟商品,涉及真实的下单与发货,安全机制因此做得格外严格。
OAuth 认证:「不信任、必验证」的完整闭环
登录流程:官方 OAuth 签发 JWT 令牌
LDStatusPro 支持 Linux.do 与 IDCFlare 双站点登录,两个站点独立认证、数据互不干扰。脚本内的 OAuth 管理器定义在 LDStatusPro.user.js 的 OAuthManager 类中,登录成功后获得一个 JWT 令牌。令牌不是一拿到就「终身有效」:脚本会解析 JWT 的 exp 字段,并提前 10 分钟判定为过期(源码中的容错设计),过期令牌会被立即作废并触发登出。
一个容易忽略的细节:登录结果通过 URL hash 传递(ldsp_oauth=base64(json)),这份候选凭据有5 分钟时效,读取后立即从地址栏清除,避免令牌残留在浏览器历史里。
回调校验:候选凭据先验证、后保存
在 LD 士多网页端,登录回调页 ld-store/src/views/AuthCallback.vue 的处理逻辑值得学习:
- 先本地检查——凭据格式、到期时间、身份一致性,缺一不可;
- 再服务端验证——携带候选令牌请求
/api/shop/auth/verify,由服务端校验签名与身份; - 确认成功后才写入会话——验证通过之前,候选凭据绝不进入当前会话;
- 校验过程中若检测到「其他标签页已经登录/退出」,本次操作直接取消,防止把旧账号的操作发给新账号。
完整规则沉淀在文档 ld-store/docs/auth-session.md 中,明确写道:浏览器本地检查不能替代服务端签名验证。
会话生命周期:提前到期、跨标签页同步
ld-store/src/utils/auth.js 中的 JWT 解析只接受 HS256 算法签名,且用户 ID 必须是合法数字、站点必须在 linux.do / idcflare.com 白名单内,否则整份令牌作废。会话还有版本号(revision)机制:登录、退出、凭据变化都会刷新版本,旧会话发起的请求即使返回成功,也会被标记为 SESSION_CHANGED 而丢弃——旧界面的操作永远不会「串号」到新账号。
XSS 防护:从 HTML 转义到内容安全策略
HTML 转义:用户输入的第一道防线
跨站脚本(XSS)的本质,是让浏览器执行攻击者伪造的 HTML。最朴素的解法就是转义:把 <、>、&、引号等字符编码成 HTML 实体,让它们变成纯文本。
LDStatusPro 在两个层级各有一套转义器:
- 用户脚本核心模块 src/core/sanitize.mjs 的
escapeHtml,供吃瓜助手等渲染 AI 输出时使用; - LD 士多的 ld-store/src/utils/security.js 提供了转义、剥离标签、清理危险字符(
javascript:、on*=事件处理器、NULL 字节)的工具函数,并内置了可疑输入检测isSuspiciousInput,能识别<script>、<iframe>、eval()等特征。
此外,LD 士多还接入了 ld-store/src/utils/sanitizeHtml.js,基于 DOMPurify 做白名单清洗:script、iframe、object、form 等标签和 onerror 等事件属性被整体禁止。历史版本中修复过的弹窗未转义漏洞(见 update_log.md)也说明:转义不是写一次就完事,而是持续回归的对象。
Markdown 渲染:先转义,再排版
吃瓜助手会把 AI 模型的输出渲染成 Markdown,而模型输出是不可信的。renderMarkdown 的流水线设计很讲究:先把代码块和正文整体 escapeHtml,再套用标题、列表、加粗等排版规则。这意味着即使模型被诱导输出 <img src=x onerror=alert(1)>,最终渲染的也只是一段可见的文本,而不是可执行代码。
URL 桥接白名单:https + 精确源 + 路径前缀
脚本还会嵌入 cdk.linux.do、credit.linux.do 等页面的面板,跨域通信前必须过 isAllowedBridgeUrl 这道关卡。它的规则相当严苛:
- 协议必须是
https:,且 URL 中不允许携带user:pass@凭据; - 精确匹配源(origin)——
cdk.linux.do.evil.com这类伪造域名直接被拒绝; - 默认路径必须落在
/api/前缀下,连https://cdk.linux.do/dashboard都不放行。
单元测试 tests/sanitize.test.mjs 把这些绕过手法逐一写成了用例:主机名混淆、协议降级、凭据注入、路径穿越……每一种都必须返回 false。
CSP 响应头:浏览器层面的最后一道锁
前端防护可能被绕过,但浏览器原生策略不会。LD 士多通过 ld-store/public/_headers 下发了一组严格响应头:
Content-Security-Policy: default-src 'self';
script-src 'self' https://mxana.tacool.com https://static.cloudflareinsights.com;
style-src-attr 'none';
object-src 'none'; base-uri 'self'; form-action 'self';
frame-ancestors 'none'
X-Frame-Options: DENY
X-Content-Type-Options: nosniff
关键点在于:script-src 里没有 'unsafe-inline'(禁止内联脚本)、没有 'unsafe-eval'(禁止动态执行代码),frame-ancestors 'none' 加 X-Frame-Options: DENY 则彻底杜绝了页面被 iframe 套用的点击劫持。这套策略由测试 ld-store/tests/security-policy.test.js 逐条断言守护,任何一次改动想悄悄放宽策略都会被测试拦下。
SQL 注入防御:统一使用参数化查询
SQL 注入是服务端的问题——用户输入被直接拼进 SQL 语句,攻击者就能改写查询逻辑、拖库删数据。LDStatusPro 后端的对策只有八个字:统一参数化查询。
在 LD 士多 2.0 上线(v3.5.4.0)时,项目专门做了一轮安全加固,见 update_log.md:
💉 SQL 注入防护 - 统一使用参数化查询,移除动态 SQL 拼接
参数化查询的原理很直观:SQL 模板和数据分开传递,数据库只会把数据当作「值」,而不是「指令」,' OR 1=1 -- 这类经典载荷就彻底失效。同时该版本还修复了 CDK 高并发超卖的竞态条件(改用原子 UPDATE),并对 CDK 卡密做 AES 加密存储——认证、输入、数据三层一起加固,而不是只补一个洞。
需要说明的是,本仓库只包含前端三件套(用户脚本、LD 士多、官网),后端服务是独立仓库;上述措施记录于本仓库的需求与更新文档中,作为项目整体的安全承诺。
总结:一套可借鉴的安全底线清单
回过头看,LDStatusPro 的安全设计并不是堆砌高深技术,而是一份新手也能抄作业的清单:
- 凭据:OAuth 2.0 + JWT,候选令牌先验证后保存,提前判过期,跨标签页会话同步;
- 输入:转义优先于排版,白名单优于黑名单,桥接 URL 精确匹配源与路径前缀;
- 策略:CSP 禁用内联脚本与 eval,响应头锁死帧嵌套与 MIME 嗅探;
- 数据:参数化查询 + 原子操作 + 敏感卡密加密;
- 回归:每一种攻击手法都有对应的自动化测试用例,安全随每次发版一起回归。
对普通用户而言,这些细节意味着:登录凭据不会残留在地址栏、AI 输出的恶意代码无法在你的页面里执行、商品发布框里的注入尝试进不了数据库。把「默认不信任」贯彻到每一层,就是一个用户脚本工具最值得交付的安全底线。


