Hibaelhárítási útmutató gyakori RedM szerverproblémákhoz, beleértve a licenckulcs hibákat, a szerverböngésző láthatóságot, az erőforrás hibákat, a kliens csatlakozásokat, az adatbázis-problémákat és a teljesítményoptimalizálást. A kezdeti beállítási utasításokért lásd a RedM szerver beállítási útmutatót.
Licenckulcs hibák
A licenckulcs problémák a leggyakoribb problémák egy új RedM szerver indításakor. Íme a tipikus hibák és megoldásaik:
"Invalid license key" vagy "Could not authenticate"
| Ok | Megoldás |
|---|---|
| A licenckulcs el van gépelve vagy extra szóközöket tartalmaz | Másold ki a kulcsot közvetlenül a Keymaster-ből. Távolítsd el a kezdő/záró szóközöket a CFX_LICENSE indítási változóból a GPanel-ben vagy az sv_licenseKey sorból a server.cfg-ben. |
| IP-cím eltérés | A kulcs más IP-re van regisztrálva, mint a szervered tényleges IP-címe. Menj a Keymaster-be, ellenőrizd a regisztrált IP-t, és frissítsd a GPanel-ben megjelenített szerver IP-re. |
| A kulcs a GPanel-ben és a server.cfg-ben is be van állítva eltérő értékekkel | Győződj meg róla, hogy a kulcs egységes. A legjobb, ha a GPanel indítási változóban állítod be, és hagyod, hogy az egg továbbítsa a szervernek. Távolítsd el vagy kommenteld ki az sv_licenseKey sort a server.cfg-ből, ha a GPanel kezeli. |
| Cfx.re fiók probléma vagy visszavont kulcs | Jelentkezz be a Keymaster-be és ellenőrizd, hogy a kulcs még aktív-e. Generálj új kulcsot, ha a régi törölve lett vagy lejárt. |
| A Keymaster szolgáltatás átmenetileg nem elérhető | Ellenőrizd a Cfx.re állapotoldalt kimaradásokért. Várj és próbáld újra később. |
Fontos: Ha nemrég kaptál új szervert, vagy a szervered IP-címe megváltozott (pl. csomópont migráció után), frissítened kell az IP-t a Keymaster-ben vagy új licenckulcsot kell generálnod. A régi kulcs nem fog működni más IP-n.
A szerver nem jelenik meg a böngészőben
Ha a szervered fut, de a játékosok nem találják a RedM szerverböngészőben:
Ellenőrzőlista
- Várj legalább 5 percet. Az indítás után a szervernek időre van szüksége a Cfx.re fő szerverlistán való regisztrációhoz. Az új szerverek megjelenése több percet is igénybe vehet.
- Ellenőrizd, hogy a licenckulcs érvényes-e. A szerver nem lesz listázva működő licenckulcs nélkül. Ellenőrizd a szerver konzolt licenckulccsal kapcsolatos hibákért.
- Ellenőrizd a végpont konfigurációt. Győződj meg róla, hogy az
endpoint_add_tcpésendpoint_add_udpaserver.cfg-ben a helyes portot használja:
A portnak meg kell egyeznie a GPanel-ben kiosztottal.endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" - Ellenőrizd az "sv_master1" vagy listázási beállításokat. Győződj meg róla, hogy véletlenül nem állítottad be a szervert úgy, hogy ne listázza magát. Nem szabad
sv_master1 ""-nak lennie a konfigurációdban (ez letiltja a fő lista regisztrációt). - Ellenőrizd, hogy a szerver tényleg fut-e. Nézd meg a GPanel konzolt. Ha a szerver összeomlott vagy leállt, nem fog megjelenni a böngészőben.
- Próbálj közvetlen csatlakozást. Még ha a szerver nem is jelenik meg a böngészőben, a közvetlen csatlakozásnak működnie kell. A játékos nyomja meg az F8 billentyűt a RedM-ben és írja be:
connect YOUR_SERVER_IP:PORT
Tipp: Ellenőrizheted, hogy a szervered elérhető-e a Cfx.re szerver kereséssel. Próbáld meg a böngészőben megnyitni a
http://YOUR_SERVER_IP:PORT/info.json címet. Ha a szerver fut és elérhető, egy JSON választ ad vissza a szerver információival.
Erőforrás betöltési hibák
Az erőforrás hibák gyakoriak új szkriptek vagy keretrendszerek hozzáadásakor a szerveredhez. Íme a leggyakoribb problémák:
"Could not find resource [resource_name]"
- Az erőforrás mappa nem létezik a
resources/könyvtárban, vagy rossz helyen van. - A mappa neve nem egyezik az
ensure-ben használt névvel. Az erőforrásnevek kis- és nagybetű érzékenyek. - Javítás: Ellenőrizd, hogy az erőforrás mappa létezik-e és a név a
server.cfg-ben pontosan egyezik. Használd a GPanel fájlkezelőt vagy az SFTP-t az ellenőrzéshez.
"Failed to load resource [resource_name]: manifest error"
- Az erőforrás
fxmanifest.luavagy__resource.luafájljában szintaktikai hiba van. - A manifeszt olyan fájlokra hivatkozik, amelyek nem léteznek az erőforrás mappában.
- Javítás: Nyisd meg a manifeszt fájlt és ellenőrizd az elgépeléseket, hiányzó vesszőket vagy nem létező fájlokra való hivatkozásokat. Ellenőrizd a szerver konzolt a hiba pontos sorszámáért.
"Error loading script [filename]: [error details]"
- Egy Lua, C# vagy JavaScript fájlban szintaktikai vagy futásidejű hiba van az erőforráson belül.
- Javítás: Olvasd el a teljes hibaüzenetet a konzolban. Tartalmazza a fájlnevet és a sorszámot. Gyakori okok:
- Hiányzó függőségek (egy másik erőforrás, amelyet előbb be kell tölteni)
- Elavult erőforrás, amely nem kompatibilis a jelenlegi RedM szerver verzióval
- Helytelen konfigurációs értékek az erőforrás konfigurációs fájljában
Erőforrás betöltési sorrend problémák
A server.cfg-ben az erőforrások a megjelenésük sorrendjében töltődnek be. Ha egy erőforrás egy másiktól függ (pl. vorp_inventory függ a vorp_core-tól), a függőséget előbb kell listázni:
# 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
Figyelmeztetés: Ha egy erőforrás betöltése sikertelen, az attól függő erőforrások is sikertelenül töltődnek be. Mindig figyelmesen ellenőrizd a konzol kimenetét a kiváltó ok azonosításához, amely általában az első megjelenő hiba.
Kliens csatlakozási problémák
Amikor a játékosok nem tudnak csatlakozni a szerveredhez:
"Connection timed out" / "Failed to connect"
| Ok | Megoldás |
|---|---|
| A szerver nem fut | Ellenőrizd a GPanel konzolt, hogy a szerver online van-e és nem omlott-e össze. |
| Rossz IP vagy port | Ellenőrizd, hogy a játékos a helyes IP-t és portot használja a GPanel-ből. Lásd a Hogyan találd meg a szervered IP-címét és portját útmutatót. |
| Végpont konfiguráció hiba | Győződj meg róla, hogy az endpoint_add_tcp és endpoint_add_udp a server.cfg-ben 0.0.0.0:PORT portot használ, ahol a PORT megegyezik a GPanel-ben lévővel. |
| A szerver tele van | Ellenőrizd, hogy az sv_maxclients elérte-e a maximumot. Növeld az értéket, ha a hosztolási csomagod megengedi. |
"Connection rejected by server"
- Szerver jelszó: Ha az
sv_passwordbe van állítva, a játékosnak meg kell adnia a helyes jelszót. - Fehérlista/engedélyezési lista erőforrás: Ha engedélyezve van egy fehérlista erőforrás, a játékost jóvá kell hagyni a csatlakozás előtt.
- Kitiltás: A játékos ki lehet tiltva. Ellenőrizd a tiltási listádat vagy az adatbázisodat az azonosítóik alapján.
A kliens összeomlik csatlakozáskor
- Egy erőforrás a szerveren hibás adatokat küld, vagy egy kliens oldali szkripthiba okozza a kliens összeomlását.
- Javítás: Tiltsd le az újonnan hozzáadott erőforrásokat egyenként a problémás azonosításához. Ellenőrizd a szerver konzolt a kliens csatlakozás közbeni hibákért.
- Győződj meg róla, hogy a játékos RedM kliense naprakész.
"Could not download file" hibák
- A szerver egy nagy fájlt próbál küldeni (pl. egy streaming eszközt), amely meghaladja az átviteli korlátokat, vagy a kapcsolat instabil.
- Javítás: Csökkentsd a streamelt eszközök méretét, használj CDN-t/külső hosztolást a nagy fájlokhoz, ha támogatott, vagy a játékos próbálja újra a csatlakozást.
Adatbázis-problémák (MySQL / oxmysql)
A legtöbb RedM roleplay keretrendszer MySQL-t használ az állandó adattároláshoz. A leggyakoribb adatbázis-csatlakozó az oxmysql.
Csatlakozási hiba
Ha az oxmysql (vagy más MySQL csatlakozó) nem tud csatlakozni, ellenőrizd a következőket:
# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"| Hiba | Megoldás |
|---|---|
ECONNREFUSED vagy "Connection refused" |
A MySQL szerver nem fut, a hoszt/port rossz, vagy a MySQL szerver nem fogad külső kapcsolatokat. Ellenőrizd a hosztot, portot és hogy az adatbázis szervered online van-e. |
ER_ACCESS_DENIED_ERROR |
Rossz felhasználónév vagy jelszó a kapcsolati karakterláncban. Ellenőrizd a hitelesítő adatokat az adatbázis hosztolási panelben. |
ER_BAD_DB_ERROR |
Az adatbázis név nem létezik. Először hozd létre az adatbázist az adatbázis-kezelő panelen (phpMyAdmin stb.) keresztül. |
ETIMEDOUT |
Az adatbázis szerver nem érhető el. Ellenőrizd, hogy vannak-e tűzfal szabályok, amelyek blokkolják a kapcsolatot, vagy hogy az adatbázis hoszt helyes-e. |
| "Too many connections" | Az adatbázis elérte a maximális kapcsolati korlátját. Ez előfordulhat, ha az erőforrások nem zárják le megfelelően a kapcsolatokat, vagy ha a korlát túl alacsony. Indítsd újra a szervert és ellenőrizd a MySQL max_connections beállítást. |
Tipp: Ha a RedM szervered és a MySQL adatbázis ugyanazon a gépen van, használd a
localhost vagy 127.0.0.1 hosztot. Ha különböző szervereken vannak, használd az adatbázis szerver IP-címét és győződj meg róla, hogy a MySQL felhasználó rendelkezik távoli csatlakozási jogosultságokkal.
Hiányzó táblák vagy séma hibák
A roleplay keretrendszerek gyakran igénylik az adatbázis táblák beállítását a működésük előtt:
- Ellenőrizd a keretrendszer dokumentációját vagy GitHub adattárát SQL import fájlokért (gyakran
database.sql,schema.sqlvagy hasonló nevűek). - Importáld az SQL fájlt az adatbázisodba phpMyAdmin-on vagy MySQL klienssel.
- Egyes keretrendszerek automatikusan létrehozzák a táblákat az első indításkor. Győződj meg róla, hogy az adatbázis felhasználó rendelkezik
CREATE TABLEjogosultsággal.
Teljesítményproblémák
Ha a RedM szervered késést, alacsony tick rate-et vagy általános gyenge teljesítményt tapasztal:
Teljesítményproblémák azonosítása
Ellenőrizd a szerver konzolt teljesítmény figyelmeztetésekért. A RedM szerverek kb. 30-64 tick/másodperc tick rate-et céloznak. Ezt a következőkkel monitorozhatod:
- txAdmin irányítópult: Ha elérhető a txAdmin, valós idejű szerver teljesítmény mérőszámokat mutat.
- Szerver konzol: Figyelj a "slow tick" vagy "resource hitch" figyelmeztetésekre.
- resmon parancs: Írd be a
resmon 1parancsot a szerver konzolba (vagy F8 konzolba) az erőforrás monitor engedélyezéséhez, amely erőforrásonként mutatja a CPU időt.
Gyakori teljesítménymegoldások
| Probléma | Megoldás |
|---|---|
| Magas CPU használat egy adott erőforrástól | Használd a resmon 1 parancsot az erőforrás azonosításához. Fontold meg egy optimalizáltabb alternatívával való cserét, vagy lépj kapcsolatba az erőforrás fejlesztőjével. |
| Túl sok erőforrás betöltve | Minden erőforrás szerver erőforrásokat fogyaszt. Auditáld az erőforráslistádat és távolítsd el a nem használtakat vagy feleslegeseket. |
| Adatbázis lekérdezési szűk keresztmetszet | A lassú vagy indexeletlen adatbázis-lekérdezések szerver akadozást okozhatnak. Ellenőrizd az oxmysql lassú lekérdezési figyelmeztetéseit a konzolban. Adj hozzá indexeket a gyakran lekérdezett oszlopokhoz. |
| Magas játékosszám okozta késés | Csökkentsd az sv_maxclients értéket olyan szintre, amelyet a szerver hardvered elbír. Fontold meg a hosztolási csomagod frissítését több erőforrásért. |
| OneSync entitás korlátok | A túl sok létrehozott entitás (NPC-k, járművek, objektumok) ronthatja a teljesítményt. Használj olyan erőforrásokat, amelyek eltávolítják a nem használt entitásokat. |
| Memóriaszivárgások | Egyes rosszul kódolt erőforrások idővel memóriát szivárogtatnak. Monitorozd a szerver RAM használatát a GPanel-ben. A rendszeres szerver újraindítások (6-12 óránként) enyhíthetik ezt. |
Ajánlott gyakorlatok
- Ütemezz automatikus újraindításokat 6-12 óránként a GPanel ütemezési funkciójával vagy txAdmin-nal a felhalmozódott memória- és entitásproblémák kiürítéséhez.
- Tartsd naprakészen az erőforrásokat a teljesítményjavítások és optimalizálások kihasználásához.
- Kerüld a duplikált funkcionalitást — ne futtass két erőforrást, amelyek ugyanazt csinálják (pl. két időjárás rendszer).
- Tesztelj új erőforrásokat tesztszerveren (vagy alacsony játékosszámmal), mielőtt a fő szerveredre telepíted.
- Monitorozd a szerver mérőszámokat rendszeresen a GPanel-en vagy txAdmin-on keresztül a problémák korai felismeréséhez.
Megjegyzés: Ha az optimalizálás ellenére folyamatosan teljesítményproblémákat tapasztalsz, a szerverednek magasabb szintű hosztolási csomagra lehet szüksége több CPU-val és RAM-mal. Lépj kapcsolatba támogatási csapatunkkal a frissítési lehetőségek megbeszéléséhez.
Általános hibaelhárítási tippek
- Mindig olvasd el a szerver konzol kimenetét. Szinte minden hiba tartalmaz egy üzenetet a konzolban, amely megmondja, mi ment rosszul és hol.
- Indítsd újra a szervert a konfigurációs változtatások után. A legtöbb
server.cfgváltoztatás teljes szerver újraindítást igényel az érvénybe lépéshez. - Tiltsd le az erőforrásokat egyenként a problémák elkülönítéséhez. Kommenteld ki az
ensuresorokat aserver.cfg-ben#jellel. - Készíts biztonsági mentéseket a működő konfigurációkról változtatások előtt. Töltsd le a
server.cfg-t és az adatbázist nagyobb frissítések előtt. - Ellenőrizd a Cfx.re fórumokat és dokumentációt a docs.fivem.net oldalon a hivatalos dokumentációért, amely mind a FiveM-re, mind a RedM-re vonatkozik.
- Ellenőrizd az erőforrás kompatibilitást a szervered verziójával. A régebbi verziókra épített erőforrások nem feltétlenül működnek a jelenlegi RedM buildekkel.
Kapcsolódó cikkek
- RedM szerver beállítási útmutató — Licenckulcsok, server.cfg konfiguráció, erőforrás-kezelés és csatlakozás.
- Hogyan találd meg a szervered IP-címét és portját
- Fájlok feltöltése SFTP-vel
- Első lépések az új szervereddel
Segítségre van szükséged?
Még mindig problémákat tapasztalsz a RedM szervereddel? Nyiss egy támogatási jegyet és mellékeld a szerver konzolodból származó hibaüzeneteket. Csapatunk segít a probléma diagnosztizálásában és megoldásában.
