nning2/transmission-rss

transmission-rss

镜像概述

transmission-rss是一款用于弥补Transmission缺乏RSS订阅源监控功能的工具，能够自动从RSS订阅源中提取并添加种子链接至Transmission。它适用于transmission-daemon以及启用了Web前端的transmission-gtk，可对接showrss.karmorra.info、ezrss.it等公共RSS源或自托管的seriesly实例。此外，还包含transmission-add-file工具，用于批量添加种子文件。

核心功能与特性

• RSS监控与自动添加：持续监控指定RSS订阅源，自动提取并添加种子链接至Transmission
• 灵活的订阅源配置：支持为每个订阅源设置正则表达式过滤、下载路径、种子比率限制及证书验证
• 多场景适配：兼容transmission-daemon和启用Web前端的transmission-gtk
• 批量添加支持：集成transmission-add-file工具，实现种子文件批量导入
• 丰富的配置选项：支持Transmission服务器连接参数、HTTP基本认证、日志管理、权限控制等
• 多种运行模式：支持后台守护进程模式、单次运行模式及Docker容器化部署

使用场景

• 自动获取并下载电视节目、播客等定期更新的内容
• 监控特定资源站点的RSS源，及时获取新发布的种子
• 管理多个RSS订阅源，按规则分类下载至不同目录
• 配合Transmission实现无人值守的种子下载管理

使用方法与配置说明

镜像拉取

sh
docker pull nning2/transmission-rss:v1.0.0

基本运行命令

sh
docker run -t \
  -v $(pwd)/transmission-rss.conf:/etc/transmission-rss.conf \
  nning2/transmission-rss:v1.0.0

配置文件说明

配置文件采用YAML格式，默认路径为/etc/transmission-rss.conf。用户可通过挂载自定义配置文件覆盖默认设置。

最小配置示例

至少需包含订阅源列表：

yaml
feeds:
  - url: http://example.com/feed1
  - url: http://example.com/feed2

常用配置示例

标题过滤：通过正则表达式过滤订阅源项目标题

yaml
feeds:
  - url: http://example.com/feed1
    regexp: foo
  - url: http://example.com/feed2
    regexp: (foo|bar)

指定下载路径：为特定订阅源设置下载目录

yaml
feeds:
  - url: http://example.com/feed1
    download_path: /home/user/Downloads

种子比率限制：设置种子分享比率限制（0表示无限制）

yaml
feeds:
  - url: http://example.com/feed1
    seed_ratio_limit: 0

证书验证：禁用自签名证书验证

yaml
feeds:
  - url: http://example.com/feed1
    validate_cert: false

完整配置选项

以下示例包含所有可用配置项（update_interval、add_paused等为默认值，可省略）：

yaml
feeds:
  - url: http://example.com/feed1
  - url: http://example.com/feed2
  - url: http://example.com/feed3
    regexp: match1  # 单正则匹配
  - url: http://example.com/feed4
    regexp: (match1|match2)  # 多条件正则匹配
  - url: http://example.com/feed5
    download_path: /home/user/Downloads  # 指定下载路径
  - url: http://example.com/feed6
    seed_ratio_limit: 1  # 种子比率限制
  - url: http://example.com/feed7
    regexp:  # 多正则规则
      - match1
      - match2
  - url: http://example.com/feed8
    regexp:  # 带路径的多正则规则
      - matcher: match1
        download_path: /home/user/match1
      - matcher: match2
        download_path: /home/user/match2
  - url: http://example.com/feed9
    validate_cert: false  # 禁用证书验证

update_interval: 600  # 检查间隔（秒）
add_paused: false  # 是否暂停添加的种子

server:  # Transmission服务器配置
  host: localhost
  port: 9091
  tls: false
  rpc_path: /transmission/rpc

login:  # HTTP基本认证（如Transmission启用需配置）
  username: transmission
  password: transmission

log:  # 日志配置
  target: /var/log/transmissiond-rss.log  # 日志目标（默认STDERR）
  level: debug  # 日志级别

privileges:  # 运行权限（默认当前用户）
  user: nobody
  group: nobody

client:  # 客户端配置
  timeout: 5  # 超时时间（秒）

fork: false  # 是否后台运行
single: false  # 是否单次运行
pid_file: false  # PID文件路径（false表示不生成）
seen_file: ~/.config/transmission/seen  # 已处理项目记录文件

后台运行配置

Systemd服务

创建系统服务文件/etc/systemd/system/transmission-rss.service：

ini
[Unit]
Description=Transmission RSS daemon.
After=network.target transmission-daemon.service

[Service]
Type=forking
ExecStart=/usr/local/bin/transmission-rss -f  # -f表示后台运行
ExecReload=/bin/kill -s HUP $MAINPID

[Install]
WantedBy=multi-user.target

启用并启动服务：

sh
systemctl daemon-reload
systemctl start transmission-rss
systemctl enable transmission-rss  # 设置开机自启

Cron任务

使用单次运行模式（-s参数）配合cron定期执行，例如每10分钟检查一次：

sh
*/10 * * * * /usr/local/bin/transmission-rss -s