Transmission RSS 怎么用?从 RSS 订阅到自动下载
简答: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 负责下载、保存和继续上传。
| 方案 | 适合谁 | 已核实能力 | 需要注意 |
|---|---|---|---|
| FlexGet | 需要关键词、正则、排除词和多任务规则 | 官方文档提供 RSS 输入、Transmission 输出、配置校验和执行命令 | 使用 YAML;配置字段应以当前插件文档和本机版本为准 |
| transmission-rss | 希望轻量轮询 RSS 并提交任务 | 仓库提供 RSS、正则、已见条目、RPC、定时运行和 Docker 示例 | 仓库最新稳定发布信息与镜像标签需在部署前再次核对 |
| ANI-RSS | 需要订阅管理、自动整理或媒体工作流 | 项目仓库说明支持向 Transmission 等下载工具推送任务 | 功能范围、安装方式和版本以项目文档为准 |
本文只讨论你有权获取的公开内容、播客、Linux ISO 或其他合法资源。RSS 工具不会替你判断资源是否合法,也不能保证链接长期有效或下载速度稳定。
3 分钟最小验证路径:先让一条任务进入 Transmission
- 准备一个合法 RSS 地址:用浏览器、RSS 阅读器或命令行打开地址,确认返回的是 XML,而不是登录页、403 页面或空白响应。
- 准备一个测试关键词:第一次只使用一个明确关键词,例如
Linux ISO。不要一开始就添加多个正则、排除词和自动整理规则。 - 确认 Transmission RPC:记录实际主机、端口、RPC 路径、用户名、密码和下载目录。当前 Transmission 配置文档列出的常见字段是
rpc_port、rpc_url、rpc_username、rpc_password和download_dir;这些是 Transmission 自己的配置字段,不等同于 RSS 工具字段。Transmission Editing Configuration Files - 手动执行一次:让 RSS 工具读取一次订阅源,不要先设置后台定时运行。
- 检查 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.json | download_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 条目到磁盘文件逐层确认
- 验证 RSS:确认 HTTP 状态正常,响应正文是 XML,条目中存在新内容和可识别链接。
- 验证筛选:查看 RSS 工具日志,确认关键词、正则和排除词的判断结果。没有新增任务时,先暂时放宽规则。
- 验证 RPC:从 RSS 工具所在的主机或容器测试目标地址,不要只在宿主机浏览器中访问。核对主机、端口、RPC 路径、认证和 Host 白名单。
- 验证 Transmission:在 Web UI 中确认任务名称、状态、大小和下载目录。任务出现,说明 RSS 到 RPC 的提交链路已经完成。
- 验证文件:在 Transmission 实际运行环境中检查目录是否可写,确认临时文件和完成文件都能生成。
需要手工测试 RPC 时,可以使用官方 RPC 规范中的 JSON 请求思路。实际请求可能先收到 HTTP 409,并在响应头中返回新的 X-Transmission-Session-Id;客户端应保存该值后重试,而不是把 409 直接判断为端口关闭。Transmission RPC Specification
若任务已经添加但下载速度为 0,不要继续修改 RSS 正则。此时应按网络层次检查 tracker 响应、peer 数量、监听端口、NAT、DNS、MTU、丢包和资源是否仍有可用连接。
分层排错:RSS 无更新、RPC 失败和目录错误
| 现象 | 先检查什么 | 处理与回退 |
|---|---|---|
| 工具运行但没有任务 | RSS 是否有新条目、关键词是否匹配、是否被历史记录去重 | 暂时只保留一个宽松关键词,手动执行一次;确认后再恢复排除词 |
| RSS 地址打不开 | DNS、HTTPS、登录认证、响应是否为 XML | 从 RSS 工具所在环境测试;若返回登录页或 403,先处理访问条件 |
| RPC connection refused | Transmission 是否运行、目标端口是否监听、容器网络是否正确 | 核对实际 rpc_port 和映射关系;恢复到本机或局域网访问 |
| HTTP 401 或认证失败 | 用户名、密码、RPC 认证开关、路径和 Host 白名单 | 重新读取当前 settings.json 或控制台设置;不要把密码提交到公开仓库 |
| HTTP 409 | RPC 会话标识是否过期或缺失 | 读取 X-Transmission-Session-Id 后重发原请求 |
| 任务已添加但目录错误 | 提交的目录是否是 Transmission 侧可见路径 | 改为 Transmission 内部绝对路径,并检查 Docker volume 映射 |
| Permission denied | 目录属主、UID/GID、只读挂载和父目录权限 | 先修复最小必要权限,再重试;不要长期开放过宽权限 |
| 重复添加任务 | GUID、链接、历史记录文件是否变化或未持久化 | 启用工具的已见条目机制,并确认历史记录目录有持久化挂载 |
| 任务存在但速度为 0 | tracker、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 规范和实际配置为准。
相关阅读
- 先配置 Transmission Web UI 与远程访问
- 查看 Transmission Docker 的路径、端口和网络排查
- 核对 Transmission RPC 端口与连接设置
- 排查 Transmission 下载无速度和端口问题
- 回到 Transmission torrent 基础使用与下载验证
参考资料
- Transmission Configuration Files:配置目录与 settings.json 位置
- Transmission Editing Configuration Files:RPC、下载目录与 snake_case 配置
- Transmission RPC Specification:RPC 地址、会话标识与协议变化
- FlexGet Configuration:YAML 配置、check 与 execute
- FlexGet RSS Plugin:RSS 输入配置
- FlexGet Transmission Plugin:向 Transmission 输出任务
- FlexGet Linux Install Wizard:virtualenv 安装路径
- transmission-rss:RSS 轮询、筛选、RPC、Docker 与定时运行示例
- ANI-RSS:RSS 订阅与向 Transmission 推送任务
- Docker Compose Services Reference:服务、环境变量与挂载配置
- Docker Compose Volumes Reference:卷与多容器共享路径