Przewodnik rozwiązywania typowych problemów z serwerem RedM, w tym błędów klucza licencyjnego, widoczności w przeglądarce serwerów, awarii zasobów, połączeń klientów, problemów z bazą danych oraz optymalizacji wydajności. Aby uzyskać instrukcje początkowej konfiguracji, zobacz nasz Przewodnik konfiguracji serwera RedM.
Błędy klucza licencyjnego
Problemy z kluczem licencyjnym to najczęstszy problem przy uruchamianiu nowego serwera RedM. Oto typowe błędy i ich rozwiązania:
„Invalid license key" lub „Could not authenticate"
| Przyczyna | Rozwiązanie |
|---|---|
| Klucz licencyjny jest błędnie wpisany lub ma dodatkowe spacje | Skopiuj klucz bezpośrednio z Keymaster. Usuń wszelkie początkowe/końcowe białe znaki ze zmiennej startowej CFX_LICENSE w GPanel lub z linii sv_licenseKey w server.cfg. |
| Niezgodność adresu IP | Klucz jest zarejestrowany dla innego adresu IP niż rzeczywisty adres IP serwera. Przejdź do Keymaster, sprawdź zarejestrowany adres IP i zaktualizuj go, aby odpowiadał adresowi IP serwera widocznemu w GPanel. |
| Klucz ustawiony zarówno w GPanel, jak i server.cfg z różnymi wartościami | Upewnij się, że klucz jest spójny. Najlepiej ustawić go w zmiennej startowej GPanel i pozwolić egg na przekazanie go do serwera. Usuń lub zakomentuj sv_licenseKey z server.cfg, jeśli obsługuje to GPanel. |
| Problem z kontem Cfx.re lub odwołany klucz | Zaloguj się do Keymaster i sprawdź, czy klucz jest nadal aktywny. Wygeneruj nowy klucz, jeśli stary został usunięty lub wygasł. |
| Usługa Keymaster jest tymczasowo niedostępna | Sprawdź stronę statusu Cfx.re pod kątem awarii. Poczekaj i spróbuj ponownie później. |
Ważne: Jeśli niedawno otrzymałeś nowy serwer lub adres IP Twojego serwera uległ zmianie (np. po migracji węzła), musisz zaktualizować adres IP w Keymaster lub wygenerować nowy klucz licencyjny. Stary klucz nie będzie działać na innym adresie IP.
Serwer nie pojawia się w przeglądarce
Jeśli Twój serwer działa, ale gracze nie mogą go znaleźć w przeglądarce serwerów RedM:
Lista kontrolna
- Poczekaj co najmniej 5 minut. Po uruchomieniu serwer potrzebuje czasu na rejestrację na liście serwerów głównych Cfx.re. Pojawienie się nowych serwerów może zająć kilka minut.
- Sprawdź, czy klucz licencyjny jest ważny. Serwer nie zostanie wyświetlony bez działającego klucza licencyjnego. Sprawdź konsolę serwera pod kątem błędów związanych z licencją.
- Sprawdź konfigurację punktów końcowych. Upewnij się, że
endpoint_add_tcpiendpoint_add_udpwserver.cfgużywają poprawnego portu:
Port musi odpowiadać temu przydzielonemu w GPanel.endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" - Sprawdź ustawienia „sv_master1" lub ustawienia listowania. Upewnij się, że przypadkowo nie ustawiłeś serwera tak, aby nie umieszczał się na liście. W Twojej konfiguracji nie powinno być
sv_master1 ""(to wyłącza rejestrację na liście głównej). - Sprawdź, czy serwer rzeczywiście działa. Sprawdź konsolę GPanel. Jeśli serwer uległ awarii lub został zatrzymany, nie pojawi się w przeglądarce.
- Wypróbuj połączenie bezpośrednie. Nawet jeśli serwer nie jest w przeglądarce, połączenie bezpośrednie powinno działać. Poproś gracza, aby nacisnął F8 w RedM i wpisał:
connect YOUR_SERVER_IP:PORT
Wskazówka: Możesz sprawdzić, czy Twój serwer jest osiągalny, używając wyszukiwania serwerów Cfx.re. Spróbuj przejść do
http://YOUR_SERVER_IP:PORT/info.json w przeglądarce internetowej. Jeśli serwer działa i jest dostępny, zwróci odpowiedź JSON z informacjami o serwerze.
Awarie wczytywania zasobów
Błędy zasobów są częste przy dodawaniu nowych skryptów lub frameworków do serwera. Oto najczęstsze problemy:
„Could not find resource [resource_name]"
- Folder zasobu nie istnieje w katalogu
resources/lub znajduje się w niewłaściwej lokalizacji. - Nazwa folderu nie odpowiada nazwie użytej w
ensure. W nazwach zasobów rozróżniana jest wielkość liter. - Rozwiązanie: Sprawdź, czy folder zasobu istnieje i czy nazwa w
server.cfgdokładnie się zgadza. Użyj menedżera plików GPanel lub SFTP, aby sprawdzić.
„Failed to load resource [resource_name]: manifest error"
- Plik
fxmanifest.lualub__resource.luazasobu zawiera błąd składni. - Manifest odwołuje się do plików, które nie istnieją w folderze zasobu.
- Rozwiązanie: Otwórz plik manifestu i sprawdź literówki, brakujące przecinki lub odwołania do nieistniejących plików. Sprawdź konsolę serwera pod kątem konkretnego numeru linii błędu.
„Error loading script [filename]: [error details]"
- Plik Lua, C# lub JavaScript w zasobie zawiera błąd składni lub błąd wykonania.
- Rozwiązanie: Przeczytaj pełny komunikat o błędzie w konsoli. Będzie on zawierał nazwę pliku i numer linii. Typowe przyczyny obejmują:
- Brakujące zależności (inny zasób, który musi zostać wczytany jako pierwszy)
- Nieaktualny zasób niezgodny z bieżącą wersją serwera RedM
- Nieprawidłowe wartości konfiguracji w pliku konfiguracyjnym zasobu
Problemy z kolejnością wczytywania zasobów
Zasoby w server.cfg są wczytywane w kolejności, w jakiej się pojawiają. Jeśli zasób zależy od innego (np. vorp_inventory zależy od vorp_core), zależność musi być wymieniona jako pierwsza:
# Correct order - dependencies first
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure vorp_stores
# Wrong order - will cause errors
# ensure vorp_inventory <-- depends on vorp_core
# ensure vorp_core <-- loaded too late
Ostrzeżenie: Jeśli zasób nie zostanie wczytany, wszystkie zasoby, które od niego zależą, również zawiodą. Zawsze dokładnie sprawdzaj dane wyjściowe konsoli, aby zidentyfikować pierwotną przyczynę, którą zwykle jest pierwszy pojawiający się błąd.
Problemy z połączeniem klienta
Gdy gracze nie mogą połączyć się z Twoim serwerem:
„Connection timed out" / „Failed to connect"
| Przyczyna | Rozwiązanie |
|---|---|
| Serwer nie działa | Sprawdź konsolę GPanel, aby potwierdzić, że serwer jest online i nie uległ awarii. |
| Nieprawidłowy adres IP lub port | Sprawdź, czy gracz używa poprawnego adresu IP i portu z GPanel. Zobacz Jak znaleźć adres IP i port serwera. |
| Błędna konfiguracja punktów końcowych | Upewnij się, że endpoint_add_tcp i endpoint_add_udp w server.cfg używają portu 0.0.0.0:PORT, gdzie PORT odpowiada GPanel. |
| Serwer jest pełny | Sprawdź, czy osiągnięto limit sv_maxclients. Zwiększ wartość, jeśli Twój plan hostingowy na to pozwala. |
„Connection rejected by server"
- Hasło serwera: Jeśli ustawiono
sv_password, gracz musi wprowadzić poprawne hasło. - Zasób whitelist/allowlist: Jeśli masz włączony zasób whitelist, gracz musi zostać zatwierdzony przed połączeniem.
- Ban: Gracz może być zbanowany. Sprawdź swoją listę banów lub bazę danych pod kątem jego identyfikatorów.
Klient ulega awarii przy połączeniu
- Zasób na serwerze wysyła nieprawidłowe dane lub ma błąd skryptu po stronie klienta, który powoduje awarię klienta.
- Rozwiązanie: Wyłączaj ostatnio dodane zasoby pojedynczo, aby zidentyfikować problematyczny. Sprawdź konsolę serwera pod kątem błędów podczas łączenia klienta.
- Upewnij się, że klient RedM gracza jest aktualny.
Błędy „Could not download file"
- Serwer próbuje wysłać duży plik (np. zasób strumieniowy), który przekracza limity transferu, lub połączenie jest niestabilne.
- Rozwiązanie: Zmniejsz rozmiar strumieniowanych zasobów, użyj CDN/zewnętrznego hostingu dla dużych plików, jeśli jest obsługiwany, lub poproś gracza o ponowne połączenie.
Problemy z bazą danych (MySQL / oxmysql)
Większość frameworków roleplay RedM używa MySQL do trwałego przechowywania danych. Najczęstszym łącznikiem bazy danych jest oxmysql.
Błędy nieudanego połączenia
Jeśli oxmysql (lub inny łącznik MySQL) nie może się połączyć, sprawdź następujące elementy:
# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"| Błąd | Rozwiązanie |
|---|---|
ECONNREFUSED lub „Connection refused" |
Serwer MySQL nie działa, host/port jest nieprawidłowy lub serwer MySQL nie akceptuje połączeń zewnętrznych. Sprawdź host, port oraz to, czy serwer bazy danych jest online. |
ER_ACCESS_DENIED_ERROR |
Nieprawidłowa nazwa użytkownika lub hasło w ciągu połączenia. Sprawdź dokładnie dane uwierzytelniające w panelu hostingu bazy danych. |
ER_BAD_DB_ERROR |
Nazwa bazy danych nie istnieje. Najpierw utwórz bazę danych za pomocą panelu zarządzania bazą danych (phpMyAdmin itp.). |
ETIMEDOUT |
Serwer bazy danych jest nieosiągalny. Sprawdź, czy istnieją reguły zapory blokujące połączenie, lub czy host bazy danych jest poprawny. |
| „Too many connections" | Baza danych osiągnęła maksymalny limit połączeń. Może się to zdarzyć, jeśli zasoby nie zamykają poprawnie połączeń lub jeśli limit jest zbyt niski. Zrestartuj serwer i sprawdź ustawienie max_connections swojego MySQL. |
Wskazówka: Jeśli Twój serwer RedM i baza danych MySQL znajdują się na tej samej maszynie, użyj
localhost lub 127.0.0.1 jako hosta. Jeśli są na różnych serwerach, użyj adresu IP serwera bazy danych i upewnij się, że użytkownik MySQL ma uprawnienia do połączeń zdalnych.
Brakujące tabele lub błędy schematu
Frameworki roleplay często wymagają skonfigurowania tabel bazy danych, zanim będą mogły działać:
- Sprawdź dokumentację frameworka lub repozytorium GitHub pod kątem plików importu SQL (często nazywanych
database.sql,schema.sqllub podobnie). - Zaimportuj plik SQL do swojej bazy danych za pomocą phpMyAdmin lub klienta MySQL.
- Niektóre frameworki automatycznie tworzą tabele przy pierwszym uruchomieniu. Upewnij się, że użytkownik bazy danych ma uprawnienia
CREATE TABLE.
Problemy z wydajnością
Jeśli Twój serwer RedM doświadcza opóźnień, niskiej częstotliwości tików lub ogólnie słabej wydajności:
Identyfikowanie problemów z wydajnością
Sprawdź konsolę serwera pod kątem ostrzeżeń o wydajności. Serwery RedM celują w częstotliwość tików około 30-64 tików na sekundę. Możesz to monitorować za pomocą:
- Panel txAdmin: Jeśli txAdmin jest dostępny, pokazuje metryki wydajności serwera w czasie rzeczywistym.
- Konsola serwera: Obserwuj ostrzeżenia „slow tick" lub „resource hitch".
- Komenda resmon: Wpisz
resmon 1w konsoli serwera (lub konsoli F8), aby włączyć monitor zasobów, który pokazuje czas CPU na zasób.
Typowe rozwiązania problemów z wydajnością
| Problem | Rozwiązanie |
|---|---|
| Wysokie użycie CPU przez konkretny zasób | Użyj resmon 1, aby zidentyfikować zasób. Rozważ zastąpienie go bardziej zoptymalizowaną alternatywą lub skontaktuj się z deweloperem zasobu. |
| Zbyt wiele wczytanych zasobów | Każdy zasób zużywa zasoby serwera. Przejrzyj listę zasobów i usuń wszystkie nieużywane lub zbędne. |
| Wąskie gardło zapytań do bazy danych | Wolne lub nieindeksowane zapytania do bazy danych mogą powodować zacinanie się serwera. Sprawdź ostrzeżenia o wolnych zapytaniach oxmysql w konsoli. Dodaj indeksy do często odpytywanych kolumn. |
| Wysoka liczba graczy powodująca opóźnienia | Zmniejsz sv_maxclients do poziomu, który sprzęt Twojego serwera może obsłużyć. Rozważ uaktualnienie planu hostingowego dla większej liczby zasobów. |
| Limity encji OneSync | Zbyt wiele utworzonych encji (postaci NPC, pojazdy, obiekty) może obniżyć wydajność. Używaj zasobów, które usuwają nieużywane encje. |
| Wycieki pamięci | Niektóre źle napisane zasoby z czasem powodują wyciek pamięci. Monitoruj użycie pamięci RAM serwera w GPanel. Regularne restarty serwera (co 6-12 godzin) mogą to złagodzić. |
Zalecane praktyki
- Zaplanuj automatyczne restarty co 6-12 godzin za pomocą funkcji harmonogramu GPanel lub txAdmin, aby usunąć nagromadzone problemy z pamięcią i encjami.
- Aktualizuj zasoby, aby korzystać z poprawek wydajności i optymalizacji.
- Unikaj zduplikowanej funkcjonalności — nie uruchamiaj dwóch zasobów, które robią to samo (np. dwóch systemów pogody).
- Testuj nowe zasoby na serwerze testowym (lub z niską liczbą graczy) przed wdrożeniem na głównym serwerze.
- Monitoruj metryki serwera regularnie poprzez GPanel lub txAdmin, aby wcześnie wychwytywać problemy.
Uwaga: Jeśli stale doświadczasz problemów z wydajnością pomimo optymalizacji, Twój serwer może potrzebować planu hostingowego wyższego poziomu z większą ilością zasobów CPU i RAM. Skontaktuj się z naszym zespołem pomocy technicznej, aby omówić opcje uaktualnienia.
Ogólne wskazówki dotyczące rozwiązywania problemów
- Zawsze czytaj dane wyjściowe konsoli serwera. Prawie każdy błąd zawiera komunikat w konsoli, który mówi, co poszło nie tak i gdzie.
- Zrestartuj serwer po zmianach konfiguracji. Większość zmian w
server.cfgwymaga pełnego restartu serwera, aby zaczęły obowiązywać. - Wyłączaj zasoby pojedynczo, aby izolować problemy. Zakomentuj linie
ensurewserver.cfgznakiem#. - Twórz kopie zapasowe działających konfiguracji przed wprowadzaniem zmian. Pobierz swój
server.cfgi bazę danych przed dużymi aktualizacjami. - Sprawdź fora i dokumentację Cfx.re pod adresem docs.fivem.net, gdzie znajduje się oficjalna dokumentacja dotycząca zarówno FiveM, jak i RedM.
- Sprawdź zgodność zasobów z wersją serwera. Zasoby zbudowane dla starszych wersji mogą nie działać z bieżącymi kompilacjami RedM.
Powiązane artykuły
- Przewodnik konfiguracji serwera RedM — Klucze licencyjne, konfiguracja server.cfg, zarządzanie zasobami i łączenie.
- Jak znaleźć adres IP i port serwera
- Jak przesyłać pliki przez SFTP
- Pierwsze kroki z nowym serwerem
Potrzebujesz pomocy?
Nadal masz problemy z serwerem RedM? Otwórz zgłoszenie do pomocy technicznej i dołącz wszelkie komunikaty o błędach z konsoli serwera. Nasz zespół pomoże Ci zdiagnozować i rozwiązać problem.
