Zarządzanie serwerem

Podstawowe operacje zarządzania serwerem w SGS Hub.

Panel kontrolny serwera

Po utworzeniu serwera, kliknij jego nazwę w Dashboardzie aby otworzyć panel kontrolny.

Widok główny zawiera:

• Header - Nazwa serwera, status, podstawowe przyciski akcji
• Quick Stats - CPU, RAM, Disk usage, Uptime, Players online
• Tabs Navigation - Zakładki z różnymi funkcjami

Dostępne zakładki:

Zakładka	ARK	FiveM	Opis
Overview	✅	✅	Podsumowanie, statystyki, szybkie akcje
Console	✅	✅	Konsola w czasie rzeczywistym, wykonywanie komend
Mods	✅	❌	Zarządzanie modami ARK (CurseForge, Steam Workshop)
Resources	❌	✅	Zarządzanie zasobami FiveM
Files	✅	✅	Edycja plików konfiguracyjnych
Backups	✅	✅	Tworzenie i przywracanie kopii zapasowych
Schedules	✅	✅	Harmonogramy automatycznych zadań
Settings	✅	✅	Ustawienia zaawansowane

Nawigacja

Zakładki dostosowują się do typu gry. Serwery ARK mają zakładkę Mods, serwery FiveM mają Resources.

Kontrola energii

Przyciski kontroli energii znajdują się w headerze panelu serwera.

Start serwera

Kiedy używać: Serwer jest w statusie STOPPED

Jak uruchomić:

1. Kliknij przycisk Start (▶️)
2. Status zmieni się na STARTING
3. Obserwuj logi w zakładce Console
4. Po ~1-5 minutach status zmieni się na RUNNING

Co się dzieje:

• SGS Hub wysyła request do Pterodactyl API: POST /api/client/servers/{id}/power
• Pterodactyl uruchamia kontener Docker
• Proces serwera (ARK/FiveM) startuje
• Serwer ładuje mapę, mody, konfigurację
• Po zakończeniu ładowania, serwer jest dostępny dla graczy

Pierwsze uruchomienie ARK

Pierwsze uruchomienie serwera ARK może trwać 30-40 minut dla dużych map. Zobacz Tworzenie serwera dla szczegółów.

Stop serwera

Kiedy używać: Serwer jest w statusie RUNNING, chcesz go zatrzymać

Jak zatrzymać:

1. Kliknij przycisk Stop (⏹️)
2. SGS Hub wysyła komendę graceful shutdown
3. Status zmieni się na STOPPING
4. Serwer zapisuje stan gry
5. Po ~30-60 sekundach status zmieni się na STOPPED

Graceful vs Force shutdown:

• Graceful (domyślny) - Serwer zapisuje dane, gracze dostają ostrzeżenie, proces kończy się czysto
• Force (przytrzymaj Shift + kliknij Stop) - Natychmiastowe zabicie procesu, ryzyko utraty danych!

Uwaga na Force shutdown

Używaj Force shutdown tylko gdy:

• Serwer zawiesił się i nie odpowiada
• Graceful shutdown nie działa przez 5+ minut
• Jest to sytuacja awaryjna

Force shutdown może spowodować korupcję save'ów i utratę postępów graczy!

Restart serwera

Kiedy używać:

• Po instalacji modów
• Po zmianie ustawień w INI
• Jako rutynowa konserwacja (restart co 6-12h)
• Gdy serwer działa wolno (memory leak)

Jak zrestartować:

1. Kliknij przycisk Restart (🔄)
2. Serwer wykona graceful shutdown
3. Następnie automatycznie startuje ponownie
4. Całość trwa ~2-6 minut (zależnie od gry i mapy)

Best practices:

• Ustaw automatyczny restart przez Schedules (np. restart o 4:00 AM)
• Przed restartem użyj komendy broadcast aby ostrzec graczy
• Wykonaj backup przed restartem jeśli dokonałeś dużych zmian

Sekwencja restart + backup: Zobacz Harmonogramy aby dowiedzieć się jak stworzyć automatyczną sekwencję: backup → broadcast → restart.

Konsola w czasie rzeczywistym

