AyuCLouD-Services返回首页

Transmission RSS 怎么用?从 RSS 订阅到自动下载

更新于 2026-11-01 · ayu-ssr.buzz

简答:Transmission 本体负责接收和下载任务,RSS 工具负责读取订阅源与筛选,RPC 负责把符合条件的条目交给 Transmission。最快验证方法是:准备一个合法 RSS 地址和一个关键词,先确认 XML 中存在可下载链接,再配置 RPC,手动执行一次,最后检查 Transmission Web UI 是否出现任务且保存路径正确。

定义:Transmission RSS 自动下载,是由外部 RSS 工具读取订阅源、按关键词或正则筛选条目,再通过 Transmission RPC 提交 torrent 或磁力链接的组合方案。

先看结论:Transmission RSS 不是在 Web UI 里直接粘贴地址

先记住这句话:Transmission 负责下载,RSS 工具负责读取和筛选,RPC 负责把任务交给 Transmission。Transmission 官方文档将 RPC 定义为远程控制接口,当前默认 RPC URL 通常写作 http://host:9091/transmission/rpc,但端口和路径可以被修改,因此不能把它当成固定值使用。Transmission RPC Specification

如果你在 Transmission 界面中找不到完整的 RSS 订阅、关键词筛选或自动轮询入口,通常不是漏了某个按钮,而是需要搭配外部工具。可选方案包括 FlexGet、transmission-rss,以及面向特定媒体订阅流程的 ANI-RSS。它们的共同链路是:RSS 服务提供新条目,RSS 工具读取并筛选,工具调用 Transmission RPC,Transmission 负责下载、保存和继续上传。

Transmission RSS 方案速查
方案适合谁已核实能力需要注意
FlexGet需要关键词、正则、排除词和多任务规则官方文档提供 RSS 输入、Transmission 输出、配置校验和执行命令使用 YAML;配置字段应以当前插件文档和本机版本为准
transmission-rss希望轻量轮询 RSS 并提交任务仓库提供 RSS、正则、已见条目、RPC、定时运行和 Docker 示例仓库最新稳定发布信息与镜像标签需在部署前再次核对
ANI-RSS需要订阅管理、自动整理或媒体工作流项目仓库说明支持向 Transmission 等下载工具推送任务功能范围、安装方式和版本以项目文档为准

本文只讨论你有权获取的公开内容、播客、Linux ISO 或其他合法资源。RSS 工具不会替你判断资源是否合法,也不能保证链接长期有效或下载速度稳定。

3 分钟最小验证路径:先让一条任务进入 Transmission

  1. 准备一个合法 RSS 地址:用浏览器、RSS 阅读器或命令行打开地址,确认返回的是 XML,而不是登录页、403 页面或空白响应。
  2. 准备一个测试关键词:第一次只使用一个明确关键词,例如 Linux ISO。不要一开始就添加多个正则、排除词和自动整理规则。
  3. 确认 Transmission RPC:记录实际主机、端口、RPC 路径、用户名、密码和下载目录。当前 Transmission 配置文档列出的常见字段是 rpc_port、rpc_url、rpc_username、rpc_password 和 download_dir;这些是 Transmission 自己的配置字段,不等同于 RSS 工具字段。Transmission Editing Configuration Files
  4. 手动执行一次:让 RSS 工具读取一次订阅源,不要先设置后台定时运行。
  5. 检查 3 个成功标准:RSS 工具日志显示读取到条目;至少一条通过筛选;Transmission Web UI 出现任务,并且保存目录是预期路径。

如果 RSS 当前没有新条目,工具正常运行也可能不会添加任务。第一次测试应优先使用更新频率稳定、内容合法的 RSS 源;确认一条任务完整进入 Transmission 后,再增加定时执行和复杂筛选。

最短判断:任务没有出现在 Transmission,先查 RSS、规则和 RPC;任务已经出现但速度为 0,RSS 链路通常已经完成,应转向 tracker、peer、监听端口、DNS、MTU、丢包或资源本身排查。

