Decypharr连接Sonarr/Radarr完全指南：5步搞定qBittorrent/Sabnzbd模拟下载客户端

Decypharr是一款面向 Debrid 与 Usenet 的媒体网关（Media Gateway），它能模拟 qBittorrent 和 Sabnzbd 的 API，让 Sonarr、Radarr 等 *Arr 应用无需任何真实下载客户端，直接把资源任务交给 Decypharr 处理。本指南带你用 5 步完成 Decypharr 与 Sonarr/Radarr 的连接，并配置 qBittorrent/Sabnzbd 模拟下载客户端。

为什么需要"模拟下载客户端"？

传统 *Arr 工作流是：Sonarr 抓到资源 → 发给 qBittorrent 下载 → 导入媒体库。而使用 Decypharr 后：

• 走 Debrid 路线：Arr 把种子发给 Decypharr，Decypharr 通过 Real Debrid、Torbox、All Debrid 等提供商秒取已缓存资源，无需本地下载；
• 走 Usenet 路线：Arr 把 NZB 文件发给 Decypharr，它直连 NNTP 服务器流式读取，不落地完整文件，磁盘占用极小。

也就是说，Decypharr 在 pkg/server/qbit/ 实现了 qBittorrent WebAPI（挂载在/api/v2路径），在 pkg/server/sabnzbd/ 实现了 Sabnzbd API（挂载在/sabnzbd路径），见 pkg/server/server.go。Sonarr/Radarr 把它当成普通下载客户端，完全无感。

准备工作

开始之前请确保：

1. 已部署好 Sonarr（默认 8989）或 Radarr（默认 8787）；
2. 有一个 Debrid 服务 API Key 和/或 Usenet 提供商账号；
3. 知道 Arr 的 API Token（在 Arr 的Settings → General → Token中获取）。

第1步：部署并启动 Decypharr

推荐使用 Docker 部署，端口默认8282：

services: decypharr: image: cy01/blackhole:latest container_name: decypharr ports: - "8282:8282" volumes: - ./configs/:/app restart: unless-stopped devices: - /dev/fuse:/dev/fuse:rwm cap_add: - SYS_ADMIN

首次访问http://<服务器IP>:8282会进入 Setup Wizard，按向导完成 6 步配置：

① 设置管理员账号（Authentication），API Token 会在完成后自动生成并展示一次，记得保存。

② 添加 Debrid 提供商，选择 Real Debrid / Torbox / All Debrid 等并填入 API Key；

③（可选）添加 Usenet 提供商，填入 NNTP 主机、端口（通常 563）、用户名和密码；

④ 选择挂载方式（DFS / Rclone / 外部 Rclone / 无），并设置挂载路径，例如/mnt/decypharr——这个路径稍后要和 Arr 做路径映射，务必记住。

第2步：在 Decypharr 中登记你的 Arr

这一步最关键。在 Decypharr Web UI 的Settings → Arrs中保存你的 Arr 凭据：

• Name：Sonarr（这个名字会作为下载客户端的 Category 使用）
• Host：http://sonarr:8989（Arr 的访问地址）
• Token：Arr 的 API Token

保存后，Decypharr 会用这对凭据反向连接你的 Arr，实现队列状态同步与自动队列清理。注意：这里用的是Arr 的 API Key，而不是 Decypharr 自己的 Token，两者不要混淆。

💡 官方文档 docs/src/content/docs/guides/arrs.mdx 对认证方式有更完整的说明，共 4 种可用凭据组合。

第3步：配置 qBittorrent 模拟客户端（Debrid/Torrent 源）

打开 Sonarr/Radarr，进入Settings → Download Clients → + → qBittorrent，按下表填写：

Advanced选项建议：

Remove Completed: Yes Remove Failed: No

完成后点击Test，看到连接成功提示后Save即可。

第4步：配置 Sabnzbd 模拟客户端（Usenet 源）

如果你配置了 Usenet 提供商，在同一个 Arr 中再加一个 Sabnzbd 客户端，与第3步的区别只有两处：URL Base 填sabnzbd（即/sabnzbd前缀）：

双源混用：Debrid + Usenet 可以并存吗？

可以！两个客户端同时添加即可。给其中一个设置更高的 Priority，Arr 会优先使用高优先级源，另一源作为兜底，实现"Debrid 缓存命中就走 Debrid，否则回落 Usenet"的混合策略。

第5步：路径映射与自动队列清理

路径映射：若 Arr 和 Decypharr 不在同一台机器（或 Docker 挂载不同），必须在 Arr 中配置 Path Mapping，让两边看到相同的目录结构：

Remote Path: /mnt/decypharr (Decypharr 挂载点) Local Path: /media/tv (Arr 看到的目录)

最省心的做法是让两个容器使用完全相同的挂载路径，例如都把/mnt/storage映射到/mnt/storage，这样通常无需任何映射。

自动队列清理：Sonarr/Radarr 的队列常因"下载失败""标题不匹配""空文件"等问题卡死。Decypharr 会监控每个已登记 Arr 的Activity → Queue，按规则自动处理——在Settings → Arrs → Queue Cleanup Actions中一次性配置（全局生效），支持 Ignore、Force import、Blacklist only、Blacklist + research 四种动作，还可为任意状态文本添加自定义规则，匹配后免重启即时生效。

常见问题速查

更多细节（含 Download Actions：symlink/download/strm/none）可查阅 docs/src/content/docs/guides/usenet/sabnzbd.mdx 与 docs/src/content/docs/guides/configuration.md。

写在最后

至此，5 步全部完成：部署 Decypharr → 登记 Arr → 配置 qBittorrent 客户端 → 配置 Sabnzbd 客户端 → 路径映射与队列清理。你的 *Arr 矩阵从此告别"下载等待"——Debrid 资源秒取、Usenet 直接流式读取，媒体库自动保持最新。核心代码位于 pkg/server/qbit/ 与 pkg/server/sabnzbd/，欢迎深入阅读或提交 PR 参与改进。