Moduły i tryb awaryjny

Wyłącz moduły, których nie używasz, uruchom w trybie awaryjnym, gdy coś się psuje, i restartuj HolyArrs z przeglądarki.

Włącz lub wyłącz moduł

HolyArrs ma 5 modułów: Movies (filmy), TV shows (seriale), Music (muzyka), Subtitles (napisy) i Requests (prośby). Wybierasz je po raz pierwszy w kreatorze pierwszego uruchomienia.

1. Otwórz Settings > Parts (Ustawienia > Moduły).
2. Kliknij Turn on (włącz) lub Turn off (wyłącz) obok modułu. Jego pozycje w menu powinny się pojawić albo zniknąć.

Nic nie jest usuwane. Włącz moduł ponownie, a wróci tam, gdzie skończył.

Uruchom w trybie awaryjnym

Tryb awaryjny uruchamia tylko podstawy, na wypadek gdy coś blokuje start lub działanie HolyArrs. Możesz się zalogować, przeglądać bibliotekę, zmieniać ustawienia oraz robić i przywracać backup. Wyszukiwanie, dodawanie, odświeżanie, pobieranie i import czekają do następnego normalnego startu.

1. Otwórz Settings > Danger zone (Ustawienia > Strefa zagrożenia).
2. Kliknij Restart in safe mode (uruchom ponownie w trybie awaryjnym). Na każdej stronie zobaczysz baner.
3. Napraw problem, a potem kliknij Restart HolyArrs (uruchom ponownie HolyArrs). Następny start jest już normalny.

Jeśli nie możesz wejść na tę stronę, ustaw HOLYARRS_SAFE_MODE=1 w Compose albo uruchom z -safe-mode. Po naprawie usuń to: oba sposoby zostawiają każdy start w trybie awaryjnym.

Opcje

Co się zatrzymuje, gdy moduł jest wyłączony

Moduł	Zatrzymuje	Działa dalej
Movies	Strony filmów i pozycje menu, dodawanie, wyszukiwanie, odświeżanie	Pobierania, które już są w twoim downloaderze, nadal są śledzone. Pliki zostają.
TV shows	Strony seriali, dodawanie, wyszukiwanie, wyszukiwanie sezonów, odświeżanie	Tak samo jak Movies.
Music	Strony wykonawców i albumów, ustawienia muzyki, odświeżanie wykonawców, wyszukiwanie albumów	Tak samo jak Movies.
Subtitles	Ustawienia napisów, strona brakujących napisów, wyszukiwania i kontrole	Pliki napisów obok twoich filmów zostają.
Requests	Strony próśb i proszenie o tytuły	Istniejące prośby zostają i wracają po ponownym włączeniu.

Zawsze włączone: logowanie i konta, foldery biblioteki, źródła, downloadery i pobierania, powiadomienia, historia, backupy, kontrole kondycji, ustawienia i API.

• Napisy wymagają modułu Movies lub TV shows. Prośby wymagają Movies, TV shows lub Music. HolyArrs odrzuci zmianę, która to łamie, i powie, co trzeba zmienić najpierw.
• Zadanie w kolejce dla wyłączonego modułu czeka i wykona się, gdy moduł zostanie włączony.
• Wyłączenie modułu nie oszczędza pamięci RAM. Wszystko działa w jednym programie.

Restart, wstrzymanie i wyłączenie

Settings > Danger zone (właściciel i administratorzy) ma Restart HolyArrs, Restart in safe mode i Shut down (wyłącz), a także Pause (wstrzymaj), Resume (wznów) i Restart dla każdego zadania w tle, na przykład backupów albo synchronizacji pobierań.

• Przyciski, które coś zatrzymują, proszą o potwierdzenie w ciągu 60 s.
• Każdy użyty przycisk trafia do historii wraz z twoją nazwą.
• Potrzebujesz logowania hasłem. Logowanie bez hasła w sieci lokalnej jest odrzucane.

