RSS 订阅配置指南

本页介绍如何获取站点的 RSS 链接、在 pt-tools 中添加订阅，以及各个选项的作用。

什么是 RSS 订阅

注意

默认只下载免费种子：订阅没有关联过滤规则、下载模式为默认的「智能」时，RSS 订阅只会自动下载免费种子，不会下载非免费种子。如果您只是刷流，无需设置任何过滤规则，直接添加 RSS 订阅即可。只有在需要追剧或下载特定资源（即便种子非免费也要下载）时，才需要前往「过滤规则」页面创建规则，并关闭规则中的「仅免费」开关。详见 过滤规则与追剧指南。

RSS (Really Simple Syndication) 是一种网络内容聚合格式。在 PT (Private Tracker) 站点中，RSS 用于发布最新的种子信息。

通过配置 RSS 订阅，pt-tools 可以：

1. 定期检查站点发布的最新种子
2. 按下载模式和过滤规则（标题关键词、体积、是否免费等）决定是否下载
3. 将符合条件的种子推送到下载器（qBittorrent、Transmission）

这是实现"全自动刷流"和"自动追剧"的核心功能。

获取 RSS 链接

不同的 PT 站点架构，获取 RSS 链接的方式略有不同。

NexusPHP 架构站点 (如 HDSky, SpringSunday)

这类站点通常基于 Cookie 进行认证，RSS 链接中可能会包含用户的 passkey，请勿泄露自己的 RSS 链接。

步骤：

1. 登录站点，进入种子页面 (Torrents) 或 首页。
2. 寻找 RSS 图标或「订阅」链接，通常在页面右上角、消息通知图标附近。
3. 选择要订阅的分类（如剧集）、清晰度等条件和每页条数，然后生成 RSS 链接。
4. 复制生成的链接（一般选择面向支持 RSS 的 BT 客户端的那个地址）。
5. 链接格式通常如下： https://site.com/torrentrss.php?rows=10&linktype=dl&passkey=YOUR_PASSKEY

参数说明：

• rows: 返回的种子数量 (建议设置为 10-50)
• linktype: 链接类型，通常必须包含 dl 以直接获取下载链接
• passkey: 你的个人密钥，请勿泄露

UHDDolby 的 RSS 链接有有效期（默认 90 天，最长 180 天，生成时选），到期后要重新生成，换掉 pt-tools 里的 RSS 地址和站点设置里的 API Key（同一个 RSSKEY）。

mTorrent 架构站点 (如 M-Team)

这类较新的站点通常使用 API Key 或特殊的 RSS 生成页面。

步骤（以 M-Team 为例）：

1. 登录站点，进入 用户中心 或 个人设置。
2. 找到 API / RSS 设置部分。
3. 生成一个新的 API Key (如果需要)。
4. 在 RSS 生成器中选择你需要的分类（如 Movie, TV）。
5. 复制生成的链接。
6. 链接格式示例： https://rss.m-team.cc/api/rss/fetch?dl=1&pageSize=10&sign=XXXX&t=XXX&tkeys=ttitle&uid=XXX

在 pt-tools 中添加订阅

1. 打开 站点 → 站点列表，点击站点所在行的「站点配置与 RSS 订阅」按钮，进入站点页面。
2. 切换到「RSS 订阅」标签，点击「添加 RSS」。
3. 填写名称和链接，按需设置下面的选项，然后保存。

链接要用站点 RSS 页上给你的那个。照着示例填、还是 https://hdsky.xxx/… 这类占位地址的链接取不到任何种子：填的时候就提示，保存时拦下；以前存下的在列表里标着「占位地址，不会去拉」，RSS 任务跳过它（运行日志里记一条），把链接换成真实的就好。

链接旁边的「试一下」现拉一次，不保存：能用时写明取到几条、最新一条的标题；取不到时写明是哪一步出的问题——域名查不到、连不上、连接被重置、超时、站点回的状态码（被 Cloudflare 质询拦了时写明）、回的是网页不是 RSS。提示里不带链接里的 passkey。

保存后，订阅在 RSS 任务运行时按检查间隔拉取。RSS 任务没在运行时（自动启动默认关闭，程序每次启动后要手动启动）订阅不会拉取，开关在底部状态栏左端的「RSS 任务」，见RSS 任务的启动与停止。推送的种子显示在 下载 → 任务列表 中；没有推送时，系统 → 运行日志 会记录原因。

订阅选项

