tt-rss 安全实践完整指南:RSS 读取器 CSRF 防护、Crypt 加密与内容净化的多层防线
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:伪协议的hrefid、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 的安全设计给新手用户一个重要信号:它开箱即安全,且机制清晰可查。
- CSRF 层:会话绑定随机令牌 +
hash_equals时序安全比对 + 读写方法分级豁免,挡住伪造请求 - 加密层:配置
ENCRYPTION_KEY后,会话与订阅源密码落盘即密文,用 AEAD 算法保证密文不可读、不可篡改 - 净化层:白名单过滤、SSRF 拦截、iframe 沙箱三道工序,把第三方 HTML 驯服成"无害排版"
作为自托管的 RSS 读取器,tt-rss 提醒你只需做一件关键的事:在 config.php-dist 基础上设置 ENCRYPTION_KEY,即可激活全套静态加密能力。配合定期更新与 HTTPS 部署,你的新闻门户就能在三道防线的守护下稳定运行 ✅