Загрузчики

Подключите своё приложение для загрузок, чтобы 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 (работает).

Осторожно

Если HolyArrs и Загрузчик работают в разных контейнерах и видят папку загрузок по разным путям, импорт не сработает. Заполните пару путей в разделе Пути до первой загрузки.

Вход для каждого приложения

Приложение	Что ввести	Где это найти
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	Хранится как label
NZBGet	Отправляется как категория загрузки

Приоритет и метки

Priority (приоритет) — число от 1 до 50. Первым используется самое маленькое число, а при равных числах Загрузчики работают по очереди. С Tags (метки) этот Загрузчик используют только тайтлы с общей меткой. Тайтлы без меток используют Загрузчики без меток.

Пути

Заполняйте Downloader’s path (путь в Загрузчике) и HolyArrs’ path (путь в HolyArrs) в Different folder names (разные имена папок), только когда два приложения видят папку загрузок под разными именами. Пример: Загрузчик сохраняет в /data/torrents, а HolyArrs видит эту папку как /downloads. Add a path pair (добавить пару путей) добавляет ещё одну строку.

Лучшее решение — одна общая родительская папка, смонтированная по одному и тому же пути в обоих контейнерах. См. Папки.

Доступ к локальной сети

Включён по умолчанию, потому что Загрузчики обычно работают дома. Выключите его для Загрузчика в интернете.

HolyArrs может менять этот Загрузчик

Если выключено, новые загрузки по-прежнему отправляются туда, но HolyArrs никогда не ставит на паузу, не меняет и не удаляет то, что там уже есть. Используйте это для Загрузчика, которым пользуются и другие приложения.

Следите за загрузкой

Страница тайтла показывает каждую загрузку: ждёт своей очереди, скачивается (со скоростью и оставшимся временем), зависла или не удалась (с причиной).

Нажмите Mark failed (отметить как неудачную), чтобы завершить загрузку, которая вам не нужна. После этого HolyArrs:

1. Добавляет этот Релиз в список Turned down (отброшен) у тайтла, чтобы он больше не выбирался.
2. Удаляет его из Загрузчика вместе с файлами.
3. Ищет заново и отправляет следующий лучший Релиз.

Если больше ничего не проходит ваши правила, тайтл показывает Needs a decision (требует решения).

Состояния строки

Состояние	Что значит
Working	Ответил на последнюю проверку
Paused (на паузе)	Вы поставили его на паузу. Ничего нового не отправляется; за текущими загрузками HolyArrs по-прежнему следит
Resting (отдыхает)	Он не ответил, поэтому HolyArrs ждёт до указанного времени
Not answering (не отвечает)	На последнюю проверку ответа не было
Sign-in refused (вход отклонён)	Ключ или данные для входа не приняты

Pause (пауза) и Resume (возобновить) в строке останавливают и запускают отправку. Загрузчик, который перестал отвечать, пропускается на срок до 30 минут.

Если не работает

Признак проблемы: Проверка SABnzbd не проходит, когда в Address стоит имя хоста. Причина: SABnzbd отклоняет имена хостов, которых не знает. Решение: Используйте его IP-адрес или добавьте имя хоста HolyArrs в host_whitelist в SABnzbd, в Config > Special.

Признак проблемы: SABnzbd сообщает, что категории нет. Решение: Создайте категорию в SABnzbd в Config > Categories, затем нажмите Test.

Признак проблемы: Deluge не работает. Решение: В Deluge Web UI сами подключитесь к своему daemon и включите плагин Label. HolyArrs не выбирает daemon.

Признак проблемы: Файл .torrent или .nzb от Источника с прокси отклоняется. Причина: Transmission, Deluge и NZBGet пока не могут принимать такие файлы через Источник с прокси. Magnet-ссылки работают.

Признак проблемы: В строке написано 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 с.
• Метки должны совпадать. Тайтлы без меток идут в Загрузчики без меток.

Когда загрузки идут не так: что считается и какие есть настройки

В этих случаях HolyArrs поступает так же, как при Mark failed:

• Загрузчик сдаётся (не хватает частей, восстановление не удалось). Его причина показывается.
• В загрузке есть программы, такие как .exe, .bat, .scr или .lnk, включая movie.mkv.exe.
• Загрузка похожа на подделку: записка с паролем, одни архивы без видео и аудио или веб-ярлык без медиафайлов рядом. Списки файлов торрентов читаются сразу, как только приходят, поэтому подделка отсеивается ещё до скачивания.
• Файлы не соответствуют названию Релиза. Импорт отклоняется, а загрузка удаляется.
• Нет прогресса дольше времени, после которого HolyArrs сдаётся. Ожидание своей очереди, пауза в Загрузчике, а также восстановление и распаковка на 100% не считаются.
• Загрузку удалили вне HolyArrs. Она заменяется следующим Релизом.

Эти настройки находятся под When downloads go wrong (когда загрузки идут не так) на странице Settings > Downloaders. После изменения нажмите 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 список идентификаторов или адресов Загрузчиков через запятую:

HOLYARRS_READONLY_DOWNLOADERS=http://your-server:8080

Загрузчик из списка остаётся только для чтения, что бы ни показывал его переключатель, даже после удаления и повторного добавления. Переключатель показан заблокированным, а страница Загрузки скрывает элементы управления в его строках.

Удаление, удаления в NZBGet, API

• Remove (удалить) отклоняется, пока у Загрузчика есть активные загрузки. Поставьте его на паузу, дайте им закончиться, затем удаляйте.
• NZBGet удаляет файлы всякий раз, когда удаляется загрузка или её запись в истории, поэтому HolyArrs отклоняет удаления, которые просят сохранить файлы.
• Все маршруты Загрузчиков есть в http://your-server:6262/api/v1/openapi.json.

См. также

• Источники
• История
• Папки