System
Sekcja techniczna dla administratora. Główne zakładki: Aktualizacja, Bazy geo/cloak, JavaScript oraz Znak wodny. Tutaj aktualizuje się wersję Qubix, zarządza bazami geo/cloak i ustawia limity ochronne.

Aktualizacja
Zakładka pokazuje bieżące wersje i pozwala zaktualizować system do wybranego wydania.
Na górze znajdują się dwie karty wersji:
- qubixd binary — wersja pliku wykonywalnego Qubix (build, data builda, wersja schematu danych).
- live container — wersja działającego kontenera (tag i obraz, wersja updatera).
Jeśli wersja binarki nie zgadza się z tagiem kontenera, pojawia się ostrzeżenie: zwykle oznacza to, że kontener został uruchomiony z pominięciem standardowego procesu aktualizacji, a następna aktualizacja go nadpisze.
Jak uruchomić aktualizację
- W bloku Uruchom aktualizację wpisz docelową wersję — na przykład
1.1.2lublatestdla najnowszej.
- Kliknij Aktualizuj.
- Śledź postęp: system pobiera nowy obraz, zatrzymuje starą wersję, uruchamia nową i sprawdza jej kondycję. Fazy są pokazane jako lista, a po zakończeniu można rozwinąć szczegółowy log.
Jeśli healthcheck nowej wersji się nie powiedzie, Qubix automatycznie wycofuje się do poprzedniego kontenera — niczego nie trzeba robić ręcznie.
W trakcie aktualizacji nie restartuj serwera ani nie zatrzymuj kontenerów ręcznie. Automatyczne wycofanie jest przewidziane wyłącznie na zwykłe niepowodzenie healthchecku. Jeśli wycofanie również się nie powiedzie (skrajnie rzadki przypadek), konieczna będzie ręczna interwencja administratora na serwerze.
Zasoby hosta
Poniżej kart wersji Qubix wyświetla bieżący stan zasobów serwera. Dane są zbierane w tle i odświeżane automatycznie, dzięki czemu strona odzwierciedla aktualną sytuację.
- Wolne miejsce na dysku — wolne miejsce na dysku przechowującym dane.
- Wolna pamięć — dostępna pamięć RAM na serwerze.
- Pamięć procesu Qubix — ile pamięci RAM zajmuje sam proces Qubix. Pozwala szybko sprawdzić, czy to Qubix pochłania pamięć, czy coś innego na serwerze.
- Swap — ile swapu używa proces Qubix. Normalnie wynosi zero; jakakolwiek zauważalna wartość oznacza, że serwerowi zabrakło RAM i zaczął stronicować na dysk, co spowalnia całą pracę.
- Obciążenie CPU — średnie obciążenie procesora z ostatnich 5 minut w przeliczeniu na liczbę rdzeni.

Wiersz pojawia się tylko dla tych metryk, które serwer jest w stanie zmierzyć; na niektórych konfiguracjach dana metryka może być niedostępna i jest wówczas ukryta.
Alerty zasobów
Qubix nie tylko wyświetla te liczby — monitoruje je samodzielnie i wysyła alert Telegram do kanału technicznego, gdy coś jest nie tak:
- kończy się miejsce na dysku (z osobnym, bardziej pilnym alertem przy stanie krytycznym);
- kończy się dostępna pamięć (również z osobnym alertem krytycznym);
- proces Qubix zaczął korzystać ze swapu;
- procesor jest stale mocno obciążony.
Dzięki temu informacja o problemie dociera do administratora, zanim instancja zacznie działać nieprawidłowo — bez konieczności otwierania tej strony. Aby ograniczyć szum, krótkie skoki nie wywołują alertu, a to samo ostrzeżenie nie jest powtarzane zbyt często. Gdy metryka wraca do normy, Qubix wysyła komunikat o odzyskaniu sprawności.
Kanał techniczny jest konfigurowany przez administratora w Połączenia → Telegram. Bez tego alerty nie mają dokąd trafiać.
Proces Qubix nie powinien korzystać ze swapu. Jeśli Swap wykazuje wartość niezerową (lub otrzymają Państwo alert dotyczący swapu), serwerowi brakuje pamięci — należy dodać RAM. Praca ze swapu znacząco spowalnia działanie całego systemu.
Bazy geo/cloak
Bazy geo i cloak używane do detekcji i cloakingu. Zakładka ma dwa tryby aktualizacji:
- Aktualizacje automatyczne — bazy są pobierane z serwera licencji według harmonogramu. Częstotliwość ustawia się w polu Aktualizuj co (w godzinach).
- Aktualizacje ręczne — harmonogram jest wyłączony; bazy aktualizują się tylko przyciskiem Aktualizuj teraz.
Poniżej znajdują się Stan baz (każda baza z jej bieżącym stanem i rozmiarem) oraz Historia aktualizacji — log przebiegów aktualizacji z czasem, bazą, statusem, wyzwalaczem (zaplanowany lub ręczny), rozmiarem i komunikatem.

JavaScript
Limity dla skryptów użytkownika. Te ustawienia zmieniają się w locie i obowiązują wszystkie skrypty naraz. Są pogrupowane w kilka bloków:
- Fetch — reguły wychodzących żądań HTTP ze skryptów:
- Allowlista hostów — lista dozwolonych adresów, po jednym na wiersz. Jeśli lista jest pusta, wychodzące żądania ze skryptów są wyłączone.
- Domyślny timeout i Maks. timeout — domyślny i maksymalny dozwolony timeout żądania (w milisekundach).
- Maks. body — maksymalny rozmiar odpowiedzi w bajtach.
- Maks. wywołań na uruchomienie — ile wychodzących żądań jest dozwolonych na jedno uruchomienie skryptu.
- Runtime — Maks. czas działania skryptu: maksymalny czas wykonania pojedynczego skryptu (w milisekundach).
- SQL — limity zapytań o dane ze skryptów: liczba zapytań na uruchomienie, liczba wierszy na zapytanie, timeouty. Zapytania wykonują się tylko do odczytu i w ramach uprawnień właściciela skryptu.
- Pamięć — limit pamięci; wkrótce, jeszcze niedostępny.
Po edycji kliknij Zapisz.

Gwiazdka * na allowliście pozwala skryptom sięgnąć do dowolnego adresu, w tym wewnętrznych. Należy używać jej świadomie — to odpowiedzialność administratora.
Znak wodny
Limity dla narzędzia do usuwania znaku wodnego. Ustawiają górny pułap rozmiaru wgrywanego obrazu — chroni to serwer przed przeciążeniem pamięci. Obraz przekraczający limit jest odrzucany, zanim w ogóle zostanie przetworzony.
- Maks. megapiksele — maksymalna powierzchnia obrazu (szerokość pomnożona przez wysokość).
- Maks. bok — maksymalna długość każdego z boków, w pikselach.
Po edycji kliknij Zapisz. Pod każdym polem znajduje się podpowiedź z zalecaną wartością.
