4大下载客户端配置对比:Listenarr接入qBittorrent、Transmission、SABnzbd与NZBGet实战
4大下载客户端配置对比:Listenarr接入qBittorrent、Transmission、SABnzbd与NZBGet实战
Listenarr 是一款类似 Sonarr / Radarr 的有声书(Audiobook)自动收集管理系统,它可以基于 Audible 等元数据源自动搜索、下载并整理你的有声书库。系统的自动化能力离不开下载客户端的配合——官方内置支持 qBittorrent、Transmission、SABnzbd、NZBGet 四大客户端,覆盖 Torrent 与 Usenet 两种下载协议。本文通过实战对比,带你一次搞懂四者的配置差异与选型思路,快速完成 Listenarr 下载客户端接入。
下载客户端怎么选:Torrent vs Usenet 速览
四种客户端在协议、默认端口和认证方式上各不相同,先看清楚差异再动手,能少走很多弯路:
| 客户端 | 协议 | 默认端口 | 认证方式 | 适用场景 |
|---|---|---|---|---|
| qBittorrent | Torrent | 8080(Web UI) |
用户名 / 密码 | 最主流的 BT 客户端,功能全、可选项多 |
| Transmission | Torrent | 9091(RPC,非 Web 端口) |
用户名 / 密码 | 轻量、NAS 常见;seedbox 常用 |
| SABnzbd | Usenet | 8080(Web 界面) |
API Key | Usenet 首选,配置省心 |
| NZBGet | Usenet | 6789(Web 界面) |
用户名 / RPC 密码 | 高性能 Usenet,偏极客 |
💡 简单决策:有 BT 资源渠道选 qBittorrent(或 NAS 上已有 Transmission);走 Usenet 索引站选 SABnzbd,追求极致性能再考虑 NZBGet。
四类客户端的类型定义见 DownloadClientTypes.cs,后端的四个适配器分别位于 QbittorrentAdapter.cs、TransmissionAdapter.cs、SabnzbdAdapter.cs 和 NzbgetAdapter.cs,它们实现了统一接口,因此在 Listenarr 里享受完全一致的工作流:提交下载 → 监控队列 → 自动导入书库。
通用接入步骤:5步完成 Listenarr 下载客户端配置
无论接入哪一种客户端,操作路径都一致:
- 打开 Settings → Download Clients 标签页,未配置时页面会提示 “No download clients configured”(见 DownloadClientsTab.vue);
- 点击 Add 打开 Add Download Client 弹窗,选择 Type(切换类型时表单会自动填入对应默认端口);
- 填写 Host(只填域名或 IP,不要带
http://前缀)、Port 与认证信息; - 点击底部 Test 按钮验证连通性,绿色对勾表示成功;
- 检查 Category / Priority 等选项后点击 Save。
配置表单的完整定义在 DownloadClientFormModal.vue,配置数据结构为 DownloadClientConfiguration.cs。
qBittorrent 接入配置:选项最丰富的 Torrent 客户端
- Host / Port:qBittorrent 的 Web UI 地址与端口,在 qBittorrent → Options → Web UI 中查看,默认
8080(帮助提示见 DownloadClientFormModal.vue); - 认证:Web UI 的用户名与密码;
- Use SSL:Web UI 启用 HTTPS 时勾选。
qBittorrent 还有独有的一组高级选项(Advanced Settings),按需调整即可:
- Initial State:新加入种子的初始状态(Default / Start / Force Start / Pause);
- Sequential Order 与 First and Last First:顺序下载、首尾优先,需 qBittorrent 4.1.0+,对有声书多文件分卷尤其有用;
- Content Layout:文件落盘布局(Original / Create Subfolder / Don't Create Subfolder),遵循 qBittorrent 4.3.2 的布局规则。
Listenarr 还会解析种子的做种限制(ratio / 做种时长),达到限制后自动清理,逻辑在 QbittorrentSeedLimitEvaluator.cs。
Transmission 接入配置:注意 RPC 端口不是 Web 端口
Transmission 的接入有一个最容易踩的坑:Listenarr 走的是 RPC 接口,端口是 9091,而不是你平时打开的 Web UI 端口(若单独改过 Web 端口,二者会不一致)。
- Host / Port:RPC 主机与端口,默认
9091; - URL Base:RPC 路径,默认
/transmission/rpc;部分 seedbox 服务商使用/rpc,此时需要手动修改(URL Base 输入项); - 认证:Web UI 的用户名与密码;
- 做种限制:同样受 Transmission 的 ratio / 空闲时长限制约束,见 TransmissionSeedLimitEvaluator.cs。
SABnzbd 接入配置:API Key 一步到位
SABnzbd 是唯一使用 API Key 认证的客户端(API Key 输入项):
- 在 SABnzbd → Config → General 中复制 API Key;
- Port 为 Web 界面端口,默认
8080; - Category:强烈建议填一个专属分类(如
audiobooks),避免与 SABnzbd 里的其他下载互相干扰; - 支持 Usenet 专属的 Remove Completed / Remove Failed 选项,用于导入后从 SABnzbd 历史中清理记录。
NZBGet 接入配置:RPC 密码别忘改
NZBGet 通过 XML-RPC 与 Listenarr 通信:
- Port:默认
6789(NZBGet → Settings → Connection 中查看); - Username:NZBGet 启用认证时的用户名;
- Password:注意这里要填 RPC 密码(NZBGet 中默认为
nzbget),而不是 Web 界面登录密码(提示文案); - Use SSL:NZBGet 开启 TLS 时勾选。
进阶选项对比:Category、Tags 与下载优先级
四种客户端共用一组“调度”选项,但细节有差异(表单相关代码):
| 选项 | 说明 | qBittorrent | Transmission | SABnzbd | NZBGet |
|---|---|---|---|---|---|
| Category | 客户端内的下载分类,建议填 audiobooks |
✅ | ✅ | ✅(强烈推荐) | ✅(强烈推荐) |
| Tags | 按系列的 Tag 定向使用该客户端 | ✅ | ✅ | — | — |
| Recent / Older Priority | 14 天内 / 更早作品的队列优先级(Default / Last / First) | ✅ | ✅ | ✅ | ✅ |
| Completed Download Action | 导入后处理:保留 / 从客户端移除 / 移除并删除文件 | ✅ | ✅ | ✅ | ✅ |
Tags 是 Torrent 客户端的“独享”玩法:给某个系列的有声书打上标签后,可以让特定 qBittorrent 实例只负责带该标签的下载,实现“一部客户端、多路分流”。
Remote Path Mappings:客户端跑在别的机器上怎么办
如果下载客户端部署在 NAS 等远程机器上,Listenarr 需要知道“客户端的路径”对应到本机的哪个目录。这时使用 Remote Path Mappings(管理入口同样在 Download Clients 标签页,相关代码):
- 新增一条映射:Remote Path(客户端机器上的目录)→ Local Path(Listenarr 所在机器上对应目录);
- 编辑某个客户端时,可在表单底部为其勾选要应用的映射。
例如客户端在 NAS 的 /volume1/downloads 下载,而 Listenarr 与 NAS 共享挂载在 /mnt/nas/downloads,配好映射后导入就不会找不到文件。
常见问题快速自查
- Test 连接失败? 优先检查:Host 是否误带了
http://或路径;Transmission 是否误填了 Web UI 端口(应为9091RPC 端口);SSL 勾选是否与客户端实际协议一致; - NZBGet 认证失败:90% 是密码填错了——请确认填的是 RPC 密码(默认
nzbget),不是 Web 登录密码; - SABnzbd 报权限错误:API Key 是否复制完整、是否被重新生成过;
- 种子下载完了却没导入:检查客户端分类/目录与 Download Path 设置,以及是否配置了 Remote Path Mappings;
- 队列刷新不及时:客户端轮询间隔默认为 30 秒,可在设置中通过
PollingIntervalSeconds调整(最小 15 秒,DownloadClientConfiguration.cs)。
写在最后
至此,Listenarr 的四大下载客户端就全部讲完了:qBittorrent 胜在选项丰富、Transmission 胜在轻量通用、SABnzbd 胜在 Usenet 省心、NZBGet 胜在极致性能。按“协议选阵营、按环境挑客户端”的原则配置好认证与路径,剩下的搜索、下载、入库、整理就都交给 Listenarr 自动完成。
更多相关模块可参考:


