Части и Безопасный режим

Выключайте Части, которыми не пользуетесь, запускайте HolyArrs в Безопасном режиме, когда что-то ломается, и перезапускайте его из браузера.

Включите или выключите Часть

В HolyArrs 5 Частей: Movies (фильмы), TV shows (сериалы), Music (музыка), Subtitles (субтитры) и Requests (запросы). В первый раз вы выбираете их в мастере первого запуска.

1. Откройте Settings > Parts (настройки > части).
2. Нажмите Turn on (включить) или Turn off (выключить) рядом с Частью. Её пункты меню появятся или исчезнут.

Ничего не удаляется. Включите Часть снова, и она продолжит с того места, где остановилась.

Запустите в Безопасном режиме

Безопасный режим запускает только самое необходимое. Он нужен, когда что-то мешает HolyArrs запуститься или работать. Вы можете войти, посмотреть Медиатеку, изменить настройки, сделать резервную копию или восстановить её. Поиск, добавление, обновление данных, скачивание и импорт ждут следующего обычного запуска.

1. Откройте Settings > Danger zone (настройки > опасная зона).
2. Нажмите Restart in safe mode (перезапустить в безопасном режиме). На каждой странице появится баннер.
3. Устраните проблему, затем нажмите Restart HolyArrs (перезапустить HolyArrs). Следующий запуск будет обычным.

Если страница недоступна, задайте HOLYARRS_SAFE_MODE=1 в Compose или запустите с -safe-mode. После исправления уберите это: с обоими каждый запуск идёт в Безопасном режиме.

Варианты выбора

Что останавливается, когда Часть выключена

Часть	Останавливается	Продолжает работать
Фильмы	Страницы фильмов и пункты меню, добавление, поиск, обновление данных	За загрузками, которые уже есть в вашем загрузчике, HolyArrs следит дальше. Файлы остаются.
Сериалы	Страницы сериалов, добавление, поиск, поиск по сезонам, обновление данных	То же, что у Фильмов.
Музыка	Страницы исполнителей и альбомов, настройки музыки, обновление данных исполнителей, поиск альбомов	То же, что у Фильмов.
Субтитры	Настройки субтитров, страница недостающих субтитров, поиск и проверки	Файлы субтитров рядом с вашими видео остаются.
Запросы	Страницы запросов и возможность запрашивать тайтлы	Существующие запросы остаются и возвращаются, когда Часть снова включена.

Всегда включены: вход и учётные записи, папки Медиатеки, Источники, загрузчики и загрузки, оповещения, История, резервные копии, проверки исправности, настройки и API.

• Субтитрам нужны Фильмы или Сериалы. Запросам нужны Фильмы, Сериалы или Музыка. HolyArrs отказывает в изменении, которое это нарушает, и говорит, что изменить сначала.
• Задание в очереди для выключенной Части ждёт и выполняется, когда Часть включат.
• Выключение Части не экономит память. Всё работает в одной программе.

Перезапуск, пауза и выключение

В Settings > Danger zone (для владельца и администраторов) есть Restart HolyArrs, Restart in safe mode и Shut down (выключить), а ещё Pause (пауза), Resume (возобновить) и Restart (перезапустить) для каждой фоновой задачи, например резервных копий или синхронизации загрузок.

• Элементы, которые что-то останавливают, просят подтвердить в течение 60 с.
• Каждое использование записывается в Историю с вашим именем.
• Нужен вход по паролю. Во входе без пароля из локальной сети будет отказано.

Перезапуск аккуратно останавливает HolyArrs и даёт Docker запустить его снова, поэтому задайте restart: unless-stopped.

Политика перезапуска	Перезапуск	Выключение
unless-stopped или always	Возвращается	Тоже возвращается
on-failure	Возвращается	Остаётся выключенным
no	Остаётся выключенным	Остаётся выключенным

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

Признак проблемы	Причина	Решение
HolyArrs не может выключить Часть	Она нужна другой Части	Сначала выключите ту Часть, как сказано в сообщении.
Перезапуск выключил HolyArrs насовсем	Политика перезапуска — no	Запустите контейнер и задайте restart: unless-stopped.
В управлении отказано	Вход без пароля из локальной сети, или у ключа нет control	Войдите с паролем.
Задача остаётся в состоянии failed	Ей нужны вы	Прочитайте причину на /health, устраните её, нажмите Restart для этой задачи.

Другие решения: Устранение неполадок.

Для опытных

Состояния исправности

/health, Settings > Parts и GET /api/v1/health/states перечисляют каждую фоновую задачу, Часть и связанное приложение с состоянием и причиной.

Состояние	Значение
off	Выключено, на паузе или не запущено в Безопасном режиме.
starting	Запускается или ещё не проверено.
running	Работает.
retrying	Сбой; HolyArrs пробует снова, каждый раз выжидая дольше.
failed	Упало, зависло или ждёт вас. В причине сказано, что делать.

Упавшая задача показывает failed, потом retrying, потом запускается снова. Вход, Медиатека и резервные копии всё это время работают. Зависшая задача сбрасывается при полном перезапуске.

Память и режим экономии памяти

HolyArrs старается держаться ниже 384 MiB, что укладывается в лимит контейнера 500 MB. Чтобы задать свою цель, установите GOMEMLIMIT примерно на 80 процентов памяти контейнера.

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

Настройка	Действие
(по умолчанию, Linux)	Включается сам, когда памяти около 2.5 GiB или меньше.
HOLYARRS_LOW_MEMORY=1	Всегда включён.
HOLYARRS_LOW_MEMORY=0	Всегда выключен.

Первая строка журнала (лога) говорит, включён ли он и почему.

Области ключей API

Создайте ключ в Settings > API > API keys (настройки > API > ключи API) и передавайте его в заголовке X-Api-Key.

Область	Куда даёт доступ
read	Медиатека, задания, загрузки, История, исправность, настройки. Секреты скрыты.
health_read	Только состояния исправности. Для средств мониторинга.
write	Любые изменения, кроме маршрутов администратора и управления.
admin	Люди, приглашения, лимиты запросов, ключи API, пароль и двухфакторная защита, настройки входа, резервные копии.
control	Элементы управления с этой страницы. Выдать её могут только владелец и администраторы.
all	read, write и admin. Без control.

Ключ никогда не может больше, чем человек, который его создал. Области нельзя изменить позже; создайте новый ключ. Все маршруты и их области: /api/v1/openapi.json.

См. также

• Проверки исправности
• Резервные копии
• Маршруты API