Wersja przenośna

Konfiguracja

Uruchom HolyArrs jako zwykły program na Linuksie lub Windowsie, bez Dockera. Docker nadal jest głównym sposobem uruchamiania.

Zanim zaczniesz

Python 3, Git i Docker na komputerze, na którym budujesz.
Wypełniony cache modułów Go po normalnym zbudowaniu projektu oraz zależności frontendu zainstalowane z app/frontend/package-lock.json.
Zbudowana aplikacja webowa zatwierdzona w repozytorium. Build używa tylko zatwierdzonych źródeł; niezatwierdzone zmiany są pomijane.

Zbuduj i uruchom

Z checkoutu zbuduj archiwa:

python deploy/release/package.py --ref HEAD --version 1.0.0 --output /srv/holyarrs-archives/1.0.0 --web-node-modules app/frontend/node_modules --module-cache /home/you/go/pkg/mod

Użyj nowego folderu wyjściowego poza checkoutem. Zobaczysz jedno archiwum na każdy cel i plik SHA256SUMS.

Sprawdź archiwum z SHA256SUMS.
Rozpakuj je do nowego folderu. Trzymaj program i konfigurację w osobnych folderach.

Uruchom go ze swoją ścieżką konfiguracji:

./holyarrs -config /srv/holyarrs/config -addr :6262

W Windows PowerShell:

.\holyarrs.exe -config 'C:\HolyArrs\config' -addr ':6262'

Otwórz http://your-server:6262. Powinien pojawić się kreator pierwszego uruchomienia. Od razu utwórz konto właściciela; właścicielem zostaje pierwszy odwiedzający.

Opcje

Pod jakim użytkownikiem działa

Uruchamiaj HolyArrs pod jego własnym kontem, z dostępem do zapisu tylko do konfiguracji i twoich multimediów.

Jako root poza kontenerem, bez PUID i PGID, zatrzymuje się z komunikatem „started as root outside a container“.
Z ustawionymi PUID i PGID przekazuje folder konfiguracji temu użytkownikowi i przełącza się na niego.
W Windowsie zabezpiecz folder konfiguracji uprawnieniem NTFS dla tego konta.

Restarty i limity

Archiwum nie instaluje żadnej usługi. Automatyczny restart i twarde limity pamięci RAM ustaw we własnym menedżerze usług (systemd, NSSM, Harmonogram zadań). Restart z aplikacji i przywracanie backupu kończą działanie programu i oczekują, że zostanie uruchomiony znowu.

Aktualizacja i powrót do poprzedniej wersji

Sprawdź nowe archiwum, zanim zatrzymasz aplikację.
Zatrzymaj HolyArrs i skopiuj cały folder konfiguracji, razem z kluczem głównym. Albo zrób backup w aplikacji i trzymaj jego klucz osobno.
Rozpakuj nowy program do innego folderu. Zostaw stary program i starą kopię konfiguracji.
Uruchom nowy program na swojej konfiguracji. Powinno dać się zalogować, a /health powinno pokazywać running.

Zobacz Backupy.

Jeśli to nie działa

Objaw	Przyczyna	Rozwiązanie
„started as root outside a container“	Uruchomiono jako root	Uruchom go jako osobny użytkownik albo ustaw `PUID` i `PGID`.
Aplikacja kończy działanie po przywracaniu	Przywracanie przygotowuje dane i kończy działanie z kodem 75	Uruchom ją znowu, żeby je zastosować. Ustaw swój menedżer usług, żeby ją restartował.
Połączenia HTTPS zawodzą na Linuksie	Brak systemowych certyfikatów CA	Zainstaluj je.
Build zgłasza, że folder wyjściowy już istnieje	Istniejące foldery wyjściowe są odrzucane	Wybierz nowy folder.

Dla zaawansowanych

Opcje budowania

Opcja	Co robi	Domyślnie
`--targets`	Podzbiór do zbudowania, oddzielony przecinkami	`linux-amd64,linux-arm64,linux-armv7,windows-amd64`
`--low-resource`	Każdy kontener budujący dostaje 1 CPU, 2 GiB i 256 procesów; Go buduje jeden pakiet naraz. Pakowanie nadal działa na hoście, poza tymi limitami.	wyłączone

Build działa w przypiętym image budującym Go z projektu, bez sieci, więc niczego nie pobiera. Cache modułów jest zamontowany tylko do odczytu. Jeśli którykolwiek cel zawiedzie, nie zostaje żaden folder wyjściowy. Commit jest dodawany do numeru wersji i wbudowany w program; aplikacja i jej backupy go zgłaszają.

Co zawiera archiwum

Program, licencję, informacje o komponentach zewnętrznych, przewodniki, manifest źródeł i tożsamość pakietu. Osobne archiwum ze źródłami zawiera źródła projektu i zależności Go; trzymaj je obok plików binarnych.

SHA256SUMS dowodzi, że pliki się zgadzają. To nie jest podpis. Ten sam commit, ta sama wersja i te same dane wejściowe dają te same archiwa, więc możesz zbudować ponownie, żeby sprawdzić.

Uwagi o działaniu

Temat	Szczegół
Ścieżka konfiguracji	Domyślnie `/config`. Zawsze podawaj `-config`, na dysku lokalnym.
Cel pamięci RAM	384 MiB bez `GOMEMLIMIT`. Ustaw na około 80 procent pamięci, którą przydzielasz. To cel, nie twardy limit.
Tryb niskiego zużycia pamięci	Na Linuksie włącza się sam przy około 2.5 GiB lub mniej; cel spada do jednej czwartej pamięci, między 192 a 384 MiB. Decyduje `HOLYARRS_LOW_MEMORY=1` lub `0`.
Node	Niepotrzebny do uruchomienia.
Hardlinki	Trzymaj pobrane pliki i foldery biblioteki na jednym systemie plików.

Powiązane strony

HolyArrs jest darmowy. Jeśli oszczędził ci czas, daj mu gwiazdkę na GitHubie, zostań sponsorem albo postaw mi kawę.