前置条件:Transmission 配置文件、RPC 与下载目录怎么核对

Transmission 的配置位置取决于系统和运行方式。官方配置文件文档列出,Linux daemon 常见位置为用户目录下的 .config/transmission-daemon,Windows daemon 使用本地应用数据目录,macOS 使用应用支持目录;发行版启动脚本或第三方镜像也可能改变位置。不要只根据网上教程复制路径,应先确认当前进程的配置目录。Transmission Configuration Files

Transmission 4.1.0 开始逐步转向 snake_case 配置和 RPC 字段。官方说明旧的 kebab-case 仍可在 Transmission 4 中使用,但已标记为弃用,后续版本兼容性需要核对。因此要区分三类字段:

三类字段不要混用
位置示例用途
Transmission settings.jsondownload_dir、rpc_port、rpc_url控制 Transmission daemon 或客户端自身
Transmission RPC 请求download_dir、session_get、torrent_add远程读取设置或提交任务
RSS 工具配置由 FlexGet 或 transmission-rss 各自定义描述 RSS 地址、筛选规则和 RPC 连接

当前 RPC 文档列出的默认端口是 9091,默认 RPC URL 是 /transmission/,组合后的常见请求地址是 /transmission/rpc。但反向代理、端口映射、第三方镜像和多实例部署都可能改变实际值,所以应以当前配置或实际响应为准。RPC 还可能要求 X-Transmission-Session-Id;第一次请求收到 HTTP 409 时,客户端应读取响应头中的新值并重试。Transmission RPC Specification

远程 RPC 是管理接口,不建议直接暴露到公网。优先在本机或受控局域网内完成测试,启用认证并限制允许访问的地址。若通过反向代理访问,还要一并核对代理路径、Host 白名单和认证转发。

方案一:用 FlexGet 读取 RSS 并提交 Transmission

FlexGet 官方文档把任务拆成输入、筛选和输出三部分,RSS 插件负责读取订阅源,Transmission 插件负责把符合条件的条目提交给 Transmission。官方配置文档也建议修改后先运行 check,再执行任务。FlexGet Configuration FlexGet RSS Plugin FlexGet Transmission Plugin

1. Linux 上安装起步

FlexGet 官方 Linux 安装向导建议使用独立 Python virtualenv。下面只给出官方文档中的最短路径,适用于已安装 Python 3 的 Linux 环境:

python3 -m venv ~/flexget/

~/flexget/bin/pip install --upgrade pip setuptools

~/flexget/bin/pip install flexget

安装完成后可以直接调用 ~/flexget/bin/flexget,也可以先执行 source ~/flexget/bin/activate。Windows、macOS 和容器环境的安装方式不要直接套用这组 Linux 命令,应以对应平台文档为准。FlexGet Linux Install Wizard

2. 使用经过核对的最小配置结构

FlexGet 官方配置文档明确支持以 tasks 定义任务、以 rss 作为输入,并用 flexget check 校验 YAML。由于 Transmission 输出插件的认证和路径字段可能随 FlexGet 版本变化,下面只保留结构和占位字段;不要把未在当前安装版本文档中确认的参数直接复制到生产配置。

tasks:
rss_test:
rss: "https://example.org/feed.xml"
regexp:
accept:
- "Linux ISO"
reject:
- "sample"
transmission:
<按当前 FlexGet transmission 插件文档填写 RPC 与路径字段>

example.org、关键词和字段占位符只是示例。不要把 Transmission 的 download_dir、RPC 的字段名和 FlexGet 插件参数混写。先打开当前版本的 Transmission 插件文档,确认主机、端口、路径、认证和下载目录参数后,再填写。

3. 校验、试运行和正式执行

flexget check

校验通过后,可先用测试模式观察任务逻辑:

flexget --test execute --tasks rss_test

确认 RSS 条目和筛选结果正确后,再执行一次:

flexget execute --tasks rss_test

