HolyArrs下载器下载器连接教程:qBittorrent、SABnzbd等6种客户端一次配齐

原创2026-11-13 09:09:071,641 阅读

HolyArrs下载器下载器连接教程:qBittorrent、SABnzbd等6种客户端一次配齐

上面的标题中"下载器"一词重复了,请使用以下规范版本:

HolyArrs下载器连接教程:qBittorrent、SABnzbd等6种客户端一次配齐

HolyArrs 是一款自托管的媒体管理应用,一个应用管理你的剧集、电影和音乐。它自己不下东西,而是把资源交给 qBittorrent、Transmission、Deluge、rTorrent、SABnzbd、NZBGet 这 6 种下载器客户端去下载,下载完成后自动导入媒体库。本教程带你 快速配齐全部 6 种客户端,10 分钟搞定下载链路。

HolyArrs下载器连接教程项目吉祥物:自托管媒体管理应用

一、先搞懂:HolyArrs支持哪6种下载器?

HolyArrs 把下载器分成两大类:Torrent(种子) 和 Usenet(新闻组):

类型 支持的客户端 适合场景
Torrent qBittorrent、Transmission 4+、Deluge、rTorrent(可带 ruTorrent) 家用局域网、种子站资源
Usenet SABnzbd、NZBGet 新闻组资源、高修复率下载

💡 新手建议:先从 qBittorrent + SABnzbd 各配一个开始,两个都显示 Working 后,再按需加其余 4 个。

完整官方说明见 docs/downloads/downloaders.md。

二、配置前的快速准备

动手前确认 3 件事:

  1. 你是 owner 或 admin 账户;
  2. 下载器已在运行,浏览器能打开它的网页;
  3. HolyArrs 能访问到下载器的地址(容器之间要用 IP + 端口,别写 localhost)。

三、添加下载器的6步通用流程

