Dostęp do txAdmin na localhost i testowanie serwera FiveM

txAdmin localhost to pierwszy adres, pod którym większość administratorów FiveM uruchamia panel zarządzania swoim serwerem zanim jeszcze wyślą go na docelową maszynę. Testowanie konfiguracji lokalnie pozwala sprawdzić convary, bazę danych, resource'y i moddowanie bez ryzyka wywrócenia działającej instancji z graczami online. Poniżej krok po kroku pokazuję, jak uruchomić txAdmin na localhost, dostać się do panelu przez przeglądarkę i przygotować konfigurację do bezpiecznego wdrożenia.

Dostęp do txAdmin localhost – pierwsze uruchomienie panelu

txAdmin to natywny panel wbudowany w FXServer od dłuższego czasu, więc nie trzeba go instalować osobno – wystarczy uruchomić plik wykonywalny serwera, a panel sam wystartuje na lokalnym porcie. Domyślnie adres txAdmin localhost wygląda tak:

http://localhost:40120/

Port 40120 to wartość domyślna – jeśli uruchamiasz kilka instancji jednocześnie na tej samej maszynie, FXServer automatycznie przesunie numer portu (40121, 40122 itd.), więc warto zerknąć w konsolę przy starcie, żeby zobaczyć faktyczny adres.

Uruchomienie serwera na Windowsie wygląda standardowo:

cd C:\fivem\server
FXServer.exe +exec server.cfg

Na Linuksie proces jest analogiczny, z tą różnicą, że korzystasz z pliku run.sh:

cd /home/fivem/server
./run.sh +exec server.cfg

Po pierwszym uruchomieniu konsola wyświetli link z jednorazowym tokenem PIN – to on otwiera panel txAdmin przez localhost i pozwala utworzyć konto administratora. Jeśli pracujesz na maszynie zdalnej (np. VPS), a chcesz przetestować panel lokalnie na własnym komputerze przed wdrożeniem, najprostszym podejściem jest instalacja FXServer bezpośrednio na stacji roboczej – wtedy localhost faktycznie odpowiada Twojej maszynie, a nie zdalnemu hostowi.

Jeśli chcesz od razu przejść do wdrożenia środowiska produkcyjnego zamiast testów lokalnych, warto rozważyć hosting FiveM, który pozwala uruchomić gotowe środowisko i przenieść na nie przetestowaną konfigurację bez dodatkowych kroków.

Konfiguracja serwera FiveM do testów lokalnych

Zanim zaczniesz klikać w panelu, warto przygotować podstawowy plik server.cfg – to on determinuje, jakie zasoby załadują się przy starcie i jak zachowa się panel txAdmin na localhost podczas pierwszego połączenia.

Minimalny server.cfg do testów

# server.cfg - konfiguracja testowa
endpoint_add_tcp "127.0.0.1:30120"
endpoint_add_udp "127.0.0.1:30120"

sv_hostname "Test lokalny - txAdmin"
sv_maxclients 8

set txAdminPort 40120
set txAdminVerbose true

ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap

Warto zwrócić uwagę na dwa parametry:

• endpoint_add_tcp / endpoint_add_udp – adres i port, pod którym gracze (lub Ty sam w trybie testowym) łączą się z grą. Zostaw 127.0.0.1 podczas testów lokalnych, aby serwer nie był widoczny na zewnątrz.
• txAdminPort – port samego panelu zarządzania, niezależny od portu gry. To on odpowiada za dostęp przez txAdmin localhost w przeglądarce.

Testowanie modów i resource'ów lokalnie

Panel txAdmin na localhost daje podgląd logów w czasie rzeczywistym, co jest szczególnie przydatne przy debugowaniu skryptów Lua czy resource'ów frameworków typu ESX czy QBCore. Zanim dodasz nowy resource do produkcji, sprawdź go lokalnie:

ensure moj_resource
restart moj_resource
refresh

Komenda refresh przeładowuje listę zasobów bez restartu całego serwera – przydatna, gdy dodajesz pliki do katalogu resources/ w trakcie testów. Pamiętaj, żeby każdy nowy resource miał poprawny fxmanifest.lua, inaczej txAdmin zgłosi błąd ładowania w konsoli panelu.

Jeśli testujesz równolegle kilka modów Minecraft lub konfiguracji innych gier, zasada jest ta sama – lokalne środowisko pozwala wyłapać konflikty plików konfiguracyjnych, zanim trafią na serwer z graczami. Więcej scenariuszy hostingowych znajdziesz na liście wszystkich obsługiwanych gier.

Rozwiązywanie typowych problemów z dostępem do panelu

Dostęp do txAdmin przez localhost zwykle działa od razu, ale kilka sytuacji powtarza się wystarczająco często, by je opisać osobno.

Panel nie odpowiada na porcie 40120

Sprawdź, czy port nie jest zajęty przez inny proces – na Windowsie:

netstat -ano | findstr :40120

Na Linuksie analogicznie:

sudo ss -tulpn | grep 40120

Jeśli port jest zajęty, zmień go bezpośrednio w server.cfg parametrem set txAdminPort 40121 i uruchom serwer ponownie.

