如何为Bookshelf搭配SABnzbd与qBittorrent等15种下载客户端
如何为Bookshelf搭配SABnzbd与qBittorrent等15种下载客户端
Bookshelf(代号 Readarr)是一款自动收集与整理书籍的开源工具,真正让"书库自动化"落地的关键一步,就是为它搭配下载客户端。本文带你快速掌握 Bookshelf 内置的全部 15 种下载客户端:从 Usenet 阵营的 SABnzbd、NZBGet,到 BitTorrent 阵营的 qBittorrent、uTorrent,涵盖默认端口、必填参数、优先级策略与故障排查,零基础也能一次配好。
先搞懂:Bookshelf 如何与下载客户端协作
整个流程其实是一条流水线:
- 搜索:Bookshelf 通过 Indexer(索引站)找到书籍资源;
- 抓取:决定下载后,把
.nzb或.torrent交给下载客户端; - 监控:客户端下载完成后,Bookshelf 自动检测到文件;
- 导入:按命名规则整理入库,并可选地让客户端继续做种。
其中第 2、3 步完全由 Bookshelf 内置的客户端驱动完成,源码统一位于 src/NzbDrone.Core/Download/Clients/ 目录。选择哪种协议(Usenet 或 BitTorrent)取决于你使用的资源站类型。
Bookshelf 支持的 15 种下载客户端速查表
Bookshelf 的"添加下载客户端"界面会把全部客户端按 Usenet 和 Torrents 两组展示(见 AddDownloadClientModalContent.js),默认端口均已在设置类中预填好:
| 客户端 | 协议 | 默认端口 | 认证方式 |
|---|---|---|---|
| SABnzbd | Usenet | 8080 | API Key 或 用户名/密码 |
| NZBGet | Usenet | 6789 | 用户名/密码 |
| NZBVortex | Usenet | 4321 | API Key 或 用户名/密码 |
| Pneumatic | Usenet | — | 仅需配置文件夹路径 |
| Usenet Blackhole | Usenet | — | 文件夹"黑洞"方式 |
| qBittorrent | BitTorrent | 8080 | 用户名/密码 |
| Deluge | BitTorrent | 8112 | 用户名/密码 |
| Transmission | BitTorrent | 9091 | 用户名/密码 |
| Vuze | BitTorrent | 与 Transmission 相同 | 用户名/密码 |
| rTorrent | BitTorrent | 8080 | 用户名/密码 |
| uTorrent | BitTorrent | 8080 | 用户名/密码 |
| Flood | BitTorrent | 3000 | 用户名/密码 |
| Aria2 | BitTorrent | 6800 | Secret token |
| Hadouken | BitTorrent | 7070 | 用户名/密码 |
| Download Station | 两者皆可 | 5000 | 用户名/密码 |
| Torrent Blackhole | BitTorrent | — | 文件夹"黑洞"方式 |
💡 小提醒:SABnzbd 与 qBittorrent 的默认 Web 端口恰好都是 8080,若两者部署在同一台机器,请记得修改其中一方的端口。
一键添加下载客户端的通用步骤
无论选择哪种客户端,界面操作流程完全一致:
- 登录 Bookshelf,进入 设置(Settings) → 下载客户端(Download Clients) 页面;
- 点击右上角 Add,弹出添加窗口,按 Usenet / Torrents 分组挑选客户端;
- 填入主机地址(Host)、端口(Port)与认证信息;
- 点击 Test 验证连接,成功后保存即可。
该页面还提供 Test All Clients 与 Manage 按钮,可批量检测所有客户端连通性,并调整启用状态与标签,前端实现位于 DownloadClientSettings.js。
SABnzbd 配置要点:Usenet 首选
SABnzbd 是 Usenet 用户的事实标准,其设置项定义在 SabnzbdSettings.cs:
- Host / Port:默认
localhost:8080,跨机器部署时改成对应 IP; - API Key:在 SABnzbd 后台的 Settings → API Keys 中生成,与"用户名/密码"二选一即可;
- Category:默认为
Readarr,强烈建议在 SABnzbd 中创建同名分类,避免与其他下载任务混淆; - Recent Priority / Older Priority:可分别为"近 14 天发布"和"更早发布"的书籍设置不同下载优先级;
- Url Base:当 SABnzbd 挂在反向代理子路径下时(如
http://host:8080/sab/api)才需要填写。
qBittorrent 配置要点:BitTorrent 首选
qBittorrent 的设置项定义在 QBittorrentSettings.cs,Bookshelf 会自动适配其 Web API 的 V1 / V2 两套版本:
- Host / Port:默认
localhost:8080,需在 qBittorrent 的 选项 → Web UI 中开启远程控制; - Username / Password:Web UI 登录账号密码;
- Category:默认
readarr,建议保留以区分其他下载任务; - Post-Import Category(高级项):导入后可自动换到做种专用分类,配合"不删除已完成任务"可实现持续做种;
- Initial State:可控制新任务默认是暂停还是直接开始;
- Sequential Order / First and Last First:按需调整分片下载顺序(需 qBittorrent 4.1.0+)。
多客户端如何被选择:优先级与轮换机制
当你同时配置了多个下载客户端(例如 SABnzbd 管 Usenet、qBittorrent 管种子),Bookshelf 的选择逻辑在 DownloadClientProvider.cs 中:
- 每个客户端可按 协议 分别路由:
.nzb只走 Usenet 客户端,种子只走 BitTorrent 客户端; - 同协议下支持设置 Priority,数值小的优先使用;
- 同一优先级内自动轮换(round-robin),方便多台下载机负载均衡;
- 某客户端近期连续失败会被临时屏蔽一段时间,避免反复撞墙;
- 也可给客户端打 Tags,让特定作者的资源只走指定客户端。
每个客户端"删除已完成/失败任务"等开关,则由 DownloadClientDefinition.cs 统一描述。
常见故障与排查清单
遇到"Test 失败"或任务卡住时,按下面顺序排查通常能解决 90% 的问题:
- 连接被拒绝:核对 Host/Port,确认客户端的 Web 服务已开启且防火墙放行;
- 认证失败:SABnzbd 确认用的是 API Key(不是 Web 密码);qBittorrent 确认是 Web UI 账号;
- 反向代理 404:检查是否需要填写 Url Base;
- 下载完成却不导入:确认 Bookshelf 的媒体库路径与客户端实际保存路径一致;
- 跨机器部署:若客户端运行在另一台主机,需在 Remote Path Mappings 中映射路径,界面位于 RemotePathMappings.js;
- Vuze 提示协议版本过低:需使用 5.0.0.0 以上版本并安装 Web Remote 插件,见 Vuze.cs。
相关源码与模块路径
- 全部客户端驱动:src/NzbDrone.Core/Download/Clients/
- 客户端选择与轮换逻辑:DownloadClientProvider.cs
- SABnzbd 驱动:SabnzbdProxy.cs
- qBittorrent 驱动:QBittorrent.cs
- 前端设置页:frontend/src/Settings/DownloadClients/
配好下载客户端后,别忘了到 设置 → 索引站 中启用对应的资源来源——索引站负责"找",下载客户端负责"拿",两者齐备,Bookshelf 才能真正实现书籍的无人值守入库。📚
