如何为Bookshelf搭配SABnzbd与qBittorrent等15种下载客户端

原创2026-10-26 21:08:551,897 阅读

如何为Bookshelf搭配SABnzbd与qBittorrent等15种下载客户端

Bookshelf(代号 Readarr)是一款自动收集与整理书籍的开源工具,真正让"书库自动化"落地的关键一步,就是为它搭配下载客户端。本文带你快速掌握 Bookshelf 内置的全部 15 种下载客户端:从 Usenet 阵营的 SABnzbd、NZBGet,到 BitTorrent 阵营的 qBittorrent、uTorrent,涵盖默认端口、必填参数、优先级策略与故障排查,零基础也能一次配好。

Bookshelf下载客户端错误排查提示图

先搞懂:Bookshelf 如何与下载客户端协作

整个流程其实是一条流水线:

  1. 搜索:Bookshelf 通过 Indexer(索引站)找到书籍资源;
  2. 抓取:决定下载后,把 .nzb 或 .torrent 交给下载客户端;
  3. 监控:客户端下载完成后,Bookshelf 自动检测到文件;
  4. 导入:按命名规则整理入库,并可选地让客户端继续做种。

其中第 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,若两者部署在同一台机器,请记得修改其中一方的端口。

一键添加下载客户端的通用步骤

无论选择哪种客户端,界面操作流程完全一致:

  1. 登录 Bookshelf,进入 设置(Settings) → 下载客户端(Download Clients) 页面;
  2. 点击右上角 Add,弹出添加窗口,按 Usenet / Torrents 分组挑选客户端;
  3. 填入主机地址(Host)、端口(Port)与认证信息;
  4. 点击 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% 的问题:

  1. 连接被拒绝:核对 Host/Port,确认客户端的 Web 服务已开启且防火墙放行;
  2. 认证失败:SABnzbd 确认用的是 API Key(不是 Web 密码);qBittorrent 确认是 Web UI 账号;
  3. 反向代理 404:检查是否需要填写 Url Base;
  4. 下载完成却不导入:确认 Bookshelf 的媒体库路径与客户端实际保存路径一致;
  5. 跨机器部署:若客户端运行在另一台主机,需在 Remote Path Mappings 中映射路径,界面位于 RemotePathMappings.js;
  6. Vuze 提示协议版本过低:需使用 5.0.0.0 以上版本并安装 Web Remote 插件,见 Vuze.cs。

相关源码与模块路径

配好下载客户端后,别忘了到 设置 → 索引站 中启用对应的资源来源——索引站负责"找",下载客户端负责"拿",两者齐备,Bookshelf 才能真正实现书籍的无人值守入库。📚

登录后查看全文
bookshelf