Vodič za rješavanje problema s čestim RedM serverskim problemima uključujući greške licencnog ključa, vidljivost u pregledniku servera, neuspjehe resursa, klijentske veze, probleme s bazom podataka i optimizaciju performansi. Za upute o početnom postavljanju, pogledajte naš RedM vodič za postavljanje servera.
Greške licencnog ključa
Problemi s licencnim ključem najčešći su problem prilikom pokretanja novog RedM servera. Evo tipičnih grešaka i njihovih rješenja:
"Invalid license key" ili "Could not authenticate"
| Uzrok | Rješenje |
|---|---|
| Licencni ključ je pogrešno upisan ili ima dodatne razmake | Kopirajte ključ izravno iz Keymaster-a. Uklonite sve vodeće/prateće razmake iz varijable pokretanja CFX_LICENSE u GPanel-u ili iz retka sv_licenseKey u datoteci server.cfg. |
| Nepodudaranje IP adrese | Ključ je registriran na drugu IP adresu od stvarne IP adrese vašeg servera. Idite u Keymaster, provjerite registriranu IP adresu i ažurirajte je da odgovara IP adresi vašeg servera prikazanoj u GPanel-u. |
| Ključ postavljen i u GPanel-u i u server.cfg s različitim vrijednostima | Provjerite je li ključ konzistentan. Najbolje ga je postaviti u GPanel varijabli pokretanja i pustiti egg da ga proslijedi serveru. Uklonite ili komentirajte sv_licenseKey iz datoteke server.cfg ako GPanel to obrađuje. |
| Problem s Cfx.re računom ili opozvan ključ | Prijavite se u Keymaster i provjerite je li ključ još aktivan. Generirajte novi ključ ako je stari izbrisan ili istekao. |
| Usluga Keymaster privremeno ne radi | Provjerite Cfx.re stranicu statusa za prekide. Pričekajte i pokušajte ponovno kasnije. |
Važno: Ako ste nedavno dobili novi server ili se IP adresa vašeg servera promijenila (npr. nakon migracije čvora), morate ažurirati IP adresu u Keymaster-u ili generirati novi licencni ključ. Stari ključ neće raditi na drugoj IP adresi.
Server se ne pojavljuje u pregledniku
Ako vaš server radi, ali igrači ga ne mogu pronaći u RedM pregledniku servera:
Kontrolni popis
- Pričekajte barem 5 minuta. Nakon pokretanja, serveru je potrebno vrijeme za registraciju na Cfx.re glavnom popisu servera. Novi serveri mogu trebati nekoliko minuta da se pojave.
- Provjerite je li licencni ključ valjan. Server neće biti naveden bez funkcionalnog licencnog ključa. Provjerite konzolu servera za greške vezane uz licencu.
- Provjerite konfiguraciju krajnjih točaka. Provjerite koriste li
endpoint_add_tcpiendpoint_add_udpu datoteciserver.cfgispravan port:
Port mora odgovarati onom dodijeljenom u GPanel-u.endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" - Provjerite "sv_master1" ili postavke popisivanja. Provjerite niste li slučajno postavili server da se ne prijavljuje na popis. U vašoj konfiguraciji ne bi trebalo biti
sv_master1 ""(ovo onemogućuje registraciju na glavni popis). - Provjerite radi li server zaista. Provjerite GPanel konzolu. Ako se server srušio ili zaustavio, neće se pojaviti u pregledniku.
- Pokušajte s izravnim povezivanjem. Čak i ako server nije u pregledniku, izravno povezivanje bi trebalo raditi. Neka igrač pritisne F8 u RedM-u i upiše:
connect YOUR_SERVER_IP:PORT
Savjet: Možete provjeriti je li vaš server dostupan koristeći Cfx.re pretraživanje servera. Pokušajte navigirati na
http://YOUR_SERVER_IP:PORT/info.json u web pregledniku. Ako server radi i dostupan je, vratit će JSON odgovor s informacijama o serveru.
Neuspjesi učitavanja resursa
Greške resursa su česte prilikom dodavanja novih skripti ili okvira na vaš server. Evo najčešćih problema:
"Could not find resource [resource_name]"
- Mapa resursa ne postoji u direktoriju
resources/ili se nalazi na pogrešnom mjestu. - Naziv mape ne odgovara nazivu korištenom u
ensure. Nazivi resursa razlikuju velika i mala slova. - Rješenje: Provjerite postoji li mapa resursa i odgovara li naziv u datoteci
server.cfgtočno. Koristite GPanel upravitelj datoteka ili SFTP za provjeru.
"Failed to load resource [resource_name]: manifest error"
- Datoteka
fxmanifest.luaili__resource.luaresursa ima sintaktičku grešku. - Manifest referencira datoteke koje ne postoje u mapi resursa.
- Rješenje: Otvorite manifest datoteku i provjerite ima li tipfelera, nedostajućih zareza ili referenci na nepostojeće datoteke. Provjerite konzolu servera za točan broj retka greške.
"Error loading script [filename]: [error details]"
- Lua, C# ili JavaScript datoteka unutar resursa ima sintaktičku ili runtime grešku.
- Rješenje: Pročitajte potpunu poruku greške u konzoli. Sadržavat će naziv datoteke i broj retka. Česti uzroci uključuju:
- Nedostajuće ovisnosti (drugi resurs koji mora biti učitan prvi)
- Zastarjeli resurs nekompatibilan s trenutnom verzijom RedM servera
- Netočne konfiguracijske vrijednosti u konfiguracijskoj datoteci resursa
Problemi s redoslijedom učitavanja resursa
Resursi u datoteci server.cfg učitavaju se redoslijedom kojim se pojavljuju. Ako resurs ovisi o drugom (npr. vorp_inventory ovisi o vorp_core), ovisnost mora biti navedena prva:
# 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
Upozorenje: Ako se resurs ne uspije učitati, svi resursi koji ovise o njemu također će se neuspješno učitati. Uvijek pažljivo provjerite izlaz konzole kako biste identificirali osnovni uzrok, koji je obično prva greška koja se pojavi.
Problemi s povezivanjem klijenata
Kada se igrači ne mogu povezati na vaš server:
"Connection timed out" / "Failed to connect"
| Uzrok | Rješenje |
|---|---|
| Server ne radi | Provjerite GPanel konzolu kako biste potvrdili da je server na mreži i da se nije srušio. |
| Pogrešna IP adresa ili port | Provjerite koristi li igrač ispravnu IP adresu i port iz GPanel-a. Pogledajte Kako pronaći IP adresu i port vašeg servera. |
| Pogrešna konfiguracija krajnjih točaka | Provjerite koriste li endpoint_add_tcp i endpoint_add_udp u server.cfg port 0.0.0.0:PORT gdje PORT odgovara GPanel-u. |
| Server je pun | Provjerite je li sv_maxclients dosegnut. Povećajte vrijednost ako vaš hosting plan to dopušta. |
"Connection rejected by server"
- Lozinka servera: Ako je
sv_passwordpostavljen, igrač mora unijeti ispravnu lozinku. - Whitelist/allowlist resurs: Ako imate omogućen whitelist resurs, igrač mora biti odobren prije povezivanja.
- Zabrana pristupa: Igrač je možda zabranjen. Provjerite svoj popis zabrana ili bazu podataka za njihove identifikatore.
Klijent se ruši prilikom povezivanja
- Resurs na serveru šalje loše podatke ili ima grešku u skripti na strani klijenta koja uzrokuje pad klijenta.
- Rješenje: Onemogućite nedavno dodane resurse jedan po jedan kako biste identificirali problematičan. Provjerite konzolu servera za greške tijekom povezivanja klijenta.
- Provjerite je li igračev RedM klijent ažuriran.
"Could not download file" greške
- Server pokušava poslati veliku datoteku (npr. streaming sredstvo) koja premašuje ograničenja prijenosa ili je veza nestabilna.
- Rješenje: Smanjite veličinu streamanih sredstava, koristite CDN/vanjski hosting za velike datoteke ako je podržano, ili neka igrač pokuša ponovno povezivanje.
Problemi s bazom podataka (MySQL / oxmysql)
Većina RedM roleplay okvira koristi MySQL za trajno pohranjivanje podataka. Najčešći konektor baze podataka je oxmysql.
Greške neuspjelog povezivanja
Ako se oxmysql (ili drugi MySQL konektor) ne može povezati, provjerite sljedeće:
# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"| Greška | Rješenje |
|---|---|
ECONNREFUSED ili "Connection refused" |
MySQL server ne radi, host/port je pogrešan ili MySQL server ne prihvaća vanjske veze. Provjerite host, port i je li vaš poslužitelj baze podataka na mreži. |
ER_ACCESS_DENIED_ERROR |
Pogrešno korisničko ime ili lozinka u poveznom nizu. Dvaput provjerite pristupne podatke u panelu za upravljanje bazom podataka. |
ER_BAD_DB_ERROR |
Naziv baze podataka ne postoji. Prvo izradite bazu podataka putem panela za upravljanje bazom podataka (phpMyAdmin, itd.). |
ETIMEDOUT |
Poslužitelj baze podataka nije dostupan. Provjerite postoje li pravila vatrozida koja blokiraju vezu ili je li host baze podataka ispravan. |
| "Too many connections" | Baza podataka je dosegla maksimalno ograničenje veza. To se može dogoditi ako resursi ne zatvaraju ispravno veze ili ako je ograničenje prenisko. Ponovno pokrenite server i provjerite postavku max_connections u MySQL-u. |
Savjet: Ako su vaš RedM server i MySQL baza podataka na istom stroju, koristite
localhost ili 127.0.0.1 kao host. Ako su na različitim serverima, koristite IP adresu poslužitelja baze podataka i provjerite ima li MySQL korisnik privilegije za udaljeno povezivanje.
Nedostajuće tablice ili greške sheme
Roleplay okviri često zahtijevaju postavljanje tablica baze podataka prije nego što mogu funkcionirati:
- Provjerite dokumentaciju okvira ili GitHub repozitorij za SQL datoteke za uvoz (često nazvane
database.sql,schema.sqlili slično). - Uvezite SQL datoteku u svoju bazu podataka koristeći phpMyAdmin ili MySQL klijent.
- Neki okviri automatski stvaraju tablice prilikom prvog pokretanja. Provjerite ima li korisnik baze podataka privilegiju
CREATE TABLE.
Problemi s performansama
Ako vaš RedM server ima kašnjenja, nizak tick rate ili općenito loše performanse:
Identificiranje problema s performansama
Provjerite konzolu servera za upozorenja o performansama. RedM serveri ciljaju tick rate od oko 30-64 tickova u sekundi. Možete to pratiti s:
- txAdmin nadzorna ploča: Ako je txAdmin dostupan, prikazuje metrike performansi servera u stvarnom vremenu.
- Konzola servera: Pratite upozorenja "slow tick" ili "resource hitch".
- Naredba resmon: Upišite
resmon 1u konzolu servera (ili F8 konzolu) za omogućavanje monitora resursa, koji prikazuje CPU vrijeme po resursu.
Česta rješenja za performanse
| Problem | Rješenje |
|---|---|
| Visoka upotreba CPU-a od određenog resursa | Koristite resmon 1 za identifikaciju resursa. Razmotrite zamjenu s optimiziranijom alternativom ili kontaktirajte razvojnog programera resursa. |
| Previše učitanih resursa | Svaki resurs troši resurse servera. Revidirajte svoj popis resursa i uklonite sve koji su nekorišteni ili redundantni. |
| Usko grlo upita baze podataka | Spori ili neindeksirani upiti baze podataka mogu uzrokovati zastoje servera. Provjerite oxmysql upozorenja o sporim upitima u konzoli. Dodajte indekse na često pretraživane stupce. |
| Velik broj igrača uzrokuje kašnjenje | Smanjite sv_maxclients na razinu koju hardver vašeg servera može podnijeti. Razmotrite nadogradnju hosting plana za više resursa. |
| Ograničenja OneSync entiteta | Previše stvorenih entiteta (pedovi, vozila, objekti) može degradirati performanse. Koristite resurse koji čiste nekorištene entitete. |
| Curenje memorije | Neki loše kodirani resursi cure memoriju tijekom vremena. Pratite upotrebu RAM-a servera u GPanel-u. Redovna ponovna pokretanja servera (svakih 6-12 sati) mogu ublažiti ovo. |
Preporučene prakse
- Zakažite automatska ponovna pokretanja svakih 6-12 sati koristeći značajku rasporeda u GPanel-u ili txAdmin za čišćenje nakupljene memorije i problema s entitetima.
- Održavajte resurse ažuriranima kako biste iskoristili popravke performansi i optimizacije.
- Izbjegavajte duplu funkcionalnost — ne pokretajte dva resursa koji rade istu stvar (npr. dva sustava vremena).
- Testirajte nove resurse na testnom serveru (ili s malim brojem igrača) prije postavljanja na vaš glavni server.
- Redovno pratite metrike servera putem GPanel-a ili txAdmin-a kako biste rano uočili probleme.
Napomena: Ako dosljedno imate probleme s performansama unatoč optimizaciji, vaš server možda treba hosting plan višeg ranga s više CPU i RAM resursa. Kontaktirajte naš tim za podršku za razgovor o opcijama nadogradnje.
Opći savjeti za rješavanje problema
- Uvijek čitajte izlaz konzole servera. Gotovo svaka greška uključuje poruku u konzoli koja vam govori što je pošlo po krivu i gdje.
- Ponovno pokrenite server nakon promjena konfiguracije. Većina promjena u datoteci
server.cfgzahtijeva potpuno ponovno pokretanje servera kako bi stupile na snagu. - Onemogućite resurse jedan po jedan kako biste izolirali probleme. Komentirajte
ensureretke u datoteciserver.cfgs#. - Čuvajte sigurnosne kopije radnih konfiguracija prije unošenja promjena. Preuzmite svoju datoteku
server.cfgi bazu podataka prije velikih ažuriranja. - Provjerite Cfx.re forume i dokumentaciju na docs.fivem.net za službenu dokumentaciju koja se odnosi i na FiveM i na RedM.
- Provjerite kompatibilnost resursa s verzijom vašeg servera. Resursi izrađeni za starije verzije možda neće raditi s trenutnim RedM buildovima.
Povezani članci
- RedM vodič za postavljanje servera — Licencni ključevi, konfiguracija server.cfg, upravljanje resursima i povezivanje.
- Kako pronaći IP adresu i port vašeg servera
- Kako prenijeti datoteke putem SFTP-a
- Započnite s vašim novim serverom
Trebate pomoć?
Još uvijek imate problema s vašim RedM serverom? Otvorite zahtjev za podršku i uključite sve poruke o greškama iz konzole vašeg servera. Naš tim će vam pomoći dijagnosticirati i riješiti problem.
