Усунення проблем

Знайди свою ознаку, прочитай причину, виконай рішення. У прикладах контейнер називається holyarrs; використовуй свою назву, якщо вона інша.

Перші 3 перевірки

1. Стеж за логом: docker logs -f holyarrs. Секрети приховані. Натисни Ctrl+C, щоб припинити стеження; контейнер продовжує працювати.
2. Запусти doctor: docker exec holyarrs /holyarrs doctor. Кожен рядок має OK, WARN або FAIL, а біля кожного WARN чи FAIL написано, як це виправити.
3. Досі не виходить? Завантаж пакет для підтримки й попроси допомоги. Дивись Підтримка.

Не відкривається вебсторінка

Ознака: браузер не може з’єднатися з http://your-server:6262.

Причина: контейнер зупинений, порт не зіставлено або на шляху стоїть проксі.

Рішення:

1. Виконай docker ps. Ти маєш побачити holyarrs із 0.0.0.0:6262->6262.
2. Якщо контейнер постійно перезапускається, причину шукай у docker logs holyarrs.
3. Якщо ти користуєшся шляхом на кшталт /holyarrs, дивись Зворотний проксі та URL base.

Permission denied

Ознака: doctor каже, що тека недоступна для запису, або імпорти падають із помилкою прав доступу.

Причина: власник теки на хості не збігається з PUID і PGID.

Рішення: виконай chown, який пропонує doctor, або встанови PUID і PGID власника теки. На NAS дай цьому користувачу читання й запис на екрані прав доступу. Дивись NAS, Synology та Unraid.

Нічого не завантажується

Ознака: тайтли лишаються відсутніми, і до завантажувача нічого не доходить.

Причина: жодне джерело не відповідає, завантажувач не підключений або жоден реліз не проходить твої правила вибору.

Рішення:

1. Відкрий Settings > Downloaders (Налаштування > Завантажувачі) і натисни Test (перевірити) біля свого завантажувача. Перевірка має пройти.
2. Відкрий Settings > Sources (Налаштування > Джерела) і натисни Test біля кожного джерела.
3. На сторінці тайтла відкрий Choose a release (обрати реліз), щоб побачити всі результати й причини, чому їх не обрано.

Дивись Завантажувачі і Джерела.

Завантажено, але не імпортовано

Ознака: завантаження завершилося в завантажувачі, але тайтла немає в Бібліотеці.

Причина: HolyArrs не бачить файл за тим самим шляхом, не може записувати в теку бібліотеки, або імпорт потребує рішення.

Рішення:

1. Дай HolyArrs і завантажувачу одну й ту саму теку завантажень за одним шляхом, наприклад /downloads, або заповни Downloader’s path (шлях завантажувача) і HolyArrs’ path (шлях HolyArrs) у завантажувачі.
2. Запусти doctor і виправ кожен FAIL щодо теки завантажень або теки бібліотеки.
3. Перевір у списку завантажень елементи з позначкою Needs a decision (потрібне рішення) і схвали або відкинь план.

Імпорти є копіями, а не hardlink

Ознака: doctor каже, що hardlink не працюють, або після імпортів використання диска подвоюється.

Причина: теки завантажень і бібліотеки лежать на різних дисках або монтуваннях.

Рішення: змонтуй у контейнер одну спільну батьківську теку замість окремих. Дивись Теки.

HolyArrs не запускається

Ознака: контейнер зупиняється або одразу перезапускається.

Причина: її називає лог. Часті випадки: /config на мережевому ресурсі або шляху FUSE, чи зламаний розділ.

Рішення:

1. Якщо лог про це каже, перенеси /config на локальний диск. HolyArrs не запускає свою базу даних на мережевому ресурсі.
2. Інакше запусти в безпечному режимі, виправ усе в Settings (Налаштування) і перезапусти як звичайно.

Бракує функції

Ознака: функції, про яку ти читав, немає в застосунку.

Причина: у цій версії її могли відкласти.

Рішення: дивись Відкладені функції.

На сторінках немає назв чи картинок

Ознака: тайтли показано без постерів і подробиць.

Причина: сервер метаданих недоступний.

Рішення: перевір DNS і брандмауер. Розділ Network у doctor показує, чи відповідає сервер.

Для досвідчених

Перевірки doctor і параметри

Doctor працює всередині контейнера від того самого користувача, що й HolyArrs, тож натрапляє на те саме, що й HolyArrs.

Розділ	Що показує
App	Версія, користувач і група, umask, чи працює в контейнері.
Config folder	Власник, права, вільне місце, чи лежить на локальному диску.
Library and download folders	Чи існує, власник, чи доступна для запису, вільне місце, hardlink між теками завантажень і бібліотеки.
Network	Чи розв’язується ім’я сервера метаданих і чи він відповідає.
Clock	Час, часовий пояс (TZ), попередження, якщо годинник явно неправильний.

Параметр	Що робить
-config <folder>	Перевіряє іншу теку конфігурації HolyArrs, а не /config.
-json	Виводить звіт у JSON.

Код виходу 0 означає, що жодна перевірка не завершилася помилкою; 1 означає, що один із рядків має FAIL. У звіті ніколи не показуються ключі, паролі чи токени. Він лише читає, окрім невеликого тестового файлу, який створює й видаляє. Якщо запущений від root, він також передає теку конфігурації користувачу PUID:PGID, як і звичайний запуск.

Якщо HolyArrs постійно перезапускається, docker exec не спрацює. Запусти doctor у новому контейнері з тими самими теками:

docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> -e TZ=<tz> holyarrs/holyarrs:<tag> doctor

З Compose: docker compose run --rm holyarrs doctor.

Перевірка тек під час запуску

Під час запуску HolyArrs перевіряє свої теки й записує в лог один підсумковий рядок, наприклад folders: 4 ok, 1 not writable, а далі по одному рядку на кожну проблемну теку з рішенням. Перевірка зупиняється через 3 секунди, щоб запуск ніколи не зависав. Тека, що відповідає надто повільно, вважається неперевіреною; часто це диск, що прокидається зі сну, або повільний мережевий ресурс. Doctor перевіряє її без обмеження за часом. Дивись Логи.

В образі немає shell

Образ містить лише програму HolyArrs, тому він невеликий і дає менше можливостей для зловмисника. docker exec holyarrs sh не спрацює навмисно. Щоб розглянути зблизька, запусти поруч одноразовий помічник:

docker run --rm -it --pid container:holyarrs --network container:holyarrs --volumes-from holyarrs busybox sh

Він бачить процес HolyArrs, ділить із ним мережу й має ті самі теки за тими самими шляхами. Він працює від root, тож лише дивись, нічого не змінюй: файл, записаний від root, HolyArrs може не змогти прочитати. Щоб перевірити від імені користувача HolyArrs, додай --user <PUID>:<PGID>.

Як дізнатися версію

docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

Те саме показує розділ App у doctor.

Пов’язане

• Підтримка
• Логи
• Перевірки справності