tt-rss 安全实践完整指南:RSS 读取器 CSRF 防护、Crypt 加密与内容净化的多层防线

原创2026-10-25 14:03:241,393 阅读

tt-rss 安全实践完整指南:RSS 读取器 CSRF 防护、Crypt 加密与内容净化的多层防线

tt-rss 是一款免费、开源、基于 Web 的 RSS/Atom 新闻订阅阅读器与聚合器。当它作为个人新闻门户长期运行时,安全性尤为重要。本文带你深入 tt-rss 内置的三道核心防线:CSRF 防护、Crypt 加密存储与 Sanitizer 内容净化,看看这款 RSS 读取器是如何层层保护你的账号与阅读内容的 🔒

防线全景:三层防护各挡什么威胁

tt-rss 没有把安全寄托在单一机制上,而是针对"伪造请求""数据泄露""恶意内容"三类威胁分别设防:

防线 针对的威胁 核心机制 主要源码
CSRF 防护 跨站请求伪造(伪造登录用户操作) 会话级随机令牌 + 时序安全比对 backend.php
Crypt 加密 数据库/存储泄露导致的敏感信息暴露 XChaCha20-Poly1305 认证加密 classes/Crypt.php
Sanitizer 净化 第三方 RSS 内容中的恶意 HTML 白名单过滤 + URL 重写 + iframe 沙箱 classes/Sanitizer.php

三层防线覆盖请求进入、数据落盘、内容展示的全生命周期,下面逐层拆解。

第一层:CSRF 防护——让伪造请求"过不了关"

令牌如何生成:登录即绑定

用户登录成功时,tt-rss 会生成一个 16 字节密码学安全随机数并转成十六进制串,存入会话:

$_SESSION["csrf_token"] = bin2hex(get_random_bytes(16));

这段逻辑位于 classes/UserHelper.php,随机字节由 get_random_bytes() 优先调用 PHP 原生的 random_bytes() 生成,保证不可预测。每个会话一个独立令牌,跨站页面拿不到它,也就无法冒充你发起操作。

每次后台请求都要"验票"

所有通过 backend.php 进入的 API 调用,都会先经过 CSRF 校验,验票不通过直接拒绝并记录告警日志:

if (validate_csrf($csrf_token) || $handler->csrf_ignore($method)) { ... }

见 backend.php。校验函数 validate_csrf() 使用 hash_equals() 做比对——这是一个时序安全函数,能防止攻击者通过响应时间差逐位猜出令牌,细节见:

return isset($csrf_token) && hash_equals($_SESSION['csrf_token'] ?? "", $csrf_token);

表单提交时,令牌以隐藏字段随请求带回,例如 classes/Pref_Feeds.php 中的 <input type='hidden' name='csrf_token' ...>。

只读方法可"免检",写操作一个都不放

并非所有方法都需要令牌。各处理器可实现 csrf_ignore() 声明只读方法豁免,例如订阅源列表的 Feeds::csrf_ignore() 仅对 index(浏览列表)放行。修改订阅源、删除条目等写操作一律必须携带有效令牌——读写分离,既减少摩擦又不留漏洞。

插件与登录页同样设防

  • 插件调用同样走令牌校验,无效时输出 Rejected {$plugin_name}->{$method}(): invalid CSRF token.,见 classes/PluginHandler.php
  • 登录与找回密码接口独立校验 CSRF,双重验证输入(如 classes/Handler_Public.php 中找回密码需同时通过令牌与测试值比对)
  • 管理接口在 Handler_Protected 之上再叠加权限检查,Handler_Administrative 只放行管理员级别,形成"令牌 + 会话 + 角色"的复合门槛

第二层:Crypt 加密——敏感数据落盘即密文

一个算法,两种秘密

classes/Crypt.php 实现非常精简,却用上了现代加密的最佳实践:

  • 算法:xchacha20poly1305_ietf(L5),基于 libsodium 的认证加密(AEAD),加密与完整性校验一步完成,篡改过的密文解密会直接失败
  • 密钥:由 generate_key() 调用 sodium_crypto_aead_chacha20poly1305_keygen() 生成 256 位随机密钥,需自行填入配置文件(可参考 config.php-dist),运行时经 Config::get(Config::ENCRYPTION_KEY) 读取
  • 随机数:每次加密使用 random_bytes() 生成全新 nonce,同一明文多次加密结果不同,杜绝模式泄露

