HolyArrs下载器下载器连接教程:qBittorrent、SABnzbd等6种客户端一次配齐
HolyArrs下载器下载器连接教程:qBittorrent、SABnzbd等6种客户端一次配齐
上面的标题中"下载器"一词重复了,请使用以下规范版本:
HolyArrs下载器连接教程:qBittorrent、SABnzbd等6种客户端一次配齐
HolyArrs 是一款自托管的媒体管理应用,一个应用管理你的剧集、电影和音乐。它自己不下东西,而是把资源交给 qBittorrent、Transmission、Deluge、rTorrent、SABnzbd、NZBGet 这 6 种下载器客户端去下载,下载完成后自动导入媒体库。本教程带你 快速配齐全部 6 种客户端,10 分钟搞定下载链路。
一、先搞懂:HolyArrs支持哪6种下载器?
HolyArrs 把下载器分成两大类:Torrent(种子) 和 Usenet(新闻组):
| 类型 | 支持的客户端 | 适合场景 |
|---|---|---|
| Torrent | qBittorrent、Transmission 4+、Deluge、rTorrent(可带 ruTorrent) | 家用局域网、种子站资源 |
| Usenet | SABnzbd、NZBGet | 新闻组资源、高修复率下载 |
💡 新手建议:先从 qBittorrent + SABnzbd 各配一个开始,两个都显示
Working后,再按需加其余 4 个。
完整官方说明见 docs/downloads/downloaders.md。
二、配置前的快速准备
动手前确认 3 件事:
- 你是 owner 或 admin 账户;
- 下载器已在运行,浏览器能打开它的网页;
- HolyArrs 能访问到下载器的地址(容器之间要用 IP + 端口,别写
localhost)。
三、添加下载器的6步通用流程
不管接哪种客户端,流程都一样:
- 打开 Settings > Downloaders(设置 > 下载器);
- 点击 Add a Downloader(添加下载器);
- 在 Which app 下拉框里选你的客户端;
- 填 Name(自定义名字)和 Address(客户端网页地址,如
http://192.168.1.10:8090); - 按下一节填写对应登录凭据;
- 点 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 和下载器分属两个容器、看到的下载目录名不一样,导入必失败。两种解法:
- 推荐:两个容器挂载同一个父目录到相同路径(见 docs/start/folders.md);
- 或在下载器下 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。
📚 相关文档与源码:
- 下载器官方文档:docs/downloads/downloaders.md
- 下载模块总览:docs/downloads/index.md
- 历史记录(查下载/导入/失败):docs/downloads/history.md
- 下载器连接相关后端源码:app/backend/internal/downloads/
6 种客户端任选其一开始配,剩下的照搬同一套流程即可——一次配齐,剧集、电影、音乐的下站工作就全部交出去了。 </输出文章>
抱歉,上面开头多了一行草稿说明,以下是最终干净版本:
<输出文章>
HolyArrs下载器连接教程:qBittorrent、SABnzbd等6种客户端一次配齐
HolyArrs 是一款自托管的媒体管理应用,一个应用管理你的剧集、电影和音乐。它自己不下东西,而是把资源交给 qBittorrent、Transmission、Deluge、rTorrent、SABnzbd、NZBGet 这 6 种下载器客户端去下载,下载完成后自动导入媒体库。本教程带你 快速配齐全部 6 种客户端,10 分钟搞定下载链路。
一、先搞懂:HolyArrs支持哪6种下载器?
HolyArrs 把下载器分成两大类:Torrent(种子) 和 Usenet(新闻组):
| 类型 | 支持的客户端 | 适合场景 |
|---|---|---|
| Torrent | qBittorrent、Transmission 4+、Deluge、rTorrent(可带 ruTorrent) | 家用局域网、种子站资源 |
| Usenet | SABnzbd、NZBGet | 新闻组资源、高修复率下载 |
💡 新手建议:先从 qBittorrent + SABnzbd 各配一个开始,两个都显示
Working后,再按需加其余 4 个。
完整官方说明见 docs/downloads/downloaders.md。
二、配置前的快速准备
动手前确认 3 件事:
- 你是 owner 或 admin 账户;
- 下载器已在运行,浏览器能打开它的网页;
- HolyArrs 能访问到下载器的地址(容器之间要用 IP + 端口,别写
localhost)。
三、添加下载器的6步通用流程
不管接哪种客户端,流程都一样:
- 打开 Settings > Downloaders(设置 > 下载器);
- 点击 Add a Downloader(添加下载器);
- 在 Which app 下拉框里选你的客户端;
- 填 Name(自定义名字)和 Address(客户端网页地址,如
http://192.168.1.10:8090); - 按下一节填写对应登录凭据;
- 点 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 和下载器分属两个容器、看到的下载目录名不一样,导入必失败。两种解法:
- 推荐:两个容器挂载同一个父目录到相同路径(见 docs/start/folders.md);
- 或在下载器下 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。
📚 相关文档与源码:
- 下载器官方文档:docs/downloads/downloaders.md
- 下载模块总览:docs/downloads/index.md
- 历史记录(查下载/导入/失败):docs/downloads/history.md
- 下载器连接相关后端源码:app/backend/internal/downloads/
6 种客户端任选其一开始配,剩下的照搬同一套流程即可——一次配齐,剧集、电影、音乐的下站工作就全部交出去了。
