用户脚本的安全底线:LDStatusPro 的 OAuth 认证、XSS 防护与 SQL 注入防御机制剖析

原创2026-10-15 06:07:131,389 阅读

用户脚本的安全底线:LDStatusPro 的 OAuth 认证、XSS 防护与 SQL 注入防御机制剖析

LDStatusPro 是一款 Linux.do 社区增强工具的开源项目,包含论坛用户脚本、LD 士多前端源码和官网源码。当你在浏览器里安装一个用户脚本时,等于把账号、阅读数据交给了第三方工具——它如何保证安全?本文剖析 LDStatusPro 在 OAuth 认证、XSS 防护与 SQL 注入防御上的完整实践,帮你看懂一个开源项目是怎么守住安全底线的。

LDStatusPro 官网首页

为什么用户脚本要重点防范三大安全风险?

用户脚本运行在你的浏览器里,直接触碰三样东西:登录凭据、用户输入、后端数据。对应的就是三大经典攻击面:

风险 攻击目标 LDStatusPro 的对策
凭据窃取 OAuth Token OAuth 2.0 + JWT,全链路时效与签名校验
XSS 跨站脚本 浏览器与用户输入 HTML 转义 + 链接白名单 + CSP 内容安全策略
SQL 注入 后端数据库 统一参数化查询,移除动态 SQL 拼接

这套安全需求最初就写进了项目需求文档,见 prd.md 中的「安全需求」章节:所有用户输入必须转义、认证采用 OAuth 2.0 + JWT、数据库操作使用参数化查询、传输层走 HTTPS 并对 CDK 卡密做 AES 加密。

LD 士多是该项目的商城产品,用户会在这里用社区积分兑换虚拟商品,涉及真实的下单与发货,安全机制因此做得格外严格。

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 的处理逻辑值得学习:

  1. 先本地检查——凭据格式、到期时间、身份一致性,缺一不可;
  2. 再服务端验证——携带候选令牌请求 /api/shop/auth/verify,由服务端校验签名与身份;
  3. 确认成功后才写入会话——验证通过之前,候选凭据绝不进入当前会话;
  4. 校验过程中若检测到「其他标签页已经登录/退出」,本次操作直接取消,防止把旧账号的操作发给新账号。

完整规则沉淀在文档 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 逐条断言守护,任何一次改动想悄悄放宽策略都会被测试拦下。

LDStatusPro 与 LD 士多产品形象

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 的安全设计并不是堆砌高深技术,而是一份新手也能抄作业的清单:

  1. 凭据:OAuth 2.0 + JWT,候选令牌先验证后保存,提前判过期,跨标签页会话同步;
  2. 输入:转义优先于排版,白名单优于黑名单,桥接 URL 精确匹配源与路径前缀;
  3. 策略:CSP 禁用内联脚本与 eval,响应头锁死帧嵌套与 MIME 嗅探;
  4. 数据:参数化查询 + 原子操作 + 敏感卡密加密;
  5. 回归:每一种攻击手法都有对应的自动化测试用例,安全随每次发版一起回归。

对普通用户而言,这些细节意味着:登录凭据不会残留在地址栏、AI 输出的恶意代码无法在你的页面里执行、商品发布框里的注入尝试进不了数据库。把「默认不信任」贯彻到每一层,就是一个用户脚本工具最值得交付的安全底线。

登录后查看全文
LDStatusPro