Tämä opas käsittelee ratkaisuja yleisimpiin FiveM-palvelinongelmiin — TXAdmin-käyttöongelmiin, CFX-lisenssiavainvirheisiin, tietokantayhteyden epäonnistumisiin, palvelinkaatumisiin, pelaajien yhteysongelmiin ja resurssien latautumattomuuteen. Palvelimen alkukäyttöönottoa varten katso FiveM-palvelimen asennusopas.
Yleinen vianmääritysvinkki: Tarkista aina ensin GPanel-konsolin tuloste ja TXAdmin-lokit. Useimmat virheet tuottavat selkeän viestin, joka osoittaa syyn.
TXAdmin ei lataudu tai siihen ei pääse
- Varmista, että palvelin on käynnissä GPanelissa — TXAdmin käynnistyy vain, kun FiveM-palvelinprosessi on aktiivinen.
- Tarkista GPanel-konsolista TXAdminin URL-osoite ja portti. TXAdmin-portti eroaa peliportista.
- Varmista, että käytät
http://etkähttps://— TXAdmin ei käytä SSL:ää oletuksena. - Jos TXAdmin toimi aiemmin mutta ei enää lataudu, yritä käynnistää palvelin uudelleen GPanelista.
- Tyhjennä selaimen välimuisti tai kokeile incognito-/yksityistä ikkunaa.
Hukkasitko TXAdmin-salasanasi? Jos et voi kirjautua sisään, sinun on ehkä poistettava TXAdmin-profiilitiedot ja suoritettava asennusvelho uudelleen. Tarkista GPanelin Files-välilehdeltä TXAdminin tietohakemisto ja poista sen profiilitiedostot, sitten käynnistä palvelin uudelleen.
CFX-lisenssiavainvirheet
| Virheilmoitus | Syy | Ratkaisu |
|---|---|---|
Invalid license key |
Avain on kopioitu väärin tai siinä on ylimääräistä välilyöntiä | Mene Keymasteriin, vahvista että avain on aktiivinen, ja kopioi se huolellisesti uudelleen. Liitä se sekä GPanelin Startup-muuttujaan että sv_licenseKey-asetukseen server.cfg-tiedostoon. |
License key already in use |
Avain on rekisteröity eri palvelimen IP-osoitteelle | Kutakin avainta voi käyttää vain yhdellä palvelimella kerrallaan. Peruuta vanha avain Keymasterissa ja luo uusi nykyisellä palvelimesi IP-osoitteella. |
Unable to verify license key |
Cfx.re-todennuspalvelimet ovat tilapäisesti pois käytöstä | Odota muutama minuutti ja käynnistä palvelin uudelleen. Tarkista käyttökatkot osoitteesta status.cfx.re. |
Vinkki: Varmista, että avain on asetettu sekä GPanelin Startup-muuttujaan että
server.cfg-tiedostoon (sv_licenseKey). Kokoonpanostasi riippuen palvelin voi lukea jommasta kummasta.
Tietokantayhteysvirheet
| Virheilmoitus | Syy | Ratkaisu |
|---|---|---|
Connection refused tai ETIMEDOUT |
Väärä tietokannan isäntä tai portti | Tarkista huolellisesti tietokannan isäntäosoite ja portti GPanelin Databases-välilehdeltä. Älä käytä localhost tai 127.0.0.1. |
Access denied |
Väärä käyttäjätunnus tai salasana | Kopioi tunnukset suoraan GPanelista kirjoitusvirheiden välttämiseksi. Salasanat erottavat isot ja pienet kirjaimet. |
Unknown database |
Tietokannan nimi ei täsmää | Varmista, että tietokannan nimi yhteysmerkkijonossasi vastaa täsmälleen GPanelissa näkyvää. |
Tietokannan vianmäärityksen lisäaskeleet:
- Jos käytät oxmysql-resurssia, varmista, että
oxmysql-resurssi onresources/-kansiossasi ja ettäensure oxmysqlnäkyy server.cfg-tiedostossa ennen mitä tahansa tietokantaa vaativia resursseja. - Jos salasanasi sisältää erikoismerkkejä, kuten
@,#tai%, URL-koodaa ne yhteysmerkkijonossa (esim.@muuttuu muotoon%40). - Testaa yhteysmerkkijonosi puuttuvien tai ylimääräisten merkkien varalta — jopa yksi väärin sijoitettu merkki aiheuttaa virheen.
Älä käytä localhostia. Tietokantapalvelin on erillinen pelipalvelimesta. Käytä aina GPanelin Databases-välilehdellä näkyvää täydellistä isäntäosoitetta.
Palvelin kaatuu käynnistyksen yhteydessä
- Tarkista GPanel-konsolista virheilmoitukset. Yleisiä syitä ovat puuttuva tai virheellisesti määritetty
server.cfg, virheellinen CFX-lisenssiavain tai rikkinäinen resurssi. - Yritä poistaa mukautetut resurssit käytöstä kommentoimalla ne pois server.cfg-tiedostosta (lisää
#jokaisenensure-rivin eteen) ja käynnistä uudelleen. Lisää ne takaisin yksi kerrallaan tunnistaaksesi ongelman aiheuttavan resurssin. - Varmista, että
endpoint_add_tcp- jaendpoint_add_udp-portit vastaavat GPanelin sinulle määrittämää porttia.
# 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
Binäärihaku huonoille resursseille: Jos sinulla on monta resurssia, kommentoi pois puolet kerrallaan yksi kerrallaan sijaan. Tämä rajaa ongelmaa paljon nopeammin.
Pelaajat eivät voi yhdistää
- Vahvista, että palvelin näyttää Running GPanelissa.
- Tarkista IP ja portti — pelaajien tulisi käyttää peliporttia, ei TXAdmin-porttia.
- Tarkista, ettei
sv_maxclientsole asetettu arvoon 0 tai kohtuuttoman pieneksi luvuksi. - Jos käytät palvelimen salasanaa (
sv_passwordserver.cfg-tiedostossa), varmista, että pelaajat tietävät sen. - Pelaajilla on oltava FiveM-asiakas asennettuna — he eivät voi yhdistää tavallisella GTA V -käynnistimellä.
- Tarkista GPanelin Network-välilehti ja vahvista, että
endpoint_add_tcp- jaendpoint_add_udp-portit täsmäävät. Yhteensopimattomuus estää yhteydet.
Palvelin ei näy selaimessa? Uusien palvelinten ilmestyminen FiveM-palvelinlistalle voi kestää 5–15 minuuttia. Käytä siihen asti suoraa yhdistämistä (
IP:PORT). Tarkista myös, että sv_licenseKey on kelvollinen.
Resurssit eivät lataudu
- Tarkista, että resurssikansio on
resources/-hakemiston sisällä (tai sopivassa alikansiossa). - Varmista, että kansion nimi vastaa täsmälleen server.cfg-tiedoston
ensure-riviä (erottaa isot ja pienet kirjaimet). - Jokaisen resurssin on sisällettävä kelvollinen
fxmanifest.lua(tai vanhempi__resource.lua). Jos tämä tiedosto puuttuu, resurssi ei lataudu. - Tarkista TXAdminin tai GPanelin konsolista resurssiin liittyvät virheilmoitukset. Yleisiä virheitä ovat puuttuvat riippuvuudet tai Lua-syntaksivirheet.
- Jos resurssi vaatii frameworkin (ESX, QBCore), varmista, että framework on ladattu ennen resurssia server.cfg-tiedostossa.
- Jos resurssi vaatii tietokannan, varmista, että MySQL-resurssisi (oxmysql, mysql-async) on ladattu ja tietokantayhteys toimii.
Tarkista kansiorakenne. Yleinen virhe on resurssin lataaminen niin, että lopputuloksena on kaksinkertaisesti sisäkkäinen kansio, kuten
resources/my-resource/my-resource/fxmanifest.lua. Manifestin on oltava suoraan resurssikansion sisällä: resources/my-resource/fxmanifest.lua.
Palvelimen suorituskykyongelmat
- Avaa TXAdmin ja tarkista Dashboard suorituskykymittareita varten (tick-aika, pelaajamäärä, muistinkäyttö).
- Terveen FiveM-palvelimen tulisi pitää palvelimen tick-aika (tunnetaan myös nimellä "hitch") alle 20 ms:ssä. Toistuvat piikit yli tämän osoittavat, että jokin resurssi käyttää liikaa prosessointiaikaa.
- Käytä TXAdminin Resources-sivua tunnistaaksesi, mitkä resurssit kuluttavat eniten palvelinaikaa.
- Poista tai vaihda huonosti optimoidut resurssit. Tuntemattomista lähteistä peräisin olevat ilmaiset resurssit ovat usein suorituskykyongelmien syy.
- Vähennä ladattujen resurssien määrää, jos palvelinpakettisi muisti- tai CPU-rajat saavutetaan.
Avun hakeminen
Jos olet kokeillut yllä olevia ratkaisuja ja ongelmia esiintyy edelleen:
- Kopioi koko virheilmoitus GPanel-konsolista tai TXAdmin-lokista.
- Merkitse muistiin, mitä vianmääritysvaiheita olet jo kokeillut.
- Avaa tukipyyntö osoitteessa https://legionhosting.net/submitticket.php näiden tietojen kera. Tiimimme auttaa sinua mahdollisimman pian.