Firewall blokuje połączenie lokalne

Na dystrybucjach Linux z aktywnym ufw czasem trzeba jawnie zezwolić na ruch lokalny, zwłaszcza jeśli testujesz z innej maszyny w tej samej sieci:

sudo ufw allow from 192.168.1.0/24 to any port 40120 proto tcp
sudo ufw status verbose

Pamiętaj, że otwieranie portu txAdmin na zewnątrz sieci lokalnej podczas samych testów nie ma sensu i stanowi niepotrzebne ryzyko – panel administracyjny powinien być dostępny tylko z zaufanych adresów.

Błąd "PIN wygasł" przy pierwszym logowaniu

Token PIN generowany przy starcie jest ważny tylko przez krótki czas i tylko dla jednej sesji. Jeśli nie zdążysz go użyć, zrestartuj serwer:

restart
# lub pełny restart procesu
./run.sh +exec server.cfg

Konsola wygeneruje nowy link z aktualnym tokenem – skopiuj go od razu po pojawieniu się, zanim przejdziesz do innych czynności.

Panel ładuje się, ale dane recipe/convars nie zapisują się

To zwykle kwestia uprawnień do zapisu w katalogu serwera. Na Linuksie sprawdź właściciela katalogu:

ls -la /home/fivem/server
sudo chown -R fivem:fivem /home/fivem/server

Panel txAdmin przechowuje część konfiguracji w plikach lokalnych (profil, baza danych SQLite), dlatego proces uruchamiający serwer musi mieć prawo zapisu w katalogu txData/.

Przejście z testów lokalnych do środowiska docelowego

Po zakończeniu testów na localhost kolejnym krokiem jest przeniesienie sprawdzonej konfiguracji na docelową maszynę. Warto zachować spójność między środowiskiem testowym a produkcyjnym, żeby uniknąć niespodzianek.

Co skopiować, a czego nie

• Plik server.cfg – zmień adresy endpoint_add_tcp/udp z 127.0.0.1 na właściwy adres publiczny lub 0.0.0.0.
• Katalog resources/ z przetestowanymi modami i skryptami.
• Nie kopiuj katalogu txData/ jeden do jednego – zawiera on dane sesji i tokeny powiązane z lokalnym profilem, lepiej wygenerować nowy profil administracyjny na docelowej maszynie.

Checklist przed wdrożeniem

Element	Status do sprawdzenia
Hasło administratora panelu	Zmienione na unikalne, nieużywane gdzie indziej
Porty gry i panelu	Dopasowane do docelowej infrastruktury
Resource'y	Przetestowane lokalnie bez błędów w konsoli
Kopia zapasowa konfiguracji	Wykonana przed migracją
RCON	Hasło silne, dostęp ograniczony

Na etapie migracji warto też pomyśleć o regularnych kopiach zapasowych konfiguracji i baz danych – niezależnie od tego, czy serwer działa lokalnie, czy na zdalnej infrastrukturze. Jeśli planujesz uruchomić środowisko na własnej maszynie wirtualnej, panel Pterodactyl ułatwia zarządzanie plikami i konsolą w jednym miejscu – zobacz VPS Pterodactyl jako opcję do samodzielnego zarządzania infrastrukturą.

Administratorzy prowadzący równolegle serwery RP oparte na RedM stosują identyczny schemat testów lokalnych przed wdrożeniem – mechanika txAdmin jest wspólna dla obu silników, więc warto zerknąć też na serwer RedM jeśli planujesz rozszerzenie projektu.

Więcej materiałów technicznych o konfiguracji i administracji serwerami znajdziesz na blogu Fly-Serv, a oficjalną dokumentację panelu warto trzymać pod ręką jako punkt odniesienia: Source.

Testowanie przez txAdmin localhost to najprostszy sposób, by sprawdzić konfigurację, mody i convary zanim trafią do graczy. Dobra praktyka to osobny profil testowy, kopie zapasowe przed migracją i porównanie ustawień portów przed przejściem na środowisko docelowe. Taki schemat pracy oszczędza czas i ogranicza liczbę błędów przy wdrożeniu.

FAQ

Dlaczego panel txAdmin na localhost otwiera się na innym porcie niż 40120?

FXServer automatycznie przesuwa numer portu, jeśli 40120 jest już zajęty przez inną instancję serwera uruchomioną na tej samej maszynie. Sprawdź konsolę przy starcie – wyświetli ona pełny link z aktualnym portem i tokenem.

Czy mogę testować txAdmin localhost bez połączenia internetowego?

Tak, panel działa w pełni lokalnie i nie wymaga połączenia z internetem do uruchomienia ani konfiguracji podstawowych resource'ów. Połączenie zewnętrzne jest potrzebne tylko do pobierania aktualizacji FXServer lub zewnętrznych paczek modów.

Co zrobić, gdy token PIN z konsoli nie działa po skopiowaniu?

Token jest ważny krótko i tylko dla jednej sesji startowej. Zrestartuj proces serwera poleceniem uruchamiającym plik wykonywalny ponownie i skopiuj nowy link natychmiast po jego wygenerowaniu w konsoli.