Jak skonfigurować txAdmin na swoim serwerze FiveM

Twój serwer wdraża się z uruchomionym txAdmin, a sam serwer gry jest celowo wstrzymany. Pięć kroków w kreatorze uruchamia go online, a jeden z nich, połączenie z bazą danych, to miejsce, w którym prawie wszyscy się zatrzymują, bo ich pola są ukryte za przyciskiem. Przycisk i wartości są na tej stronie.

Najpierw: serwer offline to tutaj norma

Świeże wdrożenie FiveM uruchamia tylko txAdmin i nic więcej. Port gry celowo milczy, dopóki nie zgłosisz konta administratora, nie podasz klucza licencyjnego i nie wybierzesz builda serwera, bo serwer FiveM bez nich nie może wystartować. Więc przez pierwsze kilka minut po wdrożeniu stan, w którym panel pokazuje serwer jako jeszcze nieprzyjmujący graczy, jest oczekiwany, a nie usterką.

Panel to potwierdza: karta serwera żółknie i pokazuje Wymagana akcja: dokończ konfigurację w txAdmin, a po jej otwarciu dostajesz link do txAdmin i kod PIN opisany poniżej. Nic na tej stronie nie wymaga zgłoszenia do wsparcia.

Pięć kroków

1. Otwórz txAdmin

Nie musisz szukać adresu. Otwórz panel: żółty pasek na karcie serwera rozwija się i pokazuje przycisk Otwórz txAdmin, a ten sam przycisk znajduje się na karcie Gracze po kliknięciu Zarządzaj. Wskazuje na własną domenę txAdmin twojego serwera, która działa dalej po failover, bo zawsze rozwiązuje się do tej instancji, która jest aktualnie główna. Dlatego linkujemy ją zamiast wypisywać IP węzła: IP jest poprawne do dnia, w którym przestaje nim być.

2. Zgłoś konto administratora kodem PIN

Przy pierwszym uruchomieniu txAdmin prosi o kod PIN, który wypisuje tylko do konsoli serwera, a potem prosi o utworzenie nazwy użytkownika i hasła głównego administratora dla samego panelu. Na zarządzanym serwerze nie zobaczysz zwykle tej konsoli, więc panel odczytuje PIN z logu kontenera i pokazuje go w tym samym panelu co przycisk txAdmin, gotowy do skopiowania.

Logowanie głównego administratora nie jest twoim kontem Flux, kontem Cfx.re ani hasłem do bazy danych. To trzecie poświadczenie, jest drogą powrotu do twojego panelu i nikt nie może go zresetować za ciebie. Zapisz je, zanim przejdziesz dalej. Jeśli PIN wygasł, zanim go użyjesz, zrestartuj serwer z panelu, a zostanie wypisany nowy.

3. Wybierz build serwera

Kreator oferuje potem przepis albo istniejący serwer. Przepis, taki jak qbcore, qbox lub ESX, pobiera framework, jego zasoby i schemat SQL, a następnie importuje schemat do twojej bazy. To najszybsza droga do działającego serwera RP. Wybierz jeden, a txAdmin pokaże go na ekranie o nazwie Krok 1: Przejrzyj przepis. Kontynuuj, a dotrzesz do ekranu Krok 2: Parametry wejściowe, gdzie odbywają się kolejne dwa kroki.

4. Dodaj klucz licencyjny cfx.re

Pierwsze pole na ekranie Parametry wejściowe to Klucz rejestracyjny serwera. Wygeneruj darmowy klucz na portal.cfx.re i wklej wartość cfxk_. Klucz jest wydawany na twoje konto, a nie na nasze, i właśnie dlatego serwer jest twój do przeniesienia. Wdrożenie ustawia NO_LICENSE_KEY=1, więc klucz podaje się tutaj, a nie wbudowuje w aplikację. Jeśli kiedyś wygenerujesz klucz od nowa, możesz go zmienić później bez przechodzenia kreatora: to pole w zakładce Ustawienia serwera panelu zarządzania.

5. Otwórz opcje bazy danych i połącz bazę

To jest krok, który generuje najwięcej zgłoszeń do wsparcia, bo pola bazy danych są ukryte. Tuż pod kluczem jest szary przycisk Pokaż/Ukryj opcje bazy danych (zaawansowane). Kliknij go. Dopiero wtedy pojawią się pola Host bazy danych, Port, Nazwa użytkownika, Hasło i Nazwa. Jeśli pominiesz ten przycisk, przepis uruchomi się z domyślnymi wartościami txAdmin i połączenie z bazą się nie uda.

Pola są wypełnione wstępnie, z localhost jako hostem i 3306 jako portem. Te wartości są na tym serwerze błędne. Zastąp zawartość każdego pola tymi wartościami:

Hostem jest operator synchronizacji, a nie kontener bazy danych, hasło to to, które wybrałeś przy wdrożeniu, a sama baza jest tworzona pusta dla ciebie przed startem serwera.

Hasło znajduje się w panelu zarządzania w zakładce Ustawienia wdrożenia jako MYSQL_ROOT_PASSWORD, z przyciskiem odsłonięcia i przyciskiem kopiowania. Panel wypisuje też cztery stałe wartości na karcie obok, więc możesz wkleić je bezpośrednio do txAdmin bez wracania tutaj.

Warto wymienić dwa domysły, bo oba są błędne i oba wyglądają poprawnie. Host to nie localhost: txAdmin i baza danych to osobne kontenery. Host to też nie mariadb, mimo że istnieje komponent o tej nazwie. Wszystko przechodzi przez operatora, który replikuje każdy zapis do pozostałych instancji; pisanie prosto do jednego MariaDB zdesynchronizowałoby twoje miasto i straciłoby je przy failover.

Następnie uruchom przepis. txAdmin pobiera artefakt FiveM, importuje schemat, zapisuje server.cfg i startuje serwer, a twój panel zrobi się zielony w ciągu kilku minut. Jeśli wybrałeś istniejący serwer zamiast przepisu, nie ma pól bazy danych do wypełnienia: ustaw połączenie w swoim server.cfg, jak pokazano w pytaniach poniżej.

Jeśli txAdmin mówi, że nie może się połączyć

Najpierw sprawdź host i port, bo localhost i mariadb to typowe domysły i żadne z nich nie działa. Jeśli te są poprawne, to niezgodność hasła. Baza jest tworzona z MYSQL_ROOT_PASSWORD, a operator uwierzytelnia się przez DB_INIT_PASS, i te dwa muszą być identyczne, żeby baza w ogóle się zainicjowała. Panel łączy je właśnie w tym celu: edycja jednego przepisuje drugi, a pole jest oznaczone jako powiązane, żeby zachowanie nie wyglądało jak odrzucanie danych wejściowych przez formularz. To, co wpiszesz w txAdmin, musi być dokładnie tą samą wartością.

Wracanie później

Po kreatorze txAdmin jest codziennym panelem: konsola na żywo, zasoby, bany, edytor CFG i zaplanowane restarty. Ten sam przycisk Otwórz txAdmin prowadzi tam, a logujesz się kontem głównego administratora z kroku 2. Panel obejmuje też warstwę pod spodem: restarty i ponowne wdrożenia, przeglądarkę plików, sprzęt, stan bazy danych na wszystkich węzłach oraz backupy.

Najczęściej zadawane pytania