官方命令帮助还支持通过 flexget execute --help 查看当前版本可用参数。首次测试不要同时启用调度器、多个 RSS 地址和多个输出规则,避免无法判断是 RSS 无更新、筛选未命中还是 RPC 失败。

4. 定时运行

FlexGet 官方插件列表提供 scheduler,可在 daemon 模式下按间隔执行任务;也可以用系统计划任务。不同发行版的服务管理方式不同,因此本文不写死 systemd、cron 或 Windows 服务配置。先完成一次手动执行,再根据当前平台的任务调度器设置周期,并保留日志。

方案二:用 transmission-rss,配置字段与 Transmission 分开看

transmission-rss 项目仓库明确说明,它用于弥补 Transmission 不主动监测 RSS 的能力缺口,并提供 Ruby 安装、Docker、YAML 配置、systemd 和 cron 示例。仓库中的配置示例使用自己的字段,例如 feeds、regexp、download_dir、server.host、server.port、server.rpc_path 和 login;这些字段属于 transmission-rss,不是 Transmission 的 settings.json 字段。

最小 RSS 配置可以从下面结构开始,再按仓库当前示例补充 RPC 信息:

feeds:
- url: "https://example.org/feed.xml"
regexp: "Linux ISO"
update_interval: 600
server:
host: "127.0.0.1"
port: 9091
rpc_path: "/transmission/rpc"

上面的 RSS 地址、关键词、主机和端口均为占位值。仓库文档还说明,启用 Transmission HTTP Basic Authentication 时需要配置登录信息;已见条目记录也需要持久化,否则程序重启后可能无法按预期判断历史条目。项目仓库当前显示的最新稳定发布版本、Docker 标签和配置细节应在部署当天重新核实,本文不把它们当成长期不变的默认值。

仓库给出的 Docker 起步方式是挂载配置文件到容器内的 /etc/transmission-rss.conf。如果改写成 Compose,核心仍然只是同一个 bind mount:

services:
transmission-rss:
image: nning2/transmission-rss:v1.2.1
volumes:
- ./transmission-rss.conf:/etc/transmission-rss.conf:ro
restart: unless-stopped

这里的镜像标签来自项目仓库中的 Docker 示例,不代表当前仍是推荐版本;部署前应打开仓库确认标签是否仍存在。Compose 的 volumes 和服务配置语法可参考 Docker 官方文档。Docker Compose Services Reference Docker Compose Volumes Reference

如果 RSS 工具和 Transmission 在不同容器中,RSS 工具提交给 Transmission 的下载目录必须是 Transmission 容器能看到的路径。例如 Transmission 容器使用 /downloads,RSS 工具提交的也应是 Transmission 侧的 /downloads,不能填写只存在于 RSS 工具容器中的路径。两个容器还要确认 RPC 网络、目录挂载和 UID/GID 权限。

RSS XML 怎么判断 link、enclosure 和磁力链接字段

RSS 工具能否提交任务,取决于订阅源条目中是否存在可识别的下载链接。常见 XML 结构可能如下,字段名称只是脱敏示例,实际 RSS 必须以源站返回内容为准:

<item>
<title>Linux ISO 1.0</title>
<guid>unique-item-id</guid>
<link>https://example.org/files/linux.iso.torrent</link>
<enclosure url="https://example.org/files/linux.iso.torrent" type="application/x-bittorrent" />
</item>

检查方法是先保存 XML,再查看每个 item 内的 title、guid、link 和 enclosure。如果 link 指向的是详情页,而 enclosure 才是 torrent 文件,则工具必须支持或映射到 enclosure;如果条目包含磁力链接,可能会以 magnet: 开头,也可能被放在自定义字段中。

不同 RSS 工具对字段的读取方式不同:FlexGet 由 RSS 插件和具体输出插件处理条目字段,transmission-rss 则按自身仓库配置和解析逻辑工作。因此不要只看到 XML 中有 URL 就认为一定能下载。先用一个条目做手动测试,观察日志中最终提交给 Transmission 的 URL 类型。

