跳转到内容
HolyArrsDocsHolyArrs.com

下载器

设置

连接你的下载应用，让 HolyArrs 能把资源发给它，并导入下载完成的内容。

HolyArrs 自己不下载。它把每个资源交给一个下载器，跟踪进度，然后导入文件。

类型 应用
种子 qBittorrent、Transmission 4 或更新版本、Deluge
Usenet SABnzbd、NZBGet

开始之前

开始之前 的链接
  • 你是所有者或管理员。
  • 你的下载应用正在运行，而且你能打开它的网页。

添加一个下载器

添加一个下载器 的链接

  1. 打开 Settings > Downloaders（设置 > 下载器）。

  2. 点击 Add a Downloader（添加下载器）。

  3. 在 Which app（哪个应用）下，选你的应用。

  4. 输入一个 Name（名称）。

  5. 输入 Address（地址），也就是这个应用的网页地址，比如 http://192.168.1.10:8090。

  6. 填写登录信息。参见各应用的登录信息。

  7. 点击 Save（保存），然后点这一行上的 Test（测试）。

    你应该会看到名称旁边显示 Working（正常）。

各应用的登录信息

各应用的登录信息 的链接
应用 填什么 在哪里找
qBittorrent API key（API 密钥）（qBittorrent 5.2 或更新版本）或 Username and password（用户名和密码） Options > Web UI
Transmission 用户名和密码，如果它不要求就留空 Transmission 的设置
Deluge Web UI 密码，没有用户名 Deluge Web UI
SABnzbd API 密钥 Config > General
NZBGet 用户名和密码，如果 NZBGet 不用它们也让 HolyArrs 进就留空 NZBGet 的设置

HolyArrs 把密钥和密码加密保存，之后不会再显示出来。不动这个字段，就继续用已保存的。把地址改到另一台主机时，要重新输入密钥。HolyArrs 绝不会把已保存的密钥发给新的主机。

选项

选项 的链接

对 qBittorrent 来说，这些都在 More options（更多选项）下。

分类

分类 的链接

HolyArrs 把它的下载任务归到这个分类下，并且只跟踪这个分类。

应用 分类怎么起作用
qBittorrent 没有的话会替你创建
SABnzbd 必须先在 Config > Categories 下建好
Transmission、Deluge 保存为标签
NZBGet 作为下载分类发送

优先级和标签

优先级和标签 的链接

Priority（优先级）的范围是 1 到 50。数字最小的先用，数字相同的轮流用。设了 Tags（标签）后，只有带相同标签的条目才用这个下载器。没有标签的条目用没有标签的下载器。

路径

路径 的链接

只有当两个应用看到的下载文件夹名称不一样时，才在 Different folder names（文件夹名称不同）下填写 Downloader’s path（下载器的路径）和 HolyArrs’ path（HolyArrs 的路径）。例如：下载器保存到 /data/torrents，而 HolyArrs 看到的是 /downloads。Add a path pair（添加一组路径）会再加一行。

更好的办法是用一个共享的上级文件夹，在两个容器里挂载到相同的路径。参见文件夹。

访问局域网

访问局域网 的链接

默认开启，因为下载器一般都运行在家里。如果下载器在互联网上，就把它关掉。

HolyArrs 可以改动这个下载器

HolyArrs 可以改动这个下载器 的链接

关闭后，新的下载任务还是会发到那里，但 HolyArrs 绝不会暂停、更改或移除里面已有的任何东西。和其他应用共用的下载器适合这样设。

跟踪一个下载任务

跟踪一个下载任务 的链接

条目页面会显示每个下载任务：排队中、下载中（带速度和剩余时间）、停滞，或者失败及原因。

如果有不想要的下载任务，点击 Mark failed（标记为失败）来结束它。之后 HolyArrs 会：

  1. 把这个资源加到条目的 Turned down（已排除）列表里，这样它不会再被选中。
  2. 把它连同文件一起从下载器里移除。
  3. 重新搜索，发送下一个最好的资源。

如果没有别的资源能通过你的规则，条目会显示 Needs a decision（待你决定）。

行的状态

行的状态 的链接
状态 含义
Working 上一次检查有响应
Paused（已暂停） 你把它暂停了。不再发送新内容；现有的下载任务仍会跟踪
Resting（休息中） 它没有响应，所以 HolyArrs 会等到显示的时间
Not answering（没有响应） 上一次检查没有得到响应
Sign-in refused（登录被拒） 密钥或登录信息被拒绝了

行上的 Pause（暂停）和 Resume（恢复使用）用来停止和重新开始发送。不再响应的下载器最多会被跳过 30 分钟。

如果不成功

如果不成功 的链接

现象：Address 用主机名时，SABnzbd 的测试失败。 原因：SABnzbd 会拒绝它不认识的主机名。 解决办法：用它的 IP 地址，或者在 SABnzbd 的 Config > Special 下把 HolyArrs 的主机名加到 host_whitelist 里。