加密输出是 algo + nonce + payload 三元组(encrypt_string()),解密端按算法分发处理,为将来更换算法留了余地。

加密用在哪:两处"最值钱"的数据

① 订阅源密码。 需要登录才能抓取的 RSS 源,其密码会被加密存储:抓取前经 Feeds::decrypt_feed_pass() 透明解密;若发现库里还是明文且已配置密钥,RSSUtils 会在下次抓取时自动"补加密"写回——升级部署后旧数据也能平滑进入加密状态。

② 会话数据。 tt-rss 的会话存在数据库 ttrss_sessions 表而非临时文件。classes/Sessions.php 在 write() 时若检测到加密密钥,先整体加密再序列化、Base64 后入库;read() 时反向解密。配合 session.use_only_cookies = true 等收紧的会话配置(configure()),即使数据库备份文件泄露,攻击者拿到的也是一堆无法解密的乱码。

第三层:Sanitizer 内容净化——驯服来路不明的 HTML

RSS 内容是第三方提供的,是 XSS 的主要入口。Sanitizer::sanitize() 是每篇文章入库展示前的"安检机",执行四道工序:

① URL 重写 + SSRF 拦截

所有 a<a href="https://link.gitcode.com/i/6d2d44a9c7ec4dc15ae8c50ff71f7816" target="_blank">href]、img[src|srcset]、video[poster] 都会经过 [UrlHelper::rewrite_relative() 重写为绝对地址,并检查 UrlHelper::has_disallowed_ip()。指向内网/保留 IP 段的资源地址会被直接剔除(见 classes/Sanitizer.php)——防止恶意源借你的服务器去探测内网。

② 白名单标签与"有毒属性"清除

tag 白名单 只保留 p、a、img、table 等排版所需元素,script、form、object 等一律整体删除。strip_harmful_tags() 还会逐个属性体检,凡命中以下规则即剥离:

  • 以 on 开头的属性(onclick、onerror 等内联事件)
  • javascript: 伪协议的 href
  • id、style、class 等干扰布局的属性

插件还可以经 HOOK_SANITIZE 钩子动态调整白名单,兼顾定制与扩展安全。

③ iframe 沙箱:白名单进宽沙箱,其余进严沙箱

iframe 处理逻辑 区分两种情况:命中 HOOK_IFRAME_WHITELISTED(如 YouTube 嵌入插件)的允许较完整的能力集;未白名单的一律只给 sandbox="allow-scripts",且禁止 srcdoc 属性,恶意嵌入脚本无法触碰 Cookie 与页面其他部分。

④ 展示层的"顺手加固"

  • 外部链接统一加 rel="noopener noreferrer" + target="_blank",防反向标签劫持
  • 图片加 referrerpolicy="no-referrer"(不泄露你访问了谁)与 loading="lazy"
  • 命中黑名单 IP 的 <img> 会被替换为转义文本,彻底不出图

小结:纵深防御,每一层都值得学

🛡️ tt-rss 的安全设计给新手用户一个重要信号:它开箱即安全,且机制清晰可查。

  1. CSRF 层:会话绑定随机令牌 + hash_equals 时序安全比对 + 读写方法分级豁免,挡住伪造请求
  2. 加密层:配置 ENCRYPTION_KEY 后,会话与订阅源密码落盘即密文,用 AEAD 算法保证密文不可读、不可篡改
  3. 净化层:白名单过滤、SSRF 拦截、iframe 沙箱三道工序,把第三方 HTML 驯服成"无害排版"

作为自托管的 RSS 读取器,tt-rss 提醒你只需做一件关键的事:在 config.php-dist 基础上设置 ENCRYPTION_KEY,即可激活全套静态加密能力。配合定期更新与 HTTPS 部署,你的新闻门户就能在三道防线的守护下稳定运行 ✅

登录后查看全文
tt-rss