不管接哪种客户端,流程都一样:

  1. 打开 Settings > Downloaders(设置 > 下载器);
  2. 点击 Add a Downloader(添加下载器);
  3. 在 Which app 下拉框里选你的客户端;
  4. 填 Name(自定义名字)和 Address(客户端网页地址,如 http://192.168.1.10:8090);
  5. 按下一节填写对应登录凭据;
  6. 点 Save,再点这一行的 Test —— 看到 Working 就配好了 ✅

四、6种客户端登录凭据速查表

这是新手最容易卡住的地方,一张表说清楚填什么、去哪找:

客户端 填什么 在客户端哪里找
qBittorrent API key(5.2+ 版本)或 用户名+密码 Options > Web UI
Transmission 用户名+密码(不要求登录就留空) Transmission 设置
Deluge 仅 Web UI 密码(无用户名) Deluge Web UI
rTorrent 前置 Web 服务器的用户名+密码(不要求就留空) 你的 Web 服务器或 Seedbox 设置
SABnzbd API key Config > General
NZBGet 用户名+密码(允许免密就留空) NZBGet 设置

🔒 放心填:HolyArrs 会把密钥加密存储且之后不再显示。字段留空 = 保留已存的凭据;换地址到新主机时则必须重新输入,HolyArrs 绝不会把旧密钥发给新主机。

rTorrent 地址要特别注意

rTorrent 走 XML-RPC,Address 填的是 RPC 地址,不是 ruTorrent 网页:

部署方式 Address 应填
crazymax/rtorrent-rutorrent http://host:8000/RPC2(8080 是 ruTorrent 网页,别填错)
通过 ruTorrent 代理 http://host:8080/plugins/httprpc/action.php
Seedbox 商家给你的 RPC 地址,如 https://host/user/RPC2

地址不写路径时会自动补上 /RPC2。

五、进阶选项:分类、优先级与路径映射

分类(Category)

HolyArrs 只把下载放进你填的分类里、也只盯这个分类:

  • qBittorrent:没有就自动帮你创建;
  • SABnzbd:必须先在 Config > Categories 里建好;
  • Transmission / Deluge 存为 label;rTorrent 存到 d.custom1;NZBGet 作为下载分类下发。

优先级与标签

  • Priority 取值 1~50,数字越小越先用,相同数字轮流用;
  • Tags:只有带相同标签的片名才会用这个下载器。

路径映射(容器部署必读)⚠️

如果 HolyArrs 和下载器分属两个容器、看到的下载目录名不一样,导入必失败。两种解法:

  1. 推荐:两个容器挂载同一个父目录到相同路径(见 docs/start/folders.md);
  2. 或在下载器下 Different folder names 里填一对路径:Downloader's path 填下载器的目录(如 /data/torrents),HolyArrs' path 填 HolyArrs 看到的目录(如 /downloads)。

六、连不上?常见故障快速排查

你看到的现象 原因 解决办法
Not answering 地址错 / 容器互相不通 用浏览器能打开的 IP + 端口,别用 localhost
Sign-in refused 密钥或密码错 重新从客户端复制密钥,保存后再 Test
SABnzbd 测试失败(用主机名时) SABnzbd 拒绝不认识的主机名 改用 IP,或在 SABnzbd Config > Special 的 host_whitelist 加入 HolyArrs 主机名
SABnzbd 提示分类不存在 分类没建 在 SABnzbd Config > Categories 建好后重测
Deluge 连不上 Label 插件没开 在 Deluge Web UI 自己连上 daemon 后开启 Label 插件
rTorrent 测试 404 端口/路径错 改填 http://host:8000/RPC2
rTorrent 报 not allowed for untrusted connections ruTorrent 拦了必需命令 升级 ruTorrent,或把 Address 指向 rTorrent 的 /RPC2
行显示 Check whether this download arrived 下发时连接中断 先到下载器里找任务,再回 HolyArrs 点 Give up on it

更多排查见 docs/help/troubleshooting.md。

七、看懂连接状态:5种行状态一览

状态 含义
Working 正常,最近一次检查有响应
Paused 你手动暂停了,不再下发新任务
Resting 暂时无响应,HolyArrs 等到显示时间再试
Not answering 最近一次检查没收到响应
Sign-in refused 密钥/登录被拒

停止响应的下载器最多会被跳过 30 分钟,一般不用管它,会自动恢复。

八、下一步:把下载链路跑通

下载器只是半条链路,还要配上 Sources(来源,如 Prowlarr / Jackett / Torznab),HolyArrs 才能搜到资源并发给下载器。几分钟配好"一下载器 + 一来源"的完整流程见 docs/start/connect.md;来源配置详情见 docs/downloads/sources.md。

📚 相关文档与源码:

6 种客户端任选其一开始配,剩下的照搬同一套流程即可——一次配齐,剧集、电影、音乐的下站工作就全部交出去了。 </输出文章>

抱歉,上面开头多了一行草稿说明,以下是最终干净版本:

<输出文章>

HolyArrs下载器连接教程:qBittorrent、SABnzbd等6种客户端一次配齐

HolyArrs 是一款自托管的媒体管理应用,一个应用管理你的剧集、电影和音乐。它自己不下东西,而是把资源交给 qBittorrent、Transmission、Deluge、rTorrent、SABnzbd、NZBGet 这 6 种下载器客户端去下载,下载完成后自动导入媒体库。本教程带你 快速配齐全部 6 种客户端,10 分钟搞定下载链路。

HolyArrs下载器连接教程项目吉祥物:自托管媒体管理应用

一、先搞懂:HolyArrs支持哪6种下载器?

HolyArrs 把下载器分成两大类:Torrent(种子) 和 Usenet(新闻组):

类型 支持的客户端 适合场景
Torrent qBittorrent、Transmission 4+、Deluge、rTorrent(可带 ruTorrent) 家用局域网、种子站资源
Usenet SABnzbd、NZBGet 新闻组资源、高修复率下载

💡 新手建议:先从 qBittorrent + SABnzbd 各配一个开始,两个都显示 Working 后,再按需加其余 4 个。

完整官方说明见 docs/downloads/downloaders.md。

二、配置前的快速准备

动手前确认 3 件事:

  1. 你是 owner 或 admin 账户;
  2. 下载器已在运行,浏览器能打开它的网页;
  3. HolyArrs 能访问到下载器的地址(容器之间要用 IP + 端口,别写 localhost)。

三、添加下载器的6步通用流程

不管接哪种客户端,流程都一样:

  1. 打开 Settings > Downloaders(设置 > 下载器);
  2. 点击 Add a Downloader(添加下载器);
  3. 在 Which app 下拉框里选你的客户端;
  4. 填 Name(自定义名字)和 Address(客户端网页地址,如 http://192.168.1.10:8090);
  5. 按下一节填写对应登录凭据;
  6. 点 Save,再点这一行的 Test —— 看到 Working 就配好了 ✅

四、6种客户端登录凭据速查表

这是新手最容易卡住的地方,一张表说清楚填什么、去哪找:

客户端 填什么 在客户端哪里找
qBittorrent API key(5.2+ 版本)或 用户名+密码 Options > Web UI
Transmission 用户名+密码(不要求登录就留空) Transmission 设置
Deluge 仅 Web UI 密码(无用户名) Deluge Web UI
rTorrent 前置 Web 服务器的用户名+密码(不要求就留空) 你的 Web 服务器或 Seedbox 设置
SABnzbd API key Config > General
NZBGet 用户名+密码(允许免密就留空) NZBGet 设置

🔒 放心填:HolyArrs 会把密钥加密存储且之后不再显示。字段留空 = 保留已存的凭据;换地址到新主机时则必须重新输入,HolyArrs 绝不会把旧密钥发给新主机。

rTorrent 地址要特别注意

rTorrent 走 XML-RPC,Address 填的是 RPC 地址,不是 ruTorrent 网页:

部署方式 Address 应填
crazymax/rtorrent-rutorrent http://host:8000/RPC2(8080 是 ruTorrent 网页,别填错)
通过 ruTorrent 代理 http://host:8080/plugins/httprpc/action.php
Seedbox 商家给你的 RPC 地址,如 https://host/user/RPC2

地址不写路径时会自动补上 /RPC2。

五、进阶选项:分类、优先级与路径映射

分类(Category)

HolyArrs 只把下载放进你填的分类里、也只盯这个分类:

  • qBittorrent:没有就自动帮你创建;
  • SABnzbd:必须先在 Config > Categories 里建好;
  • Transmission / Deluge 存为 label;rTorrent 存到 d.custom1;NZBGet 作为下载分类下发。

优先级与标签

  • Priority 取值 1~50,数字越小越先用,相同数字轮流用;
  • Tags:只有带相同标签的片名才会用这个下载器。

路径映射(容器部署必读)⚠️

如果 HolyArrs 和下载器分属两个容器、看到的下载目录名不一样,导入必失败。两种解法:

  1. 推荐:两个容器挂载同一个父目录到相同路径(见 docs/start/folders.md);
  2. 或在下载器下 Different folder names 里填一对路径:Downloader's path 填下载器的目录(如 /data/torrents),HolyArrs' path 填 HolyArrs 看到的目录(如 /downloads)。

六、连不上?常见故障快速排查

你看到的现象 原因 解决办法
Not answering 地址错 / 容器互相不通 用浏览器能打开的 IP + 端口,别用 localhost
Sign-in refused 密钥或密码错 重新从客户端复制密钥,保存后再 Test
SABnzbd 测试失败(用主机名时) SABnzbd 拒绝不认识的主机名 改用 IP,或在 SABnzbd Config > Special 的 host_whitelist 加入 HolyArrs 主机名
SABnzbd 提示分类不存在 分类没建 在 SABnzbd Config > Categories 建好后重测
Deluge 连不上 Label 插件没开 在 Deluge Web UI 自己连上 daemon 后开启 Label 插件
rTorrent 测试 404 端口/路径错 改填 http://host:8000/RPC2
rTorrent 报 not allowed for untrusted connections ruTorrent 拦了必需命令 升级 ruTorrent,或把 Address 指向 rTorrent 的 /RPC2
行显示 Check whether this download arrived 下发时连接中断 先到下载器里找任务,再回 HolyArrs 点 Give up on it

更多排查见 docs/help/troubleshooting.md。

七、看懂连接状态:5种行状态一览

状态 含义
Working 正常,最近一次检查有响应
Paused 你手动暂停了,不再下发新任务
Resting 暂时无响应,HolyArrs 等到显示时间再试
Not answering 最近一次检查没收到响应
Sign-in refused 密钥/登录被拒

停止响应的下载器最多会被跳过 30 分钟,一般不用管它,会自动恢复。

八、下一步:把下载链路跑通

下载器只是半条链路,还要配上 Sources(来源,如 Prowlarr / Jackett / Torznab),HolyArrs 才能搜到资源并发给下载器。几分钟配好"一下载器 + 一来源"的完整流程见 docs/start/connect.md;来源配置详情见 docs/downloads/sources.md。

📚 相关文档与源码:

6 种客户端任选其一开始配,剩下的照搬同一套流程即可——一次配齐,剧集、电影、音乐的下站工作就全部交出去了。

登录后查看全文
HolyArrs