Restart zatrzymuje HolyArrs w czysty sposób i pozwala Dockerowi uruchomić go znowu, więc ustaw restart: unless-stopped.

Polityka restartu	Restart	Wyłączenie
unless-stopped lub always	Wraca	Też wraca
on-failure	Wraca	Zostaje wyłączony
no	Zostaje wyłączony	Zostaje wyłączony

Jeśli to nie działa

Objaw	Przyczyna	Rozwiązanie
HolyArrs nie może wyłączyć modułu	Potrzebuje go inny moduł	Najpierw wyłącz ten moduł, tak jak mówi komunikat.
Restart wyłączył HolyArrs na dobre	Polityka restartu to no	Uruchom kontener i ustaw restart: unless-stopped.
Przyciski są odrzucane	Lokalne logowanie bez hasła albo klucz nie ma control	Zaloguj się hasłem.
Zadanie zostaje w stanie failed	Potrzebuje ciebie	Przeczytaj jego przyczynę na /health, napraw problem i kliknij Restart przy tym zadaniu.

Więcej rozwiązań: Rozwiązywanie problemów.

Dla zaawansowanych

Stany kondycji

/health, Settings > Parts i GET /api/v1/health/states wymieniają każde zadanie w tle, moduł i połączoną aplikację ze stanem i przyczyną.

Stan	Znaczenie
off	Wyłączone, wstrzymane albo nieuruchomione w trybie awaryjnym.
starting	Uruchamia się albo jeszcze nie sprawdzone.
running	Działa.
retrying	Zawiodło; HolyArrs próbuje ponownie, za każdym razem czekając dłużej.
failed	Wywróciło się, zawiesiło albo potrzebuje ciebie. Przyczyna mówi, co zrobić.

Zadanie, które się wywróciło, pokazuje failed, potem retrying, a potem startuje znowu. Logowanie, biblioteka i backupy działają w tym czasie dalej. Zawieszenie ustępuje po pełnym restarcie.

Pamięć RAM i tryb niskiego zużycia pamięci

HolyArrs stara się zmieścić poniżej 384 MiB, co pasuje do limitu kontenera 500 MB. Żeby ustawić własny cel, ustaw GOMEMLIMIT na około 80 procent pamięci kontenera.

Tryb niskiego zużycia pamięci trzyma mniej w pamięci i częściej czyta z bazy danych. Niektóre strony ładują się chwilę dłużej, a praca w tle, taka jak kopiowanie katalogu muzyki, uruchamia się rzadziej.

Ustawienie	Efekt
(domyślnie, Linux)	Włącza się sam przy około 2.5 GiB pamięci lub mniej.
HOLYARRS_LOW_MEMORY=1	Zawsze włączony.
HOLYARRS_LOW_MEMORY=0	Zawsze wyłączony.

Pierwsza linia logu mówi, czy tryb jest włączony i dlaczego.

Zakresy kluczy API

Utwórz klucz w Settings > API > API keys i wysyłaj go w nagłówku X-Api-Key.

Zakres	Daje dostęp do
read	Biblioteka, zadania, pobierania, historia, kondycja, ustawienia. Sekrety zamaskowane.
health_read	Tylko stany kondycji. Dla narzędzi monitorujących.
write	Każda zmiana poza trasami administracyjnymi i przyciskami sterowania.
admin	Osoby, zaproszenia, limity próśb, klucze API, hasło i uwierzytelnianie dwuskładnikowe, ustawienia logowania, backupy.
control	Przyciski sterowania z tej strony. Przyznać go mogą tylko właściciel i administratorzy.
all	read, write i admin. Bez control.

Klucz nigdy nie może więcej niż osoba, która go utworzyła. Zakresów nie można zmienić później; utwórz nowy klucz. Każda trasa i jej zakres: /api/v1/openapi.json.

Powiązane strony

• Kontrole kondycji
• Backupy
• Trasy API