Vianmääritysopas yleisiin RedM-palvelimen ongelmiin, mukaan lukien lisenssiavainvirheet, palvelinselaimen näkyvyys, resurssivirheet, asiakasyhteydet, tietokantaongelmat ja suorituskyvyn optimointi. Alkuasennusohjeita varten katso RedM-palvelimen asennusopas.
Lisenssiavainvirheet
Lisenssiavainongelmat ovat yleisin ongelma uutta RedM-palvelinta käynnistettäessä. Tässä ovat tyypilliset virheet ja niiden ratkaisut:
"Invalid license key" tai "Could not authenticate"
| Syy | Ratkaisu |
|---|---|
| Lisenssiavain on kirjoitettu väärin tai siinä on ylimääräisiä välilyöntejä | Kopioi avain suoraan Keymasterista. Poista mahdolliset alku-/loppuvälilyönnit CFX_LICENSE-käynnistysmuuttujasta GPanelissa tai sv_licenseKey-riviltä tiedostossa server.cfg. |
| IP-osoitteen ristiriita | Avain on rekisteröity eri IP-osoitteeseen kuin palvelimesi todellinen IP. Siirry Keymasteriin, tarkista rekisteröity IP ja päivitä se vastaamaan GPanelissa näkyvää palvelimesi IP-osoitetta. |
| Avain asetettu sekä GPanelissa että server.cfg:ssä eri arvoilla | Varmista, että avain on yhdenmukainen. On parasta asettaa se GPanelin käynnistysmuuttujaan ja antaa egg-paketin välittää se palvelimelle. Poista tai kommentoi pois sv_licenseKey tiedostosta server.cfg, jos GPanel hoitaa sen. |
| Cfx.re-tiliongelma tai avain peruutettu | Kirjaudu sisään Keymasteriin ja varmista, että avain on edelleen aktiivinen. Luo uusi avain, jos vanha poistettiin tai vanheni. |
| Keymaster-palvelu on tilapäisesti alhaalla | Tarkista käyttökatkokset Cfx.re:n tilasivulta. Odota ja yritä myöhemmin uudelleen. |
Tärkeää: Jos sait äskettäin uuden palvelimen tai palvelimesi IP muuttui (esim. solmumigraation jälkeen), sinun täytyy päivittää IP Keymasterissa tai luoda uusi lisenssiavain. Vanha avain ei toimi eri IP-osoitteessa.
Palvelin ei näy selaimessa
Jos palvelimesi on käynnissä, mutta pelaajat eivät löydä sitä RedM-palvelinselaimesta:
Tarkistuslista
- Odota vähintään 5 minuuttia. Käynnistyksen jälkeen palvelin tarvitsee aikaa rekisteröityäkseen Cfx.re:n pääpalvelinluetteloon. Uusien palvelimien ilmestyminen voi kestää useita minuutteja.
- Varmista, että lisenssiavain on voimassa. Palvelinta ei listata ilman toimivaa lisenssiavainta. Tarkista palvelinkonsolista lisenssiin liittyvät virheet.
- Tarkista päätepisteen määritys. Varmista, että
endpoint_add_tcpjaendpoint_add_udptiedostossaserver.cfgkäyttävät oikeaa porttia:
Portin täytyy vastata GPanelissa määritettyä.endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" - Tarkista "sv_master1"- tai listausasetukset. Varmista, ettet ole vahingossa asettanut palvelinta olemaan listaamatta itseään. Määrityksessäsi ei tulisi olla
sv_master1 ""(tämä poistaa pääluetteloon rekisteröitymisen käytöstä). - Varmista, että palvelin on todella käynnissä. Tarkista GPanelin konsoli. Jos palvelin kaatui tai pysähtyi, se ei näy selaimessa.
- Kokeile suoraa yhdistämistä. Vaikka palvelin ei olisi selaimessa, suoran yhdistämisen pitäisi toimia. Pyydä pelaajaa painamaan F8 RedM:ssä ja kirjoittamaan:
connect YOUR_SERVER_IP:PORT
Vinkki: Voit varmistaa, että palvelimesi on tavoitettavissa, käyttämällä Cfx.re:n palvelinhakua. Kokeile siirtyä osoitteeseen
http://YOUR_SERVER_IP:PORT/info.json verkkoselaimessa. Jos palvelin on käynnissä ja tavoitettavissa, se palauttaa JSON-vastauksen palvelintiedoilla.
Resurssien latausvirheet
Resurssivirheet ovat yleisiä lisättäessä uusia skriptejä tai kehyksiä palvelimellesi. Tässä ovat yleisimmät ongelmat:
"Could not find resource [resource_name]"
- Resurssikansiota ei ole olemassa
resources/-hakemistossa, tai se on väärässä paikassa. - Kansion nimi ei vastaa
ensure-komennossa käytettyä nimeä. Resurssien nimet ovat kirjainkoosta riippuvaisia. - Korjaus: Varmista, että resurssikansio on olemassa ja että nimi tiedostossa
server.cfgvastaa täsmälleen. Käytä GPanelin tiedostonhallintaa tai SFTP:tä tarkistamiseen.
"Failed to load resource [resource_name]: manifest error"
- Resurssin
fxmanifest.lua- tai__resource.lua-tiedostossa on syntaksivirhe. - Manifesti viittaa tiedostoihin, joita ei ole resurssikansiossa.
- Korjaus: Avaa manifestitiedosto ja tarkista kirjoitusvirheet, puuttuvat pilkut tai viittaukset olemattomiin tiedostoihin. Tarkista palvelinkonsolista virheen tarkka rivinumero.
"Error loading script [filename]: [error details]"
- Resurssin sisällä olevassa Lua-, C#- tai JavaScript-tiedostossa on syntaksi- tai ajonaikainen virhe.
- Korjaus: Lue koko virheilmoitus konsolista. Se sisältää tiedoston nimen ja rivinumeron. Yleisiä syitä ovat:
- Puuttuvat riippuvuudet (toinen resurssi, joka täytyy ladata ensin)
- Vanhentunut resurssi, joka ei ole yhteensopiva nykyisen RedM-palvelinversion kanssa
- Virheelliset määritysarvot resurssin määritystiedostossa
Resurssien latausjärjestysongelmat
Resurssit tiedostossa server.cfg ladataan siinä järjestyksessä, jossa ne esiintyvät. Jos resurssi riippuu toisesta (esim. vorp_inventory riippuu resurssista vorp_core), riippuvuus täytyy listata ensin:
# 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
Varoitus: Jos resurssin lataus epäonnistuu, myös siitä riippuvat resurssit epäonnistuvat. Tarkista aina konsolin tuloste huolellisesti tunnistaaksesi perimmäisen syyn, joka on yleensä ensimmäinen näkyvä virhe.
Asiakasyhteysongelmat
Kun pelaajat eivät voi yhdistää palvelimellesi:
"Connection timed out" / "Failed to connect"
| Syy | Ratkaisu |
|---|---|
| Palvelin ei ole käynnissä | Tarkista GPanelin konsolista, että palvelin on verkossa eikä kaatunut. |
| Väärä IP tai portti | Varmista, että pelaaja käyttää oikeaa IP:tä ja porttia GPanelista. Katso Kuinka löytää palvelimesi IP ja portti. |
| Päätepisteen virheellinen määritys | Varmista, että endpoint_add_tcp ja endpoint_add_udp tiedostossa server.cfg käyttävät porttia 0.0.0.0:PORT, jossa PORT vastaa GPanelia. |
| Palvelin on täynnä | Tarkista, onko sv_maxclients saavutettu. Kasvata arvoa, jos isännöintipakettisi sallii sen. |
"Connection rejected by server"
- Palvelimen salasana: Jos
sv_passwordon asetettu, pelaajan täytyy syöttää oikea salasana. - Sallittujen lista / whitelist-resurssi: Jos sinulla on whitelist-resurssi käytössä, pelaaja täytyy hyväksyä ennen yhdistämistä.
- Porttikielto: Pelaajalla voi olla porttikielto. Tarkista porttikieltolistasi tai tietokantasi hänen tunnisteistaan.
Asiakas kaatuu yhdistettäessä
- Palvelimella oleva resurssi lähettää virheellistä dataa tai siinä on asiakaspuolen skriptivirhe, joka kaataa asiakkaan.
- Korjaus: Poista äskettäin lisätyt resurssit käytöstä yksi kerrallaan tunnistaaksesi ongelmallisen. Tarkista palvelinkonsolista virheet asiakkaan yhdistämisen aikana.
- Varmista, että pelaajan RedM-asiakas on ajan tasalla.
"Could not download file" -virheet
- Palvelin yrittää lähettää suuren tiedoston (esim. striimausresurssin), joka ylittää siirtorajat, tai yhteys on epävakaa.
- Korjaus: Pienennä striimattujen resurssien kokoa, käytä CDN:ää/ulkoista isännöintiä suurille tiedostoille jos tuettu, tai pyydä pelaajaa yrittämään yhteyttä uudelleen.
Tietokantaongelmat (MySQL / oxmysql)
Useimmat RedM-roolipelikehykset käyttävät MySQL:ää pysyvään tietojen tallennukseen. Yleisin tietokantaliitin on oxmysql.
Connection Failed -virheet
Jos oxmysql (tai muu MySQL-liitin) ei saa yhteyttä, tarkista seuraavat:
# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"| Virhe | Ratkaisu |
|---|---|
ECONNREFUSED tai "Connection refused" |
MySQL-palvelin ei ole käynnissä, host/portti on väärä, tai MySQL-palvelin ei hyväksy ulkoisia yhteyksiä. Varmista host, portti ja että tietokantapalvelimesi on verkossa. |
ER_ACCESS_DENIED_ERROR |
Väärä käyttäjänimi tai salasana yhteysmerkkijonossa. Tarkista tunnukset tietokantasi isännöintipaneelista. |
ER_BAD_DB_ERROR |
Tietokannan nimeä ei ole olemassa. Luo tietokanta ensin tietokannanhallintapaneelisi kautta (phpMyAdmin jne.). |
ETIMEDOUT |
Tietokantapalvelin ei ole tavoitettavissa. Tarkista, estävätkö palomuurisäännöt yhteyden, tai onko tietokannan host oikein. |
| "Too many connections" | Tietokanta on saavuttanut enimmäisyhteysrajansa. Näin voi käydä, jos resurssit eivät sulje yhteyksiä kunnolla, tai jos raja on liian alhainen. Käynnistä palvelin uudelleen ja tarkista MySQL:n max_connections-asetuksesi. |
Vinkki: Jos RedM-palvelimesi ja MySQL-tietokantasi ovat samalla koneella, käytä hostina
localhost tai 127.0.0.1. Jos ne ovat eri palvelimilla, käytä tietokantapalvelimen IP-osoitetta ja varmista, että MySQL-käyttäjällä on etäyhteysoikeudet.
Puuttuvat taulut tai skeemavirheet
Roolipelikehykset vaativat usein tietokantataulujen määrittämistä ennen kuin ne voivat toimia:
- Tarkista kehyksen dokumentaatio tai GitHub-tietovarasto SQL-tuontitiedostojen varalta (usein nimeltään
database.sql,schema.sqltai vastaava). - Tuo SQL-tiedosto tietokantaasi käyttäen phpMyAdminia tai MySQL-asiakasta.
- Jotkut kehykset luovat taulut automaattisesti ensimmäisellä käynnistyksellä. Varmista, että tietokantakäyttäjällä on
CREATE TABLE-oikeudet.
Suorituskykyongelmat
Jos RedM-palvelimesi kokee viivettä, alhaista tickrateä tai yleisesti huonoa suorituskykyä:
Suorituskykyongelmien tunnistaminen
Tarkista palvelinkonsolista suorituskykyvaroitukset. RedM-palvelimet tavoittelevat noin 30-64 tickin sekuntinopeutta. Voit valvoa tätä seuraavilla:
- txAdmin-hallintapaneeli: Jos txAdmin on saatavilla, se näyttää reaaliaikaiset palvelimen suorituskykymittarit.
- Palvelinkonsoli: Tarkkaile "slow tick"- tai "resource hitch" -varoituksia.
- resmon-komento: Kirjoita
resmon 1palvelinkonsoliin (tai F8-konsoliin) ottaaksesi käyttöön resurssivalvonnan, joka näyttää CPU-ajan resurssia kohden.
Yleisiä suorituskykyratkaisuja
| Ongelma | Ratkaisu |
|---|---|
| Tietyn resurssin korkea CPU-käyttö | Käytä komentoa resmon 1 tunnistaaksesi resurssin. Harkitse sen korvaamista optimoidummalla vaihtoehdolla tai ota yhteyttä resurssin kehittäjään. |
| Liian monta resurssia ladattuna | Jokainen resurssi kuluttaa palvelimen resursseja. Tarkasta resurssilistasi ja poista kaikki käyttämättömät tai turhat. |
| Tietokantakyselyn pullonkaula | Hitaat tai indeksoimattomat tietokantakyselyt voivat aiheuttaa palvelimen nykimistä. Tarkista oxmysql:n hitaiden kyselyiden varoitukset konsolista. Lisää indeksejä usein kysyttyihin sarakkeisiin. |
| Korkea pelaajamäärä aiheuttaa viivettä | Pienennä sv_maxclients tasolle, jonka palvelinlaitteistosi pystyy käsittelemään. Harkitse isännöintipaketin päivittämistä lisäresurssien saamiseksi. |
| OneSync-entiteettirajat | Liian monta luotua entiteettiä (pelihahmot, ajoneuvot, objektit) voi heikentää suorituskykyä. Käytä resursseja, jotka siivoavat käyttämättömät entiteetit. |
| Muistivuodot | Jotkut huonosti koodatut resurssit vuotavat muistia ajan myötä. Valvo palvelimen RAM-käyttöä GPanelissa. Säännölliset palvelimen uudelleenkäynnistykset (6-12 tunnin välein) voivat lieventää tätä. |
Suositellut käytännöt
- Ajasta automaattiset uudelleenkäynnistykset 6-12 tunnin välein käyttäen GPanelin ajastusominaisuutta tai txAdminia tyhjentääksesi kertyneet muisti- ja entiteettiongelmat.
- Pidä resurssit ajan tasalla hyötyäksesi suorituskykykorjauksista ja optimoinneista.
- Vältä päällekkäistä toiminnallisuutta — älä aja kahta resurssia, jotka tekevät saman asian (esim. kaksi sääjärjestelmää).
- Testaa uudet resurssit testipalvelimella (tai alhaisella pelaajamäärällä) ennen niiden käyttöönottoa pääpalvelimellasi.
- Valvo palvelinmittareita säännöllisesti GPanelin tai txAdminin kautta havaitaksesi ongelmat varhain.
Huomaa: Jos koet jatkuvasti suorituskykyongelmia optimoinnista huolimatta, palvelimesi saattaa tarvita korkeamman tason isännöintipaketin, jossa on enemmän CPU- ja RAM-resursseja. Ota yhteyttä tukitiimiimme keskustellaksesi päivitysvaihtoehdoista.
Yleisiä vianmääritysvinkkejä
- Lue aina palvelinkonsolin tuloste. Lähes jokainen virhe sisältää konsolissa viestin, joka kertoo, mikä meni pieleen ja missä.
- Käynnistä palvelin uudelleen määritysmuutosten jälkeen. Useimmat muutokset tiedostoon
server.cfgvaativat täyden palvelimen uudelleenkäynnistyksen tullakseen voimaan. - Poista resurssit käytöstä yksi kerrallaan ongelmien eristämiseksi. Kommentoi pois
ensure-rivit tiedostossaserver.cfgkäyttäen#-merkkiä. - Pidä varmuuskopiot toimivista määrityksistä ennen muutosten tekemistä. Lataa
server.cfg-tiedostosi ja tietokantasi ennen suuria päivityksiä. - Tarkista Cfx.re-foorumit ja -dokumentaatio osoitteessa docs.fivem.net virallisen dokumentaation osalta, joka pätee sekä FiveM:ään että RedM:ään.
- Varmista resurssien yhteensopivuus palvelinversiosi kanssa. Vanhemmille versioille rakennetut resurssit eivät välttämättä toimi nykyisten RedM-koontiversioiden kanssa.
Aiheeseen liittyvät artikkelit
- RedM-palvelimen asennusopas — Lisenssiavaimet, server.cfg-määritys, resurssien hallinta ja yhdistäminen.
- Kuinka löytää palvelimesi IP ja portti
- Kuinka ladata tiedostoja SFTP:n kautta
- Aloittaminen uuden palvelimesi kanssa
Tarvitsetko apua?
Onko RedM-palvelimesi kanssa edelleen ongelmia? Avaa tukipyyntö ja liitä mukaan kaikki virheilmoitukset palvelinkonsolistasi. Tiimimme auttaa sinua diagnosoimaan ja ratkaisemaan ongelman.
