itschasa/speedrr

镜像概述

speedrr 是一个用于动态管理 torrent 客户端上传速度的工具，特别集成了 Plex 和 Jellyfin 媒体服务器。它能够根据媒体服务器的流媒体活动自动调整 torrent 上传速度，平衡下载任务与媒体播放的带宽需求，提升家庭媒体服务体验。

核心功能与特性

• 动态速度调整：根据 Plex/Jellyfin 的实时流媒体状态，自动升降 torrent 客户端的上传速度限制
• 媒体服务器集成：原生支持 Plex 和 Jellyfin，可直接监控媒体播放活动
• 多客户端支持：兼容主流 torrent 客户端（如 qBittorrent、Deluge 等）
• 自定义配置：允许用户设置常规上传速度限制及流媒体时的限制值
• 轻量部署：通过 Docker 容器化部署，配置简单，易于集成到现有媒体服务架构

使用场景与适用范围

• 家庭媒体服务器用户：同时运行 torrent 客户端（如下载媒体文件）和 Plex/Jellyfin（提供流媒体服务）的场景
• 带宽资源有限的环境：需要在 torrent 上传与媒体流播放间动态分配带宽，避免播放卡顿
• 自动化管理需求：希望减少手动调整 torrent 速度的操作，实现智能化带宽管理

使用方法与配置说明

环境变量配置

Docker 部署示例

基本 Docker Run 命令

bash
docker run -d \
  --name speedrr \
  -e PLEX_URL=http://192.168.1.100:32400 \
  -e PLEX_TOKEN=your_plex_token_here \
  -e TORRENT_CLIENT_TYPE=qbittorrent \
  -e TORRENT_CLIENT_URL=http://192.168.1.100:8080 \
  -e TORRENT_CLIENT_PASSWORD=your_qb_password \
  -e UPLOAD_LIMIT_REGULAR=10M \
  -e UPLOAD_LIMIT_STREAMING=2M \
  --restart unless-stopped \
  itschasa/speedrr

Docker Compose 配置

yaml
version: '3.8'
services:
  speedrr:
    image: itschasa/speedrr
    container_name: speedrr
    environment:
      - PLEX_URL=http://plex:32400  # 假设 Plex 服务名为 "plex"
      - PLEX_TOKEN=your_plex_token_here
      - TORRENT_CLIENT_TYPE=qbittorrent
      - TORRENT_CLIENT_URL=http://qbittorrent:8080  # 假设 qBittorrent 服务名为 "qbittorrent"
      - TORRENT_CLIENT_USER=admin
      - TORRENT_CLIENT_PASSWORD=secure_password
      - UPLOAD_LIMIT_REGULAR=15M
      - UPLOAD_LIMIT_STREAMING=3M
      - CHECK_INTERVAL=45
    restart: unless-stopped
    # 如需网络互通，可加入与 Plex/torrent 客户端相同的网络
    # networks:
    #   - media_network

# networks:
#   media_network:
#     external: true

注意事项

• 确保 Plex/Jellyfin 与 torrent 客户端的网络互通，容器需能访问对应服务的 API 接口
• Plex 令牌获取方式：在 Plex Web 界面中，进入「设置 > 远程访问」，通过高级选项获取或使用第三方工具提取
• Jellyfin API 密钥生成：在 Jellyfin 管理界面「仪表板 > API 密钥」中创建
• 速度单位支持 K（KB/s）和 M（MB/s），如 512K 表示 512KB/s，2M 表示 2MB/s