若 RSS 返回需要登录的内容,浏览器能打开不代表 RSS 工具也能读取。还要核对 Cookie、HTTP Basic Authentication、请求头、证书验证和访问来源;没有对应工具文档支持时,不要自行猜测配置字段。

验证闭环:从 RSS 条目到磁盘文件逐层确认

  1. 验证 RSS:确认 HTTP 状态正常,响应正文是 XML,条目中存在新内容和可识别链接。
  2. 验证筛选:查看 RSS 工具日志,确认关键词、正则和排除词的判断结果。没有新增任务时,先暂时放宽规则。
  3. 验证 RPC:从 RSS 工具所在的主机或容器测试目标地址,不要只在宿主机浏览器中访问。核对主机、端口、RPC 路径、认证和 Host 白名单。
  4. 验证 Transmission:在 Web UI 中确认任务名称、状态、大小和下载目录。任务出现,说明 RSS 到 RPC 的提交链路已经完成。
  5. 验证文件:在 Transmission 实际运行环境中检查目录是否可写,确认临时文件和完成文件都能生成。

需要手工测试 RPC 时,可以使用官方 RPC 规范中的 JSON 请求思路。实际请求可能先收到 HTTP 409,并在响应头中返回新的 X-Transmission-Session-Id;客户端应保存该值后重试,而不是把 409 直接判断为端口关闭。Transmission RPC Specification

若任务已经添加但下载速度为 0,不要继续修改 RSS 正则。此时应按网络层次检查 tracker 响应、peer 数量、监听端口、NAT、DNS、MTU、丢包和资源是否仍有可用连接。

分层排错:RSS 无更新、RPC 失败和目录错误

Transmission RSS 常见问题排查表
现象先检查什么处理与回退
工具运行但没有任务RSS 是否有新条目、关键词是否匹配、是否被历史记录去重暂时只保留一个宽松关键词,手动执行一次;确认后再恢复排除词
RSS 地址打不开DNS、HTTPS、登录认证、响应是否为 XML从 RSS 工具所在环境测试;若返回登录页或 403,先处理访问条件
RPC connection refusedTransmission 是否运行、目标端口是否监听、容器网络是否正确核对实际 rpc_port 和映射关系;恢复到本机或局域网访问
HTTP 401 或认证失败用户名、密码、RPC 认证开关、路径和 Host 白名单重新读取当前 settings.json 或控制台设置;不要把密码提交到公开仓库
HTTP 409RPC 会话标识是否过期或缺失读取 X-Transmission-Session-Id 后重发原请求
任务已添加但目录错误提交的目录是否是 Transmission 侧可见路径改为 Transmission 内部绝对路径,并检查 Docker volume 映射
Permission denied目录属主、UID/GID、只读挂载和父目录权限先修复最小必要权限,再重试;不要长期开放过宽权限
重复添加任务GUID、链接、历史记录文件是否变化或未持久化启用工具的已见条目机制,并确认历史记录目录有持久化挂载
任务存在但速度为 0tracker、peer、监听端口、DNS、MTU、丢包和资源状态把问题从 RSS 层切换到 Transmission 网络排查,不要反复改订阅规则

Transmission 4.1.0 的 RPC 规范发生了 JSON-RPC 2.0 和 snake_case 变化,旧协议和旧字段在 Transmission 4 中仍可能兼容,但官方已标记为弃用。升级或更换镜像后,应使用当前版本的 RPC 规范、session_get 返回值和实际日志核对字段,不要把旧教程中的 kebab-case 参数直接复制到新配置。Transmission RPC 版本变化说明

边界与延伸:RSS 自动化解决什么,不解决什么

RSS 自动化解决的是“发现新条目、筛选条目并提交下载任务”。它不保证 RSS 源持续更新、不保证链接始终有效、不保证 tracker 可用,也不保证下载速度。任务已经出现在 Transmission 后,RSS 工具通常不再是主要故障点。

