See juhend käsitleb lahendusi kõige levinumatele FiveM serveri probleemidele — TXAdmin-i ligipääsu probleemid, CFX litsentsi võtme vead, andmebaasi ühenduse tõrked, serveri kokkujooksmised, mängijate ühenduse probleemid ja ressursside mittelaadimine. Algse serveri seadistuse jaoks vaata FiveM serveri seadistamise juhendit.
Üldine tõrkeotsingu nõuanne: Kontrolli alati esmalt GPanel-i konsooli väljundit ja TXAdmin-i logisid. Enamik vigu kuvab selge teate, mis osutab põhjusele.
TXAdmin ei laadi või pole ligipääsetav
- Veendu, et server töötab GPanel-is — TXAdmin käivitub ainult siis, kui FiveM serveri protsess on aktiivne.
- Kontrolli GPanel-i konsoolist TXAdmin-i URL-i ja porti. TXAdmin-i port erineb mängu pordist.
- Veendu, et kasutad
http://, mittehttps://— TXAdmin ei kasuta vaikimisi SSL-i. - Kui TXAdmin töötas varem, kuid lõpetab laadimise, proovi serverit GPanel-ist taaskäivitada.
- Tühjenda brauseri vahemälu või proovi inkognito/privaatakent.
Kaotasid oma TXAdmin-i parooli? Kui sa ei saa sisse logida, pead võib-olla kustutama TXAdmin-i profiili andmed ja uuesti seadistusviisardi läbi tegema. Kontrolli GPanel-i Files vahekaardilt TXAdmin-i andmekausta ja eemalda selle profiili failid, seejärel taaskäivita server.
CFX litsentsi võtme vead
| Veateade | Põhjus | Lahendus |
|---|---|---|
Invalid license key |
Võti kopeeritud valesti või lisatühikud | Mine Keymaster-isse, kinnita, et võti on aktiivne, ja kopeeri see hoolikalt uuesti. Kleebi see nii GPanel-i Startup muutujasse kui ka sv_licenseKey väärtuseks server.cfg-s. |
License key already in use |
Võti on registreeritud teisele serveri IP-le | Iga võtit saab korraga kasutada ainult ühel serveril. Tühista vana võti Keymaster-is ja genereeri uus oma praeguse serveri IP-ga. |
Unable to verify license key |
Cfx.re autentimisserverid on ajutiselt kättesaamatud | Oota mõned minutid ja taaskäivita server. Kontrolli katkestusi aadressil status.cfx.re. |
Nõuanne: Veendu, et võti on seatud nii GPanel-i Startup muutujas kui ka
server.cfg failis (sv_licenseKey). Sõltuvalt sinu konfiguratsioonist võib server lugeda ühte või teist.
Andmebaasi ühenduse vead
| Veateade | Põhjus | Lahendus |
|---|---|---|
Connection refused või ETIMEDOUT |
Vale andmebaasi host või port | Kontrolli andmebaasi hosti aadressi ja porti GPanel-i Databases vahekaardilt. Ära kasuta localhost ega 127.0.0.1. |
Access denied |
Vale kasutajanimi või parool | Kopeeri mandaadid otse GPanel-ist, et vältida trükivigu. Paroolid on tõstutundlikud. |
Unknown database |
Andmebaasi nimi ei vasta | Veendu, et andmebaasi nimi sinu ühenduse stringis vastab täpselt sellele, mis on näidatud GPanel-is. |
Täiendavad andmebaasi tõrkeotsingu sammud:
- Kui kasutad oxmysql-i, veendu, et sul on
oxmysqlressurss omaresources/kaustas ja etensure oxmysqlesineb server.cfg-s enne mis tahes ressursse, mis vajavad andmebaasi. - Kui sinu parool sisaldab erimärke nagu
@,#või%, URL-kodeeri need ühenduse stringis (nt@muutub%40-ks). - Testi oma ühenduse stringi puuduvate või üleliigsete märkide suhtes — isegi üks valesti paigutatud märk põhjustab tõrke.
Ära kasuta localhost-i. Andmebaasi server on mänguserverist eraldiseisev. Kasuta alati täielikku hosti aadressi, mis on näidatud GPanel-i Databases vahekaardil.
Server jookseb käivitamisel kokku
- Kontrolli GPanel-i konsooli veateadete osas. Levinud põhjused on puuduv või valesti konfigureeritud
server.cfg, kehtetu CFX litsentsi võti või vigane ressurss. - Proovi kohandatud ressursid keelata, kommenteerides need server.cfg-s välja (lisa
#igaensurerea ette) ja taaskäivita. Lisa need tagasi ükshaaval, et tuvastada probleemne ressurss. - Veendu, et pordid
endpoint_add_tcpjaendpoint_add_udpväärtustes vastavad sinu GPanel-is määratud pordile.
# 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
Kahendotsing vigaste ressursside leidmiseks: Kui sul on palju ressursse, kommenteeri korraga pool välja, mitte ükshaaval. See kitsendab probleemi palju kiiremini.
Mängijad ei saa ühenduda
- Kinnita, et server näitab GPanel-is olekut Running.
- Kontrolli IP-d ja porti — mängijad peaksid kasutama mängu porti, mitte TXAdmin-i porti.
- Kontrolli, et
sv_maxclientspole seatud 0-le või ebamõistlikult madalale numbrile. - Kui kasutad serveri parooli (
sv_passwordserver.cfg-s), veendu, et mängijad teavad seda. - Mängijatel peab olema FiveM klient paigaldatud — nad ei saa ühenduda tavalise GTA V käivitajaga.
- Kontrolli GPanel-i Network vahekaarti ja kinnita, et pordid
endpoint_add_tcpjaendpoint_add_udpväärtustes vastavad. Mittevastavus takistab ühendusi.
Server ei ilmu brauseris? Uutel serveritel võib FiveM serveri loendis ilmumine võtta 5-15 minutit. Kasuta vahepeal otseühendust (
IP:PORT). Samuti veendu, et sinu sv_licenseKey on kehtiv.
Ressursid ei laadi
- Kontrolli, et ressursi kaust asub
resources/kataloogis (või sobivas alamkaustas). - Veendu, et kausta nimi vastab server.cfg-s olevale
ensurereale täpselt (tõstutundlik). - Iga ressurss peab sisaldama kehtivat
fxmanifest.luafaili (või vanemat__resource.lua). Kui see fail puudub, siis ressurss ei laadi. - Kontrolli TXAdmin-i või GPanel-i konsooli ressursiga seotud veateadete osas. Levinud vead hõlmavad puuduvaid sõltuvusi või Lua süntaksivigu.
- Kui ressurss vajab raamistikku (ESX, QBCore), veendu, et raamistik on server.cfg-s laaditud enne ressurssi.
- Kui ressurss vajab andmebaasi, veendu, et sinu MySQL ressurss (oxmysql, mysql-async) on laaditud ja andmebaasi ühendus töötab.
Kontrolli kausta struktuuri. Levinud viga on ressursi üleslaadimine, mille tulemuseks on topelt-pesastatud kaust nagu
resources/my-resource/my-resource/fxmanifest.lua. Manifest peab olema otse ressursi kausta sees: resources/my-resource/fxmanifest.lua.
Serveri jõudluse probleemid
- Ava TXAdmin ja kontrolli Dashboard-i jõudlusnäitajate osas (tick-aeg, mängijate arv, mälukasutus).
- Terve FiveM server peaks hoidma serveri tick-aega (nimetatakse ka "hitch") alla 20ms. Pidevad tõuked üle selle näitavad, et ressurss kasutab liiga palju töötlusaega.
- Kasuta TXAdmin-i Resources lehte, et tuvastada, millised ressursid tarbivad kõige rohkem serveri aega.
- Eemalda või asenda halvasti optimeeritud ressursid. Tundmatutest allikatest pärinevad tasuta ressursid on sageli jõudlusprobleemide põhjuseks.
- Vähenda laaditud ressursside arvu, kui sinu serveripaketi mälu- või protsessori limiidid on saavutatud.
Abi saamine
Kui oled ülaltoodud lahendusi proovinud ja koged endiselt probleeme:
- Kopeeri täielik veateade GPanel-i konsoolist või TXAdmin-i logist.
- Märgi üles, milliseid tõrkeotsingu samme oled juba proovinud.
- Ava tugiteenuse pilet aadressil https://legionhosting.net/submitticket.php koos selle teabega. Meie meeskond aitab sind nii kiiresti kui võimalik.
