Отстраняване на проблеми

Намери своя проблем, прочети причината, следвай решението. Примерите използват името на контейнера holyarrs; ползвай твоето, ако е различно.

Първите 3 проверки

1. Гледай дневника (log): docker logs -f holyarrs. Тайните са скрити. Натисни Ctrl+C, за да спреш следенето; контейнерът продължава да работи.
2. Пусни проверката doctor: docker exec holyarrs /holyarrs doctor. Всеки ред казва OK, WARN или FAIL, а всеки WARN или FAIL казва как да го оправиш.
3. Още ли си затруднен? Свали пакет за поддръжка и попитай. Виж Получи помощ.

Не мога да стигна до уеб страницата

Проблем: браузърът не може да се свърже с http://your-server:6262.

Причина: контейнерът е спрян, портът не е пренасочен или на пътя има proxy.

Решение:

1. Изпълни docker ps. Трябва да видиш holyarrs с 0.0.0.0:6262->6262.
2. Ако непрекъснато се рестартира, прочети docker logs holyarrs за причината.
3. Ако ползваш път като /holyarrs, виж Reverse proxy и URL base.

Отказан достъп (Permission denied)

Проблем: doctor казва, че в папка не може да се пише, или импортирането се проваля с грешка за права.

Причина: собственикът на папката на host-а не съвпада с 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 (твърда връзка) не работят, или заетото място на диска се удвоява след импортиране.

Причина: папките за изтегляния и на Библиотеката са на различни дискове или монтирания, или дискът не може да прави hardlink (DrivePool, много NAS и SMB мрежови папки, Docker Desktop на Windows). Всеки файл пак се записва само веднъж. Готовите Usenet изтегляния се преместват, когато са на един диск с Библиотеката.

Решение: монтирай в контейнера една обща родителска папка вместо отделни. Виж Папки.

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 показва същото.

Свързано

• Получи помощ
• Дневници
• Проверки на здравето