Tõrkeotsingu juhend levinud RedM serveri probleemidele, sealhulgas litsentsvõtme vead, serveribrauseri nähtavus, ressursside tõrked, kliendi ühendused, andmebaasiprobleemid ja jõudluse optimeerimine. Esmase seadistamise juhiste jaoks vaadake meie RedM serveri seadistamise juhend.
Litsentsvõtme vead
Litsentsvõtme probleemid on kõige levinumad probleemid uue RedM serveri käivitamisel. Siin on tüüpilised vead ja nende lahendused:
"Invalid license key" või "Could not authenticate"
| Põhjus | Lahendus |
|---|---|
| Litsentsvõti on valesti sisestatud või sisaldab liigseid tühikuid | Kopeerige võti otse Keymaster lehelt. Eemaldage kõik algus-/lõputühikud CFX_LICENSE käivitusmuutujast GPanel või realt sv_licenseKey failis server.cfg. |
| IP-aadressi mittevastavus | Võti on registreeritud teisele IP-le kui teie serveri tegelik IP. Minge Keymaster lehele, kontrollige registreeritud IP-d ja uuendage seda vastavalt GPanel kuvatavale serveri IP-le. |
| Võti on määratud nii GPanel kui ka server.cfg failis erinevate väärtustega | Veenduge, et võti on ühtne. Parim on määrata see GPanel käivitusmuutujas ja lasta egg'il see serverile edastada. Eemaldage või kommenteerige välja sv_licenseKey failist server.cfg, kui GPanel seda haldab. |
| Cfx.re konto probleem või võti tühistatud | Logige Keymaster lehele sisse ja kontrollige, kas võti on endiselt aktiivne. Genereerige uus võti, kui vana kustutati või aegus. |
| Keymaster teenus on ajutiselt maas | Kontrollige katkestusi Cfx.re oleku lehelt. Oodake ja proovige hiljem uuesti. |
Oluline: Kui saite hiljuti uue serveri või teie serveri IP muutus (nt pärast sõlme migreerimist), peate uuendama IP-d Keymaster lehel või genereerima uue litsentsvõtme. Vana võti ei tööta teise IP-ga.
Server ei ilmu brauserisse
Kui teie server töötab, kuid mängijad ei leia seda RedM serveribrauserist:
Kontroll-loend
- Oodake vähemalt 5 minutit. Pärast käivitamist vajab server aega Cfx.re pealoendisse registreerumiseks. Uued serverid võivad ilmumiseks vajada mitu minutit.
- Kontrollige litsentsvõtme kehtivust. Server ei ilmu loendisse ilma toimiva litsentsvõtmeta. Kontrollige serveri konsooli litsentsvõtmega seotud vigade suhtes.
- Kontrollige lõpp-punkti konfiguratsiooni. Veenduge, et
endpoint_add_tcpjaendpoint_add_udpfailisserver.cfgkasutavad õiget porti:
Port peab ühtima GPanel määratud pordiga.endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" - Kontrollige "sv_master1" või loendamise seadeid. Veenduge, et te ei ole kogemata määranud serverit ennast mitte loendama. Teie konfiguratsioonis ei tohiks olla
sv_master1 ""(see keelab pealoendisse registreerumise). - Kontrollige, kas server tegelikult töötab. Kontrollige GPanel konsooli. Kui server jooksis kokku või peatus, ei ilmu see brauserisse.
- Proovige otseühendust. Isegi kui server ei ole brauseris, peaks otseühendus töötama. Laske mängijal vajutada RedM-is F8 ja sisestada:
connect YOUR_SERVER_IP:PORT
Vihje: Saate kontrollida, kas teie server on kättesaadav, kasutades Cfx.re serveri otsingut. Proovige navigeerida brauseris aadressile
http://YOUR_SERVER_IP:PORT/info.json. Kui server töötab ja on ligipääsetav, tagastab see serveri teabega JSON-vastuse.
Ressursside laadimistõrked
Ressursside vead on levinud uute skriptide või raamistike serverile lisamisel. Siin on kõige sagedasemad probleemid:
"Could not find resource [resource_name]"
- Ressursi kausta ei eksisteeri kataloogis
resources/või see on vales asukohas. - Kausta nimi ei ühti käsus
ensurekasutatud nimega. Ressursside nimed on tõstutundlikud. - Lahendus: Kontrollige, kas ressursi kaust eksisteerib ja kas nimi failis
server.cfgühtib täpselt. Kasutage kontrollimiseks GPanel failihaldurit või SFTP-d.
"Failed to load resource [resource_name]: manifest error"
- Ressursi failis
fxmanifest.luavõi__resource.luaon süntaksiviga. - Manifest viitab failidele, mida ressursi kaustas ei eksisteeri.
- Lahendus: Avage manifestifail ja kontrollige trükivigade, puuduvate komade või olematutele failidele viitamise suhtes. Kontrollige serveri konsoolist konkreetset vea reanumbrit.
"Error loading script [filename]: [error details]"
- Ressursi Lua, C# või JavaScript failil on süntaksi- või käitamisviga.
- Lahendus: Lugege konsoolis täielikku veateadet. See sisaldab faili nime ja reanumbrit. Levinud põhjused hõlmavad:
- Puuduvad sõltuvused (teine ressurss, mis peab olema enne laaditud)
- Aegunud ressurss, mis ei ühildu praeguse RedM serveri versiooniga
- Valed konfiguratsiooniväärtused ressursi konfiguratsioonifailis
Ressursside laadimise järjekorra probleemid
Ressursse failis server.cfg laaditakse nende ilmumise järjekorras. Kui ressurss sõltub teisest (nt vorp_inventory sõltub vorp_core-st), peab sõltuvus olema loendis eespool:
# 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
Hoiatus: Kui ressurss ei laadi, ebaõnnestuvad ka kõik ressursid, mis sellest sõltuvad. Kontrollige alati konsooli väljundit hoolikalt, et tuvastada algpõhjus, mis on tavaliselt esimene ilmuv viga.
Kliendi ühenduse probleemid
Kui mängijad ei saa teie serveriga ühendust:
"Connection timed out" / "Failed to connect"
| Põhjus | Lahendus |
|---|---|
| Server ei tööta | Kontrollige GPanel konsooli, et veenduda, kas server on võrgus ja ei ole kokku jooksnud. |
| Vale IP või port | Kontrollige, kas mängija kasutab õiget GPanel IP-d ja porti. Vaadake Kuidas leida oma serveri IP ja port. |
| Lõpp-punkti konfiguratsiooniviga | Veenduge, et endpoint_add_tcp ja endpoint_add_udp failis server.cfg kasutavad porti 0.0.0.0:PORT, kus PORT ühtib GPanel pordiga. |
| Server on täis | Kontrollige, kas sv_maxclients on saavutatud. Suurendage väärtust, kui teie majutusplaan seda lubab. |
"Connection rejected by server"
- Serveri parool: Kui
sv_passwordon määratud, peab mängija sisestama õige parooli. - Valge nimekirja/lubatud loendi ressurss: Kui teil on lubatud valge nimekirja ressurss, peab mängija olema enne ühendamist kinnitatud.
- Keeld: Mängija võib olla keelatud. Kontrollige oma keelunimekirja või andmebaasi nende identifikaatorite suhtes.
Klient jookseb ühendamisel kokku
- Serveri ressurss saadab halbu andmeid või sellel on kliendipoolne skriptiviga, mis jooksutab kliendi kokku.
- Lahendus: Keelake hiljuti lisatud ressursse ükshaaval, et tuvastada probleemne. Kontrollige serveri konsooli vigade suhtes kliendi ühendamisel.
- Veenduge, et mängija RedM klient on ajakohane.
"Could not download file" vead
- Server proovib saata suurt faili (nt voogesituse vara), mis ületab edastuspiiranguid või ühendus on ebastabiilne.
- Lahendus: Vähendage voogedastatavate varade suurust, kasutage suurte failide jaoks CDN/välist majutust, kui see on toetatud, või laske mängijal ühendust uuesti proovida.
Andmebaasiprobleemid (MySQL / oxmysql)
Enamik RedM rollimängu raamistikke kasutab püsivaks andmesalvestuseks MySQL-i. Kõige levinum andmebaasiühendaja on oxmysql.
Ühenduse ebaõnnestumise vead
Kui oxmysql (või muu MySQL-i ühendaja) ei saa ühendust, kontrollige järgmist:
# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"| Viga | Lahendus |
|---|---|
ECONNREFUSED või "Connection refused" |
MySQL server ei tööta, host/port on vale või MySQL server ei aktsepteeri välisühendusi. Kontrollige hosti, porti ja et teie andmebaasiserver on võrgus. |
ER_ACCESS_DENIED_ERROR |
Vale kasutajanimi või parool ühendusstringis. Kontrollige mandaate oma andmebaasi halduspaneelis. |
ER_BAD_DB_ERROR |
Andmebaasi nime ei eksisteeri. Looge andmebaas esmalt oma andmebaasi halduspaneeli kaudu (phpMyAdmin jne). |
ETIMEDOUT |
Andmebaasiserver on kättesaamatu. Kontrollige, kas tulemüürireeglid blokeerivad ühendust või kas andmebaasi host on õige. |
| "Too many connections" | Andmebaas on saavutanud oma maksimaalse ühenduste piiri. See võib juhtuda, kui ressursid ei sulge ühendusi korralikult või piirang on liiga madal. Taaskäivitage server ja kontrollige oma MySQL max_connections seadet. |
Vihje: Kui teie RedM server ja MySQL andmebaas on samal masinal, kasutage hostina
localhost või 127.0.0.1. Kui need on erinevatel serveritel, kasutage andmebaasiserveri IP-aadressi ja veenduge, et MySQL kasutajal on kaugühenduse õigused.
Puuduvad tabelid või skeemivead
Rollimängu raamistikud nõuavad sageli andmebaasi tabelite seadistamist enne toimimist:
- Kontrollige raamistiku dokumentatsiooni või GitHub repositooriumi SQL-i impordifailide suhtes (sageli nimega
database.sql,schema.sqlvms). - Importige SQL-fail oma andmebaasi phpMyAdmin või MySQL kliendi kaudu.
- Mõned raamistikud loovad tabelid automaatselt esimesel käivitamisel. Veenduge, et andmebaasi kasutajal on
CREATE TABLEõigused.
Jõudluse probleemid
Kui teie RedM serveril esineb viivitusi, madalat tick rate'i või üldist kehva jõudlust:
Jõudluse probleemide tuvastamine
Kontrollige serveri konsooli jõudlushoiatuste suhtes. RedM serverid sihivad tick rate'i umbes 30-64 tikki sekundis. Saate seda jälgida:
- txAdmin juhtpaneel: Kui txAdmin on saadaval, näitab see reaalajas serveri jõudluse mõõdikuid.
- Serveri konsool: Jälgige "slow tick" või "resource hitch" hoiatusi.
- resmon käsk: Sisestage serveri konsoolis (või F8 konsoolis)
resmon 1, et lubada ressursimonitor, mis näitab CPU aega ressursi kohta.
Levinud jõudluse lahendused
| Probleem | Lahendus |
|---|---|
| Konkreetse ressursi kõrge CPU kasutus | Kasutage resmon 1, et ressurss tuvastada. Kaaluge selle asendamist optimeerituma alternatiiviga või võtke ühendust ressursi arendajaga. |
| Liiga palju laaditud ressursse | Iga ressurss tarbib serveri ressursse. Auditeerige oma ressursside loend ja eemaldage kasutamata või üleliigsed ressursid. |
| Andmebaasi päringu kitsaskoht | Aeglased või indekseerimata andmebaasipäringud võivad põhjustada serveri tõrkeid. Kontrollige oxmysql aeglaste päringute hoiatusi konsoolis. Lisage sageli päritud veergudele indeksid. |
| Suur mängijate arv põhjustab viivitusi | Vähendage sv_maxclients tasemele, mida teie serveri riistvara suudab käsitleda. Kaaluge oma majutusplaani uuendamist lisaressursside saamiseks. |
| OneSync olemi piirangud | Liiga palju loodud olemeid (NPC-d, sõidukid, objektid) võivad jõudlust halvendada. Kasutage ressursse, mis puhastavad kasutamata olemeid. |
| Mälulekked | Mõned halvasti kodeeritud ressursid lekivad aja jooksul mälu. Jälgige serveri RAM-i kasutust GPanel. Regulaarsed serveri taaskäivitused (iga 6-12 tunni järel) võivad seda leevendada. |
Soovituslikud praktikad
- Planeerige automaatsed taaskäivitused iga 6-12 tunni järel kasutades GPanel ajakava funktsiooni või txAdmin, et puhastada kogunenud mälu ja olemi probleeme.
- Hoidke ressursse uuendatuna, et saada kasu jõudluse parandustest ja optimeeringutest.
- Vältige dubleeritud funktsionaalsust — ärge käitage kahte ressurssi, mis teevad sama asja (nt kaks ilmastikusüsteemi).
- Testige uusi ressursse testserveris (või madala mängijate arvuga) enne peaserverisse juurutamist.
- Jälgige serveri mõõdikuid regulaarselt GPanel või txAdmin kaudu, et probleeme varakult märgata.
Märkus: Kui teil esinevad järjepidevalt jõudluse probleemid vaatamata optimeerimisele, võib teie server vajada kõrgema taseme majutusplaani rohkema CPU ja RAM-i ressurssidega. Võtke ühendust meie tugimeeskonnaga, et arutada uuendamise võimalusi.
Üldised tõrkeotsingu näpunäited
- Lugege alati serveri konsooli väljundit. Peaaegu iga viga sisaldab konsoolis teadet, mis ütleb teile, mis läks valesti ja kus.
- Taaskäivitage server pärast konfiguratsiooni muudatusi. Enamik muudatusi failis
server.cfgnõuab jõustumiseks täielikku serveri taaskäivitust. - Keelake ressursse ükshaaval, et probleeme isoleerida. Kommenteerige failis
server.cfgensureread välja märgiga#. - Tehke varukoopiad töötavatest konfiguratsioonidest enne muudatuste tegemist. Laadige enne suuri uuendusi alla oma
server.cfgja andmebaas. - Kontrollige Cfx.re foorumeid ja dokumentatsiooni aadressil docs.fivem.net, kust leiate ametliku dokumentatsiooni, mis kehtib nii FiveM kui ka RedM kohta.
- Kontrollige ressursside ühilduvust oma serveri versiooniga. Varasematele versioonidele ehitatud ressursid ei pruugi töötada praeguste RedM koostetega.
Seotud artiklid
- RedM serveri seadistamise juhend — Litsentsvõtmed, server.cfg konfiguratsioon, ressursside haldamine ja ühendamine.
- Kuidas leida oma serveri IP ja port
- Kuidas laadida faile üles SFTP kaudu
- Uue serveriga alustamine
Vajate abi?
Kas teil esineb endiselt probleeme oma RedM serveriga? Avage tugiteenuse pilet ja lisage kõik veateated oma serveri konsoolist. Meie meeskond aitab teil probleemi diagnoosida ja lahendada.
