Розділи й безпечний режим

Вимкни розділи, якими не користуєшся, запускайся в безпечному режимі, коли щось ламається, і перезапускай 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. Прибери це після виправлення: обидва способи тримають кожен запуск у безпечному режимі.

Варіанти

Що зупиняється, коли розділ вимкнено

Розділ	Що зупиняється	Що триває далі
Фільми	Сторінки й пункти меню фільмів, додавання, пошук, оновлення	Завантаження, які вже є у твоєму завантажувачі, і далі відстежуються. Файли лишаються.
Серіали	Сторінки серіалів, додавання, пошук, пошук сезонів, оновлення	Те саме, що й у фільмів.
Музика	Сторінки виконавців і альбомів, налаштування музики, оновлення виконавців, пошук альбомів	Те саме, що й у фільмів.
Субтитри	Налаштування субтитрів, сторінка відсутніх субтитрів, пошук і перевірки	Файли субтитрів поруч із твоїми відео лишаються.
Запити	Сторінки запитів і запрошування тайтлів	Наявні запити лишаються й повертаються, коли розділ знову ввімкнено.

Завжди ввімкнене: вхід і облікові записи, теки бібліотеки, джерела, завантажувачі й завантаження, сповіщення, історія, бекапи, перевірки справності, налаштування та API.

• Субтитрам потрібні фільми або серіали. Запитам потрібні фільми, серіали або музика. HolyArrs відхиляє зміну, яка це порушує, і каже, що змінити спершу.
• Завдання в черзі для вимкненого розділу чекає й виконується, щойно розділ увімкнено.
• Вимкнення розділу не заощаджує оперативну пам’ять. Усе працює в одному застосунку.

Перезапуск, пауза й вимкнення

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

• Елементи керування, що щось зупиняють, просять підтвердити протягом 60 с.
• Кожне використане керування записується в History (історію) з твоїм іменем.
• Потрібен вхід з паролем. Вхід без пароля в локальній мережі відхиляється.

Перезапуск чисто зупиняє 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