daghaian/nzbthrottle

nzbthrottle

概述

nzbthrottle是一款动态带宽控制工具，旨在当用户从Plex主动流媒体播放时，自动调整下载带宽分配，避免不必要的缓冲问题，同时仍允许用户以尽可能快的速率进行下载。

核心功能

• 实时监控Plex的活跃流媒体播放状态
• 根据活跃流数量动态调整NZBGet的下载速度
• 支持***、***等多种通知服务，可推送状态变更信息
• 可配置不同活跃流数量对应的节流速度及取消节流时的最大下载速度

使用场景

• 家庭媒体服务器用户：家人或自己在Plex观看视频时，自动降低NZBGet下载速度，确保播放流畅无缓冲
• 平衡下载与流媒体体验的用户：无需手动调整，工具自动适配当前使用场景

配置说明

前提条件

直接运行脚本需Python 3.5及以上版本；使用Docker容器无需额外安装依赖。

配置步骤

1. 复制config_example.json并重命名为config.json
2. 编辑config.json填入对应凭据及参数，示例配置如下：

json
{
  "plex": {
    "url": "http://localhost:32400",
    "interval": 60,
    "token": "your_plex_token"
  },
  "nzbget": {
    "username": "nzbget_user",
    "password": "nzbget_pass",
    "url": "http://localhost:6789",
    "speeds": {
      "1": 5000,
      "2": 4000,
      "3": 3000,
      "4": 2000,
      "5": 1000
    },
    "max_speed": 80000
  },
  "notifications": {
    "Discord": { "enabled": false, "url": "discord://webhook_id/webhook_token" },
    "Telegram": { "enabled": false, "url": "tgram://bottoken/ChatID" }
  }
}

3. 参数说明：
   • Plex：url为Plex服务器地址，interval为检查活跃流的时间间隔（秒），token为Plex访问令牌
   • NZBGet：username/password为NZBGet登录凭据，url为客户端地址，speeds为不同活跃流对应的节流速度（kB/s），max_speed为取消节流时的最大速度（kB/s，0表示无限制）
   • Notifications：enabled控制服务启用状态，url为对应服务的配置链接（格式参考https://github.com/caronc/apprise%EF%BC%89

部署与使用

Docker容器部署

bash
docker run --name nzbthrottle -d -v /本地路径/config.json:/nzbthrottle/config.json docker.xuanyuan.run/daghaian/nzbthrottle

（替换/本地路径/config.json为实际配置文件路径）

手动运行脚本

bash
python throttle.py [--log-level=['DEBUG','INFO','WARN']]

作为服务运行

将nzbthrottle.service文件复制到系统服务目录（如/etc/systemd/system/），修改ExecStart路径为脚本实际位置，再通过systemd管理服务。