现象：SABnzbd 说分类不存在。 解决办法：在 SABnzbd 的 Config > Categories 下建好这个分类，然后点击 Test。

现象：Deluge 不工作。 解决办法：在 Deluge Web UI 里自己连接到你的 daemon，并开启 Label 插件。HolyArrs 不会替你选 daemon。

现象：来自带代理的来源的 .torrent 或 .nzb 被拒绝。 原因：Transmission、Deluge 和 NZBGet 目前还不能接收通过代理来源得到的这类文件。磁力链接可以用。

现象：某一行显示 Check whether this download arrived（确认这个下载任务是否已送达）。 原因：Transmission、Deluge 或 NZBGet 正在接收资源时连接断了。HolyArrs 不会自己再发一次。 解决办法：

  1. 在下载器应用里找这个下载任务。
  2. 在 HolyArrs 里点击 Give up on it（放弃它）。下载任务会留在下载器里。如果想换一个资源，在 Needs a decision 下另选一个。

现象：Sign-in refused。 解决办法：从下载器里复制密钥或密码，重新输入，点击 Test。

更多内容见故障排查。

进阶

进阶 的链接
HolyArrs 怎么选下载器
  • 种子资源发给种子下载器，Usenet 资源发给 Usenet 下载器。
  • 优先级数字最小的先用。数字相同的轮流用。
  • 已暂停和休息中的下载器会被跳过。
  • 如果一个下载器拒绝了某个资源，就试下一个同类型的（Try the next Downloader（换下一个下载器））。
  • 默认情况下，发给同一个下载器的两次发送间隔 2 s。
  • 标签必须匹配。没有标签的条目发给没有标签的下载器。
下载出问题时：哪些算失败，以及相关设置

HolyArrs 会把下面这些情况当作 Mark failed 来处理：

  • 下载器放弃了（缺少分块、修复失败）。会显示它给出的原因。
  • 下载内容里有程序，比如 .exe、.bat、.scr 或 .lnk，包括 movie.mkv.exe。
  • 下载内容看起来是假资源：有一份密码说明、只有压缩包而没有视频或音频，或者只有一个网页快捷方式而旁边没有媒体文件。种子的文件列表一到就会被读取，所以假资源在下载之前就会失败。
  • 文件和资源名称对不上。导入会被拒绝，下载任务会被移除。
  • 在放弃时限内一直没有进度。排队中、在下载器里被暂停、到 100% 后正在修复或解压，这些都不算。
  • 下载任务在 HolyArrs 之外被移除了。会用下一个资源来替换它。

这些设置在 Settings > Downloaders 的 When downloads go wrong（下载出问题时）下。改动之后，在出现的栏里点击 Save。

设置项 默认 什么时候改
从下载器里移除失败的下载任务 开 你想检查失败的下载任务（关）。开启时也会删除它们的文件
把匹配到的条目加入你的媒体库 关 你想让下载器里已有的、匹配确定无误的内容不经搜索直接加入
移除下载任务时：Delete its files（删除它的文件） 开 你想保留文件
移除下载任务时：Turn down its Release（排除它的资源） 关 你不想让这个条目再选中那个资源
移除下载任务时：Search again（重新搜索） 开 如果你自己选下一个资源就关掉。需要开启 Turn down its Release
多久后算停滞（小时） 6 你的下载本来就慢。范围 1 到 168
多久后换下一个资源（小时） 24 你宁愿等也不想换。从最后一次有进度算起。范围：从停滞时间到 720
让含有程序或假资源的下载任务失败 开 很少需要改。关闭后它们会进入导入环节
替换在 HolyArrs 之外被移除的下载任务 开 你是有意移除下载任务的。关闭后条目会等你处理
换下一个下载器 开 你只想用一个下载器
发给同一个下载器的间隔秒数 2 下载器一下子收到太多会卡住。0 表示不设间隔。范围 0 到 60
从服务器端把下载器锁定为只读

把 HOLYARRS_READONLY_DOWNLOADERS 设为用逗号分隔的下载器 id 或地址列表：

HOLYARRS_READONLY_DOWNLOADERS=http://your-server:8080

列在里面的下载器不管开关怎么设都保持只读，移除后重新添加也一样。开关会显示为已锁定，Downloads 页面会隐藏它那些行上的控件。

移除、NZBGet 的移除、API
  • 下载器还有进行中的下载任务时，Remove（移除）会被拒绝。先暂停它，等下载任务完成，再移除。
  • 只要移除下载任务或它的历史条目，NZBGet 就会删除文件，所以 HolyArrs 会拒绝要求保留文件的移除操作。
  • 下载器的每个路由都在 http://your-server:6262/api/v1/openapi.json 里。

相关页面

相关页面 的链接

HolyArrs 是免费的。如果它帮你省了时间，欢迎在 GitHub 上点个 Star、赞助它或请我喝杯咖啡。