Acest ghid acoperă soluții pentru cele mai frecvente probleme ale serverelor FiveM — probleme de acces TXAdmin, erori ale cheii de licență CFX, eșecuri de conectare la baza de date, blocări ale serverului, probleme de conectare a jucătorilor și resurse care nu se încarcă. Pentru configurarea inițială a serverului, consultați Ghidul de Configurare a Serverului FiveM.
Sfat general de depanare: Verificați întotdeauna mai întâi rezultatul consolei GPanel și jurnalele TXAdmin. Majoritatea erorilor produc un mesaj clar care indică cauza.
TXAdmin nu se încarcă sau este inaccesibil
- Verificați că serverul rulează în GPanel — TXAdmin pornește doar atunci când procesul serverului FiveM este activ.
- Verificați consola GPanel pentru URL-ul și portul TXAdmin. Portul TXAdmin este diferit de portul de joc.
- Asigurați-vă că utilizați
http://nuhttps://— TXAdmin nu folosește SSL în mod implicit. - Dacă TXAdmin funcționa anterior, dar nu se mai încarcă, încercați să reporniți serverul din GPanel.
- Goliți cache-ul browserului sau încercați o fereastră incognito/privată.
Ați pierdut parola TXAdmin? Dacă nu vă puteți autentifica, este posibil să fie nevoie să ștergeți datele profilului TXAdmin și să rulați din nou expertul de configurare. Verificați fila Files din GPanel pentru directorul de date al TXAdmin și eliminați fișierele profilului acestuia, apoi reporniți serverul.
Erori ale cheii de licență CFX
| Mesaj de eroare | Cauză | Soluție |
|---|---|---|
Invalid license key |
Cheie copiată incorect sau spații suplimentare | Accesați Keymaster, confirmați că cheia este activă și copiați-o din nou cu atenție. Lipiți-o atât în variabila Startup din GPanel, cât și în sv_licenseKey din server.cfg. |
License key already in use |
Cheia este înregistrată pe un alt IP de server | Fiecare cheie poate fi utilizată pe un singur server la un moment dat. Revocați cheia veche în Keymaster și generați una nouă cu IP-ul actual al serverului dvs. |
Unable to verify license key |
Serverele de autentificare Cfx.re sunt temporar indisponibile | Așteptați câteva minute și reporniți serverul. Verificați status.cfx.re pentru întreruperi. |
Sfat: Asigurați-vă că cheia este setată atât în variabila Startup din GPanel, cât și în
server.cfg (sv_licenseKey). În funcție de configurația dvs., serverul poate citi din una sau din cealaltă.
Erori de conectare la baza de date
| Mesaj de eroare | Cauză | Soluție |
|---|---|---|
Connection refused sau ETIMEDOUT |
Host sau port greșit al bazei de date | Verificați de două ori adresa hostului și portul bazei de date din fila Databases din GPanel. Nu utilizați localhost sau 127.0.0.1. |
Access denied |
Nume de utilizator sau parolă greșite | Copiați acreditările direct din GPanel pentru a evita greșelile de tastare. Parolele sunt sensibile la majuscule. |
Unknown database |
Numele bazei de date nu se potrivește | Asigurați-vă că numele bazei de date din șirul dvs. de conectare se potrivește exact cu ceea ce este afișat în GPanel. |
Pași suplimentari de depanare a bazei de date:
- Dacă folosiți oxmysql, asigurați-vă că aveți resursa
oxmysqlîn folderulresources/și căensure oxmysqlapare în server.cfg înainte de orice resurse care necesită o bază de date. - Dacă parola dvs. conține caractere speciale precum
@,#sau%, codificați-le URL în șirul de conectare (de ex.@devine%40). - Testați șirul de conectare pentru caractere lipsă sau suplimentare — chiar și un singur caracter plasat greșit va cauza un eșec.
Nu utilizați localhost. Serverul bazei de date este separat de serverul de joc. Utilizați întotdeauna adresa completă a hostului afișată în fila Databases din GPanel.
Serverul se blochează la pornire
- Verificați consola GPanel pentru mesaje de eroare. Cauzele frecvente includ un fișier
server.cfglipsă sau configurat greșit, o cheie de licență CFX invalidă sau o resursă defectă. - Încercați să dezactivați resursele personalizate prin comentarea lor în server.cfg (adăugați
#înaintea fiecărei liniiensure) și reporniți. Adăugați-le înapoi una câte una pentru a identifica resursa problematică. - Asigurați-vă că porturile din
endpoint_add_tcpșiendpoint_add_udpse potrivesc cu portul atribuit de GPanel.
# Comment out resources to isolate the problem
#ensure suspicious-resource
#ensure another-resource
# Keep core resources enabled
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure chat
Căutare binară pentru resurse defecte: Dacă aveți multe resurse, comentați jumătate odată, nu una câte una. Acest lucru restrânge problema mult mai rapid.
Jucătorii nu se pot conecta
- Confirmați că serverul afișează Running în GPanel.
- Verificați IP-ul și portul — jucătorii ar trebui să folosească portul de joc, nu portul TXAdmin.
- Verificați că
sv_maxclientsnu este setat la 0 sau la un număr nejustificat de mic. - Dacă folosiți o parolă de server (
sv_passwordîn server.cfg), asigurați-vă că jucătorii o cunosc. - Jucătorii trebuie să aibă clientul FiveM instalat — nu se pot conecta folosind launcher-ul obișnuit GTA V.
- Verificați fila Network din GPanel și confirmați că porturile din
endpoint_add_tcpșiendpoint_add_udpse potrivesc. O nepotrivire va împiedica conexiunile.
Serverul nu apare în browser? Serverele noi pot dura 5-15 minute pentru a apărea în lista de servere FiveM. Folosiți conexiunea directă (
IP:PORT) între timp. De asemenea, verificați că sv_licenseKey este valid.
Resursele nu se încarcă
- Verificați că folderul resursei se află în directorul
resources/(sau într-un subfolder corespunzător). - Verificați că numele folderului se potrivește exact cu linia
ensuredin server.cfg (sensibil la majuscule). - Fiecare resursă trebuie să conțină un
fxmanifest.luavalid (sau vechiul__resource.lua). Dacă acest fișier lipsește, resursa nu se va încărca. - Verificați consola TXAdmin sau GPanel pentru mesaje de eroare legate de resursă. Erorile frecvente includ dependențe lipsă sau erori de sintaxă Lua.
- Dacă resursa necesită un framework (ESX, QBCore), asigurați-vă că framework-ul este încărcat înaintea resursei în server.cfg.
- Dacă resursa necesită o bază de date, asigurați-vă că resursa dvs. MySQL (oxmysql, mysql-async) este încărcată și că conexiunea la baza de date funcționează.
Verificați structura folderului. O greșeală frecventă este încărcarea unei resurse și obținerea unui folder dublu imbricat, cum ar fi
resources/my-resource/my-resource/fxmanifest.lua. Manifestul trebuie să se afle direct în interiorul folderului resursei: resources/my-resource/fxmanifest.lua.
Probleme de performanță a serverului
- Deschideți TXAdmin și verificați Dashboard pentru valorile de performanță (timpul de tick, numărul de jucători, utilizarea memoriei).
- Un server FiveM sănătos ar trebui să mențină un timp de tick al serverului (numit și „hitch") sub 20ms. Vârfurile constante peste această valoare indică faptul că o resursă utilizează prea mult timp de procesare.
- Folosiți pagina Resources din TXAdmin pentru a identifica resursele care consumă cel mai mult timp al serverului.
- Eliminați sau înlocuiți resursele slab optimizate. Resursele gratuite din surse necunoscute sunt adesea cauza problemelor de performanță.
- Reduceți numărul de resurse încărcate dacă limitele de memorie sau CPU ale planului dvs. de server sunt atinse.
Obținerea de ajutor
Dacă ați încercat soluțiile de mai sus și încă întâmpinați probleme:
- Copiați mesajul de eroare complet din consola GPanel sau din jurnalul TXAdmin.
- Notați ce pași de depanare ați încercat deja.
- Deschideți un tichet de asistență la https://legionhosting.net/submitticket.php cu aceste informații. Echipa noastră vă va ajuta cât mai rapid posibil.