选项	说明	默认值
名称	订阅的名称，方便识别	必填
检查间隔	多久拉取一次，单位分钟，可设 5–1440	10
链接	站点的 RSS 地址	必填
分类	推送到下载器时使用的分类	空
标签	推送到下载器时添加的标签	空
下载器	推送到哪个下载器；未启用的下载器不能选	默认下载器
下载路径	点开可以选下载器中预设的目录，也可以直接输入；留空使用下载器默认路径	空
过滤规则	关联的过滤规则，可多选	不关联
下载模式	跟随全局、智能、仅过滤规则或仅免费，见下文	跟随全局
免费结束时没下完	不处理、暂停或删除，见下文「免费资格与到期暂停」	暂停
通知模式	有新种时是否推送通知，见 RSS 上新通知	不通知

下载模式

模式	行为
智能（推荐）	没有关联过滤规则时只下载免费种子；关联了规则后只下载匹配规则的种子，不再自动下载未匹配的免费种子
仅过滤规则	只下载匹配过滤规则的种子；没有关联规则的订阅不会下载任何种子
仅免费	只下载免费种子，忽略过滤规则，适合纯刷流
跟随全局	使用 系统 → 全局设置 中的「默认下载模式」，默认是智能

免费种子还要能在免费期内下载完成才会推送，判断方法见 配置说明 中的限速与最短免费时间。全局设置中的种子大小上限和下限对所有模式都生效。

免费资格与到期暂停

免费通道（智能、仅免费模式下的免费种）和开了「仅免费」的过滤规则都要求免费。要求免费的种子，推送到下载器之前必须有这一轮读到的免费资格：

• 免费到某个时间：剩余时间超过安全余量才推送。安全余量是全局设置里的「免费期结束前提前处理」，至少 5 分钟。
• 结束时间未知：站点标了免费，但没有给出结束时间，或者结束时间解析不了。这种不当长期免费，不推送；种子文件留在暂存目录，下一轮重新读取，读到结束时间以后再推送。确实要下载，就关联一条不开「仅免费」的过滤规则。
• 不是免费、免费已结束：不推送，删除暂存的种子文件。

上一轮没推出去的种子（例如磁盘空间不足），这一轮推送前会重新读一次站点详情；条目已经不在 RSS 里、或者详情读取失败时，不推送，也不沿用上一轮的资格。没开「仅免费」的过滤规则、通知里的「立即下载」和手动推送不要求免费，不是免费也照常推送。

每一轮都会读订阅里每个条目的站点详情，以前跳过的种子也按这一轮重新判断：之后变成免费，或者改了过滤规则、大小限制，下一轮就会下载。已经推送的种子不会再推，但免费缩短、延长或取消时，「免费结束时没下完」选的暂停或删除和自动删种的「其他免费种子免费过了没下完就删」都按新读到的结束时间处理；任务的来源与命中的过滤规则也按这一轮的判断更新（过滤规则页的命中数仍按把种子推进下载器的那条规则统计）。条目越多，对站点的请求越多；M-Team 等对接口频率敏感的站点，间隔不要设得太短。

同一个站点的几条订阅用同一个标签时，暂存目录是同一个。每个种子归第一次决定下载它的那条订阅，只由它推送和清理，用它的下载器、下载路径和「免费结束时没下完」的选择；其他订阅不会动它。

「免费结束时没下完」选了暂停或删除的订阅：

• 选「删除」时，到期没下完的种子连数据一起删除（数据还被别的种子用着时只删种子）；带保留标签、保护标签或 H&R 没做满的种子不删，改成暂停，「暂停任务」页写明原因。选「暂停」时只暂停，可以在「暂停任务」页恢复或删除。
• 选择在推送时写进种子记录：之后改这条订阅的选择，只对之后推送的种子生效，已经在等到期处理的种子照推送时的选择处理。
• 种子先以暂停状态加入下载器，任务编号与到期处理登记好以后才开始下载（下载器设成不自动开始时保持暂停）。
• 站点没有给出免费结束时间的，只暂停加入，不自动开始。
• 计划暂停的时间（免费结束时间减去「免费期结束前提前处理」的分钟数）已经到了、或者一分钟内就到，也只暂停加入，不自动开始。
• 通知里的「立即下载」按这条订阅的下载器、路径和「免费结束时没下完」的选择推送。
• 到了处理时间，pt-tools 先重读记录：免费延长了就按新的时间处理；暂停以后回读下载器，状态确实是暂停才算成功。
• 暂停或删除失败会一直重试（30 秒起翻倍，最长 10 分钟一次）；连续失败 3 次起，向所有启用的通知通道发一次「免费结束暂停失败」告警。

