qBittorrent RSS过滤器无法自动下载？

Question

qBittorrent RSS过滤器无法自动下载的常见问题之一是：用户虽已正确配置RSS订阅源并设置过滤规则，但新条目出现时仍不触发自动下载。此问题通常源于“自动下载”选项未启用，或过滤器未勾选“启用”状态。此外，若qBittorrent未定期更新RSS馈送（如更新间隔过长或后台任务被阻止），也会导致延迟或漏判。部分情况下，过滤规则中的关键词匹配不准确，或种子发布时间早于软件启动时间，致使系统误判为“旧条目”而忽略。确保客户端处于运行状态、网络通畅，并检查日志中是否有“RSS Auto-Download Triggered”相关记录，有助于定位问题根源。

Answer 1

一、qBittorrent RSS自动下载失效的常见表层问题

在使用qBittorrent进行RSS自动下载时，许多用户反馈尽管已配置好订阅源和过滤规则，但新发布的种子并未触发自动下载。最基础且常见的原因包括：

1. “自动下载”功能未启用：需在“工具 → 选项 → RSS”中确认勾选“启用自动下载”。
2. RSS过滤器处于禁用状态：每个过滤器需手动启用，否则即使匹配也不会执行动作。
3. RSS更新间隔设置过长：默认可能为30分钟，导致新条目延迟获取。
4. 客户端未持续运行：若qBittorrent关闭或挂起，后台任务无法执行。
5. 网络连接异常：防火墙、代理或DNS问题可能导致RSS源拉取失败。

问题类型	典型表现	排查路径
功能未开启	无任何自动下载行为	检查全局RSS设置与过滤器启用状态
更新延迟	新种子数小时后才被识别	查看RSS更新周期及日志时间戳
匹配失败	关键词不生效	验证正则表达式或通配符语法
时间误判	旧条目标记为已处理	对比系统启动时间与种子发布时间

二、深入分析：从配置逻辑到系统行为链

当基础检查完成后仍存在问题，需进入更深层次的技术剖析。qBittorrent的RSS自动下载机制依赖于以下核心流程：

1. 定时拉取RSS Feed（由更新间隔控制）
2. 解析XML内容并提取条目（title, pubDate, link等字段）
3. 遍历所有启用的过滤器，按规则匹配标题或其他元数据
4. 判断条目是否为“新”——基于内部缓存的时间戳记录
5. 若匹配成功且为新条目，则触发添加种子动作
6. 记录日志事件：“RSS Auto-Download Triggered”
    

其中关键点在于第4步的时间判定逻辑。qBittorrent会维护一个内存中的“已处理条目”列表，其判断依据是种子的发布时间（pubDate）是否早于客户端本次运行的启动时间。若种子发布于软件上次关闭期间，则会被视为“历史条目”而忽略。

此外，某些RSS源提供的<pubDate>格式不符合RFC-822标准，可能导致解析失败或时间错乱。例如：

• Tue, 09 Jul 2024 15:30:00 +0000 ✅ 正确
• 2024-07-09T15:30:00Z ❌ 可能被错误解析

三、解决方案体系化实施路径

针对上述问题，建议采用分阶段排障策略：

1. 确认全局RSS设置中“启用自动下载”已勾选。
2. 进入RSS订阅管理界面，确保目标过滤器状态为“启用”。
3. 将RSS更新间隔调整至5~10分钟，提升响应速度。
4. 检查日志文件（可通过Web UI底部日志面板或本地日志路径访问），搜索关键字：RSS Auto-Download Triggered 或 Processing RSS feed。
5. 手动刷新RSS订阅，观察是否立即加载最新条目。
6. 测试过滤规则时，使用简单关键词（如“S02”），排除正则表达式复杂性干扰。
7. 对于长期离线场景，可考虑结合外部脚本定期唤醒客户端，避免错过发布时间窗口。
8. 部署反向代理或本地缓存服务（如RSSHub），增强对非标准Feed的支持能力。
9. 启用调试日志级别，在高级设置中增加日志输出细节。
10. 验证磁盘空间与保存路径权限，防止因IO问题导致下载静默失败。

四、可视化诊断流程图

以下是qBittorrent RSS自动下载触发失败的决策诊断流程：

graph TD
    A[新种子发布] --> B{qBittorrent正在运行?}
    B -- 否 --> C[等待下次启动, 条目可能被忽略]
    B -- 是 --> D{RSS更新周期到达?}
    D -- 否 --> E[延迟检测]
    D -- 是 --> F{成功获取Feed数据?}
    F -- 否 --> G[检查网络/DNS/防火墙]
    F -- 是 --> H{解析pubDate是否有效?}
    H -- 否 --> I[修正Feed源或使用中间层转换]
    H -- 是 --> J{发布时间 > 客户端启动时间?}
    J -- 否 --> K[视为旧条目, 不触发]
    J -- 是 --> L{过滤器规则匹配成功?}
    L -- 否 --> M[调整关键词/正则表达式]
    L -- 是 --> N[RSS Auto-Download Triggered]
    N --> O[成功添加种子]