如果你使用 Docker,优先按四层检查:第一层是容器之间能否访问 RPC;第二层是 RSS 工具提交的路径是否被 Transmission 容器看到;第三层是目录权限和持久化;第四层才是任务本身的 tracker、peer 和网络连接。修改前记录原配置,失败时先停止定时任务或 RSS 守护进程,保留 Transmission 当前任务,恢复 RPC、目录和权限后再一次启用一条规则。

如果你只想完成一次自动下载,建议先选 transmission-rss 或 FlexGet 中自己能看懂的一种,不要同时部署多个 RSS 工具。若需要复杂的媒体订阅、整理和刮削,再单独评估 ANI-RSS,并以项目当前文档核对安装方式、下载器设置和版本兼容性。

如果 RSS 已能推送任务,但跨网络访问、DNS、MTU、丢包或远程 RPC 连接不稳定,可把问题拆成“客户端、RPC、网络、资源”四层后再做连接排查。

常见问题

Transmission 能直接订阅 RSS 吗?

Transmission 本体主要负责下载和远程控制,通常需要搭配 FlexGet、transmission-rss 或其他外部工具读取 RSS、筛选条目,再通过 RPC 提交任务。是否存在额外界面功能,应以当前客户端和版本为准。

Transmission RSS 应该选 FlexGet 还是 transmission-rss?

需要复杂关键词、正则、排除词和多任务逻辑时,可以先评估 FlexGet;只想定时读取 RSS 并提交到 Transmission 时,可以先评估 transmission-rss。两者的配置字段、安装方式和版本兼容性不能混用,应分别查看当前项目文档。

RSS 工具显示运行成功,但 Transmission 没有任务,怎么办?

按顺序检查 RSS 是否真的有新条目、规则是否命中、RSS 工具所在环境能否访问 RPC、路径和认证是否正确,以及日志中是否出现 HTTP 409、401 或权限错误。任务尚未进入 Transmission 前,不要先排查下载速度。

RSS XML 里有 link,为什么仍然不能下载?

link 可能只是详情页,真正的 torrent 文件或磁力链接可能位于 enclosure 或自定义字段中。查看 XML 的 title、guid、link 和 enclosure,确认 RSS 工具实际提交的是 torrent 文件 URL 或 magnet 链接;不同工具的字段映射不同,不能仅凭一个 URL 判断可用。

Docker 里最容易把 Transmission RSS 配错的地方是什么?

最常见是路径映射不一致。RSS 工具提交的下载目录必须是 Transmission 容器内部能看到的路径,而不是只存在于 RSS 容器中的路径;同时要检查两个容器之间的 RPC 网络、配置文件挂载和目录 UID/GID 权限。

Transmission 4.1.x 的字段为什么和旧教程不一样?

Transmission 官方说明,4.1.0 开始逐步转向 snake_case,并引入新的 JSON-RPC 2.0 处理方式。旧字段在部分 Transmission 4 环境中可能仍兼容,但已被标记为弃用;升级后应以当前 RPC 规范和实际配置为准。

相关阅读

参考资料

  1. Transmission Configuration Files:配置目录与 settings.json 位置
  2. Transmission Editing Configuration Files:RPC、下载目录与 snake_case 配置
  3. Transmission RPC Specification:RPC 地址、会话标识与协议变化
  4. FlexGet Configuration:YAML 配置、check 与 execute
  5. FlexGet RSS Plugin:RSS 输入配置
  6. FlexGet Transmission Plugin:向 Transmission 输出任务
  7. FlexGet Linux Install Wizard:virtualenv 安装路径
  8. transmission-rss:RSS 轮询、筛选、RPC、Docker 与定时运行示例
  9. ANI-RSS:RSS 订阅与向 Transmission 推送任务
  10. Docker Compose Services Reference:服务、环境变量与挂载配置
  11. Docker Compose Volumes Reference:卷与多容器共享路径