选「不处理」的订阅，免费结束时不暂停也不删除；自动删种打开了「其他免费种子免费过了没下完就删」时，按它处理，见自动删种。

任务列表的「免费结束」列会显示「结束时间未知」「长期免费」，鼠标停在上面可以看到资格读取时间和计划暂停时间；「需要关注的任务」里会列出结束时间未知没推送、到期暂停一直失败的种子。

过滤规则

过滤规则在 规则 → 过滤规则 中创建，再关联到订阅：

• 匹配方式：关键词、通配符或正则，可以只匹配标题、只匹配标签，或者两者都匹配。
• 体积范围：最小和最大体积（GB），不能突破全局上限。
• 仅免费：开启后，这条规则只放行免费种子。
• 用途：控制下载、控制上新通知，或者两者都控制。

规则写好以后可以先试：过滤规则页的「试跑」里挑一条规则和一个数据源，点「试跑这条」，看它会命中哪些种子（只读，不推送也不写库）。数据源选一个 RSS 时现拉一次，每条种子取一次详情，和 RSS 任务一样按 RSS 里的标题匹配、按详情判断免费与大小；不选时用最近入库的种子记录（不联网）。结果弹窗里写明用的是哪个数据源，换一个马上重新试；编辑规则时弹窗里的「测试匹配」也一样。

语法和追剧示例见 过滤规则与追剧指南。

最佳实践

1. 合理设置间隔：不要设置过短的间隔（如小于 5 分钟），以免对站点服务器造成压力导致封号。建议 10 到 30 分钟。
2. 先测试后自动：关联规则前，先在过滤规则页面的「试跑」里选一个订阅现拉实时数据试一下；开启后观察运行日志，确认结果符合预期。
3. 利用站点自身的过滤：如果站点 RSS 生成器支持选择分类（如只选电影），优先在生成链接时过滤，减少本地处理压力。
4. 分类管理：为 RSS 下载的任务设置独立的下载器分类，方便后续自动化媒体库管理（如 Jellyfin）。
5. 保护 Passkey：在分享配置或截图时，务必打码 RSS 链接中的 passkey 或 apikey 参数。

常见问题排查

1. RSS 获取失败 (HTTP 403/401)

• 原因：认证失效或 Passkey 错误；站点前面的 Cloudflare 拦了这条线路时也回 403（提示里写明「被 Cloudflare 的质询拦了」）。
• 解决：检查链接中的 passkey 是否正确；如果是需要 Cookie 的站点，确认 pt-tools 中是否配置了有效的站点 Cookie。质询多是一时的，稍后再试；一直这样时在「全局设置」的「站点代理」里让这个站点走代理，见配置说明。

2. 获取成功但无种子

• 原因：RSS 链接本身没有返回内容，或者所有内容都被下载模式和过滤规则拦截了。
• 解决：
  • 在浏览器中直接打开 RSS 链接，看是否有 XML 内容返回。
  • 检查 rows 参数是否太小。
  • 检查下载模式：智能模式下关联了规则，就只下载匹配规则的种子。
  • 在运行日志中查看每个种子被跳过的原因。

3. 下载器无法添加任务

• 原因：下载器连接失败、路径不存在或权限不足。
• 解决：检查下载器配置连通性；确认下载路径在下载器所在的机器上真实存在且可写。

4. 下载种子文件失败（连接被重置、超时）

• 原因：到站点或它的下载节点的网络一时不通，走 Cloudflare 的站点常见。
• 处理：pt-tools 遇到这类错误与站点出错（5xx）会自动重试两次，所有站点都这样：间隔按指数退避（约 2 秒、4 秒，各加一点随机时长），每次重试前先等站点的限速；M-Team、NexusPHP 这类先取下载地址的只重拉那个地址。重试过的错误写明一共试了几次。还是失败时检查代理与网络；追剧与订阅会提前到 30 分钟以后再搜，见追剧与订阅。

5. 无法识别促销状态

• 原因：部分站点的 RSS 不直接包含促销信息，或者工具未适配该站点的特殊字段。
• 解决：尝试更新 pt-tools 到最新版本；或者依赖站点详情页抓取（如果支持）。

6. 找不到域名（no such host）

• 原因：链接里的域名查不到。最常见的是照着示例填了 hdsky.xxx 这类占位地址，示例里 xxx 的部分没有换成站点给你的地址；也可能是域名写错了，或者这台机器的 DNS 不通。
• 解决：到站点的 RSS 页重新复制链接，在站点页编辑这条 RSS、换上链接，点「试一下」确认能取到种子。