Zakładka Console pokazuje logi serwera w czasie rzeczywistym przez połączenie WebSocket.

Przeglądanie logów

Funkcje konsoli:

• Live streaming - Logi pojawiają się natychmiast, bez odświeżania strony
• Auto-scroll - Automatyczne przewijanie do najnowszych wpisów (można wyłączyć)
• Search/Filter - Filtrowanie logów po tekście (np. "ERROR", "player joined")
• Copy - Kopiowanie logów do schowka
• Download - Pobierz pełne logi jako plik .txt

Typowe wpisy w logach:

ARK:

[2025-10-26 12:00:15] Primal Game Data Loaded
[2025-10-26 12:01:23] Server: "TheIsland" has successfully started!
[2025-10-26 12:05:44] Player 'John' (SteamID: 76561198012345678) joined
[2025-10-26 12:15:30] Player 'John' tamed a Rex - Lvl 120

FiveM:

[2025-10-26 12:00:15] Server license key authenticated
[2025-10-26 12:00:17] Starting resource: [system]/sessionmanager
[2025-10-26 12:01:05] Server started. Join at cfx.re/join/xxxxx
[2025-10-26 12:05:22] Player connecting: John (license:1234...)

Debugowanie

Gdy coś nie działa, konsola to pierwsze miejsce do sprawdzenia. Szukaj wpisów zawierających "ERROR", "WARNING", "FAILED".

Wykonywanie komend

Możesz wysyłać komendy do serwera bezpośrednio z konsoli SGS Hub.

Jak wysłać komendę:

1. Otwórz zakładkę Console
2. Kliknij w pole input na dole
3. Wpisz komendę
4. Naciśnij Enter lub kliknij Send

Popularne komendy ARK:

Komenda	Opis
broadcast <message>	Wyślij wiadomość do wszystkich graczy
saveworld	Zapisz stan gry ręcznie
listplayers	Lista aktywnych graczy
kickplayer <Steam64ID>	Wyrzuć gracza
destroywilddinos	Respawn wszystkich dzikich dinozaurów

Popularne komendy FiveM:

Komenda	Opis
restart <resource>	Zrestartuj zasób
stop <resource>	Zatrzymaj zasób
status	Status serwera i lista graczy
kick <id> <reason>	Wyrzuć gracza
clientkick <id>	Wyrzuć gracza (klient)

RCON hasło

Niektóre komendy ARK wymagają autentykacji admin. SGS Hub automatycznie używa RCON hasła skonfigurowanego podczas tworzenia serwera.

Historia komend:

• Użyj strzałek ↑/↓ aby przeglądać historię wcześniej wysłanych komend
• Historia zapisuje ostatnie 50 komend

Monitorowanie statusu

Metryki serwera są wyświetlane w zakładce Overview i aktualizują się automatycznie co 10 sekund.

Metryki serwera

Status

• RUNNING (zielony) - Serwer działa normalnie
• STOPPED (szary) - Serwer zatrzymany
• STARTING (żółty) - Serwer się uruchamia
• STOPPING (pomarańczowy) - Serwer się zatrzymuje
• ERROR (czerwony) - Błąd, serwer nie odpowiada

CPU Usage (Użycie procesora)

• Procentowe użycie CPU przydzielone kontenerowi
• Zakres: 0-100% (lub więcej dla multi-core)
• Normalne: 20-60% dla aktywnego serwera ARK
• Ostrzeżenie jeśli > 80% przez dłuższy czas

RAM Usage (Użycie pamięci)

• Aktualne użycie RAM vs limit
• Przykład: 3.2 GB / 8.0 GB (40%)
• ARK: Zwykle 4-8 GB dla średniego serwera
• FiveM: Zwykle 1-3 GB
• Ostrzeżenie: Jeśli zbliża się do limitu, serwer może crashować

Disk Usage (Użycie dysku)

• Zajęta przestrzeń dyskowa
• ARK: ~40-60 GB (gra + mody + saves)
• FiveM: ~10-30 GB (resources + cache)
• Alert: Brak miejsca na dysku = brak możliwości zapisu save'ów!

Uptime

