核心用法
SABnzbd 技能提供完整的 Usenet 下载管理功能,通过调用 SABnzbd 本地 REST API 实现队列监控与操作。核心能力包括:
队列管理:查看完整队列状态、按分类/优先级筛选、获取特定任务详情;支持暂停/恢复全部或单个任务,删除任务(可选保留文件),以及清空队列。
NZB 添加:支持三种方式——通过索引站 URL 直接添加、上传本地 NZB 文件、并可指定下载名称、分类(tv/movies 等)及六级优先级(force/high/normal/low/paused/duplicate)。
速度控制:灵活设置下载限速,支持百分比(如 50%)、绝对速度(如 5MB/s)或解除限制。
历史管理:查看下载历史、筛选失败任务、重试单条或全部失败任务,清理历史记录。
分类与脚本:查看并修改任务分类,配置 post-processing 脚本(如 notify.py)。
状态监控:获取服务器版本、下载统计、警告信息等完整状态。
显著优点
- 功能全面:覆盖 SABnzbd 核心 API 的全部操作场景,无需打开 Web UI
- 本地化优先:直接对接本地运行的 SABnzbd 实例,延迟极低
- 灵活配置:支持 NZB URL、本地文件双模式添加,优先级与分类精细控制
- 批量操作:支持队列/历史的批量筛选与重试,提升管理效率
潜在局限
- 网络依赖:需 SABnzbd 服务可访问,远程场景需配合 VPN/反向代理
- 配置门槛:需手动配置 API key 和 URL,对新手有一定学习成本
- 无内置索引:仅管理下载客户端,不直接对接 NZB 索引站搜索
- 脚本安全风险:change-script 功能可执行任意 Python 脚本,需警惕恶意脚本
适合人群
Usenet 重度用户、自动化下载爱好者、需要 CLI/自动化管理 SABnzbd 的技术用户,以及配合 Sonarr/Radarr 等 *arr 生态进行下载后处理的管理员。
常规风险
- API 密钥泄露:config.json 中的 API key 若被窃取可导致下载队列被恶意操控
- 本地网络暴露:SABnzbd 默认 HTTP 无加密,公网暴露存在中间人攻击风险
- 下载内容合规:Usenet 内容版权状况复杂,用户需自行承担合规责任
- 误操作数据丢失:delete --files 和 purge 操作不可逆,可能误删已下载数据