• Czas od ostatniego uruchomienia
• Format: "2d 14h 35m" (2 dni, 14 godzin, 35 minut)
• Resetuje się po każdym restarcie

Monitoring

Jeśli serwer często crashuje (uptime < 1h), sprawdź:

1. Użycie RAM - możliwe memory leak
2. Logi w Console - szukaj błędów
3. Konflikty modów - wyłącz mody jeden po drugim aby zidentyfikować problem

Aktywni gracze

W sekcji Players (zakładka Overview) zobaczysz:

Lista aktywnych graczy (ARK):

• Nazwa gracza (in-game name)
• Steam ID (SteamID64)
• Czas połączenia (duration)
• Ping (latency)

Lista aktywnych graczy (FiveM):

• Player ID (server ID)
• Nazwa gracza
• Identyfikatory (license, steam, discord)
• Ping

Funkcje:

• Kick - Wyrzuć gracza z serwera (wymaga uprawnień admin)
• Ban - Zbanuj gracza (tylko FiveM z txAdmin)
• Message - Wyślij prywatną wiadomość (ARK)

Brak graczy na liście?

• Sprawdź czy serwer jest w statusie RUNNING
• ARK: Gracze pojawiają się po pełnym załadowaniu (spawn na mapie)
• FiveM: Gracze widoczni od razu po połączeniu

Limity zasobów

Według planu subskrypcji

Każdy plan subskrypcji ma określone limity zasobów. Przekroczenie limitów uniemożliwia wykonanie akcji (np. tworzenie backupu) do momentu upgrade'u planu lub zwolnienia zasobów.

Limity według planów:

Zasób	Free	Starter	Pro	Enterprise
Serwery	0 (demo)	1	3	10
Mody (ARK)	10	25	50	100
Resources (FiveM)	20	50	100	200
Backupy	3	10	30	100
Harmonogramy	2	5	15	50
Przestrzeń dyskowa (per serwer)	20 GB	50 GB	100 GB	250 GB
RAM (per serwer)	2 GB	4 GB	8 GB	16 GB
CPU (per serwer)	1 core	2 cores	4 cores	8 cores

Optymalizacja zasobów

Jeśli zbliżasz się do limitu:

• Mody: Usuń nieużywane mody
• Backupy: Usuń stare backupy (zostaw ostatnie 5-7)
• Disk: Usuń stare pliki logów, nieużywane saves

Ostrzeżenia o przekroczeniu limitów

Jak system reaguje:

1. Soft limit (ostrzeżenie)

• Gdy osiągniesz 80% limitu, zobaczysz żółty banner w panelu
• Możesz nadal wykonywać akcje, ale zalecany jest upgrade

2. Hard limit (blokada)

• Gdy osiągniesz 100% limitu, akcje są blokowane
• Przykład: Próba instalacji 51. moda na planie Pro wyświetli błąd

Komunikaty błędów:

❌ Limit modów przekroczony (50/50)
Upgrade do planu Enterprise aby zainstalować więcej modów.
[Upgrade Plan]

❌ Brak miejsca na dysku (98/100 GB)
Usuń nieużywane pliki lub upgrade do wyższego planu.
[Manage Files] [Upgrade Plan]

Automatyczne akcje przy przekroczeniu:

• RAM przekroczony: Serwer może crashować, auto-restart po 3 crashach w ciągu godziny
• Disk przekroczony: Blokada zapisu (saves, logs, backupy) - KRYTYCZNE!
• CPU przekroczony: Throttling (spowolnienie serwera), ale bez crashów

Disk limit to najważniejszy!

Jeśli osiągniesz 100% limitu dysku:

1. Serwer nie zapisze postępów graczy
2. Backupy nie będą tworzone
3. Mody nie zainstalują się

Natychmiast zwolnij miejsce lub upgrade planu!

Monitoring limitów:

• Zakładka Overview → Sekcja "Resource Usage"
• Dashboard → "Quick Stats" (wszystkie serwery łącznie)
• Notyfikacje email przy 90% i 100% limitu (konfiguruj w Settings)

Następne kroki

Przejdź do Konfiguracji zaawansowanej aby poznać zaawansowane opcje.