Feilsøkingsveiledning for vanlige RedM-serverproblemer, inkludert lisensnøkkelfeil, synlighet i serverlisten, ressursfeil, klienttilkoblinger, databaseproblemer og ytelsesoptimalisering. For innledende oppsettsinstruksjoner, se vår Oppsettsveiledning for RedM-server.
Lisensnøkkelfeil
Lisensnøkkelproblemer er det vanligste problemet når man starter en ny RedM-server. Her er de typiske feilene og løsningene deres:
"Invalid license key" eller "Could not authenticate"
| Årsak | Løsning |
|---|---|
| Lisensnøkkelen er feilskrevet eller har ekstra mellomrom | Kopier nøkkelen direkte fra Keymaster. Fjern eventuelle foran- eller etterstilte mellomrom fra oppstartsvariabelen CFX_LICENSE i GPanel eller sv_licenseKey-linjen i server.cfg. |
| IP-adressemismatch | Nøkkelen er registrert til en annen IP enn serverens faktiske IP. Gå til Keymaster, sjekk den registrerte IP-en, og oppdater den slik at den samsvarer med serverens IP vist i GPanel. |
| Nøkkel angitt i både GPanel og server.cfg med ulike verdier | Sørg for at nøkkelen er konsistent. Det er best å angi den i GPanel-oppstartsvariabelen og la egget håndtere videresendingen til serveren. Fjern eller kommenter ut sv_licenseKey fra server.cfg hvis GPanel håndterer den. |
| Problem med Cfx.re-konto eller nøkkel tilbakekalt | Logg inn på Keymaster og bekreft at nøkkelen fortsatt er aktiv. Generer en ny nøkkel hvis den gamle ble slettet eller utløpt. |
| Keymaster-tjenesten er midlertidig nede | Sjekk Cfx.re statusside for driftsavbrudd. Vent og prøv igjen senere. |
Server vises ikke i listen
Hvis serveren din kjører, men spillere ikke finner den i RedM-serverlisten:
Sjekkliste
- Vent minst 5 minutter. Etter oppstart trenger serveren tid på å registrere seg med Cfx.re-masterserverlisten. Nye servere kan ta flere minutter på å vises.
- Bekreft at lisensnøkkelen er gyldig. Serveren vil ikke bli oppført uten en fungerende lisensnøkkel. Sjekk serverkonsollen for lisensrelaterte feil.
- Sjekk endepunktkonfigurasjonen. Sørg for at
endpoint_add_tcpogendpoint_add_udpiserver.cfgbruker riktig port:
Porten må samsvare med den som er tildelt i GPanel.endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" - Sjekk "sv_master1"- eller oppførings-innstillinger. Sørg for at du ikke ved et uhell har satt serveren til ikke å oppføre seg selv. Det skal ikke være noen
sv_master1 ""i konfigurasjonen din (dette deaktiverer registrering i masterlisten). - Bekreft at serveren faktisk kjører. Sjekk GPanel-konsollen. Hvis serveren krasjet eller stoppet, vil den ikke vises i listen.
- Prøv direkte tilkobling. Selv om serveren ikke er i listen, bør direkte tilkobling fungere. Få en spiller til å trykke F8 i RedM og skrive:
connect YOUR_SERVER_IP:PORT
http://YOUR_SERVER_IP:PORT/info.json i en nettleser. Hvis serveren kjører og er tilgjengelig, vil den returnere et JSON-svar med serverinformasjon.
Feil ved lasting av ressurser
Ressursfeil er vanlige når man legger til nye skript eller rammeverk på serveren. Her er de hyppigste problemene:
"Could not find resource [resource_name]"
- Ressursmappen finnes ikke i
resources/-mappen, eller er på feil sted. - Mappenavnet samsvarer ikke med navnet brukt i
ensure. Ressursnavn skiller mellom store og små bokstaver. - Løsning: Bekreft at ressursmappen finnes og at navnet i
server.cfgsamsvarer nøyaktig. Bruk GPanel-filbehandler eller SFTP for å sjekke.
"Failed to load resource [resource_name]: manifest error"
- Ressursens
fxmanifest.luaeller__resource.luahar en syntaksfeil. - Manifestet refererer til filer som ikke finnes i ressursmappen.
- Løsning: Åpne manifestfilen og sjekk for skrivefeil, manglende kommaer eller referanser til ikke-eksisterende filer. Sjekk serverkonsollen for det spesifikke linjenummeret til feilen.
"Error loading script [filename]: [error details]"
- En Lua-, C#- eller JavaScript-fil i ressursen har en syntaks- eller kjøretidsfeil.
- Løsning: Les hele feilmeldingen i konsollen. Den vil inkludere filnavnet og linjenummeret. Vanlige årsaker inkluderer:
- Manglende avhengigheter (en annen ressurs som må lastes først)
- Utdatert ressurs som ikke er kompatibel med gjeldende RedM-serverversjon
- Feil konfigurasjonsverdier i ressursens konfigurasjonsfil
Problemer med lasterekkefølge for ressurser
Ressurser i server.cfg lastes i den rekkefølgen de vises. Hvis en ressurs er avhengig av en annen (f.eks. vorp_inventory er avhengig av vorp_core), må avhengigheten oppføres først:
# 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
Problemer med klienttilkobling
Når spillere ikke kan koble til serveren din:
"Connection timed out" / "Failed to connect"
| Årsak | Løsning |
|---|---|
| Serveren kjører ikke | Sjekk GPanel-konsollen for å bekrefte at serveren er online og ikke har krasjet. |
| Feil IP eller port | Bekreft at spilleren bruker riktig IP og port fra GPanel. Se Slik finner du server-IP-en og porten din. |
| Feilkonfigurasjon av endepunkt | Sørg for at endpoint_add_tcp og endpoint_add_udp i server.cfg bruker port 0.0.0.0:PORT der PORT samsvarer med GPanel. |
| Serveren er full | Sjekk om sv_maxclients er nådd. Øk verdien hvis hostingplanen din tillater det. |
"Connection rejected by server"
- Serverpassord: Hvis
sv_passworder satt, må spilleren skrive inn riktig passord. - Whitelist/allowlist-ressurs: Hvis du har en whitelist-ressurs aktivert, må spilleren godkjennes før tilkobling.
- Utestengelse: Spilleren kan være utestengt. Sjekk utestengelseslisten eller databasen din for deres identifikatorer.
Klienten krasjer ved tilkobling
- En ressurs på serveren sender feilaktige data eller har en klientside-skriptfeil som krasjer klienten.
- Løsning: Deaktiver nylig tillagte ressurser én om gangen for å identifisere den problematiske. Sjekk serverkonsollen for feil under klienttilkobling.
- Sørg for at spillerens RedM-klient er oppdatert.
"Could not download file"-feil
- Serveren prøver å sende en stor fil (f.eks. en streaming-ressurs) som overstiger overføringsgrensene, eller forbindelsen er ustabil.
- Løsning: Reduser størrelsen på strømmede ressurser, bruk en CDN/ekstern hosting for store filer hvis støttet, eller få spilleren til å prøve tilkoblingen på nytt.
Databaseproblemer (MySQL / oxmysql)
De fleste RedM-rollespillrammeverk bruker MySQL for vedvarende datalagring. Den vanligste databasekoblingen er oxmysql.
Feil ved tilkobling mislyktes
Hvis oxmysql (eller en annen MySQL-kobling) ikke klarer å koble til, sjekk følgende:
# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"
| Feil | Løsning |
|---|---|
ECONNREFUSED eller "Connection refused" |
MySQL-serveren kjører ikke, verten/porten er feil, eller MySQL-serveren godtar ikke eksterne tilkoblinger. Bekreft verten, porten og at databaseserveren din er online. |
ER_ACCESS_DENIED_ERROR |
Feil brukernavn eller passord i tilkoblingsstrengen. Dobbeltsjekk legitimasjonen i databasens hostingpanel. |
ER_BAD_DB_ERROR |
Databasenavnet finnes ikke. Opprett databasen først via databasens administrasjonspanel (phpMyAdmin osv.). |
ETIMEDOUT |
Databaseserveren er utilgjengelig. Sjekk om det finnes brannmurregler som blokkerer tilkoblingen, eller om databaseverten er riktig. |
| "Too many connections" | Databasen har nådd sin maksimale tilkoblingsgrense. Dette kan skje hvis ressurser ikke lukker tilkoblinger riktig, eller hvis grensen er for lav. Start serveren på nytt og sjekk MySQL-innstillingen max_connections. |
localhost eller 127.0.0.1 som vert. Hvis de er på forskjellige servere, bruk databaseserverens IP-adresse og sørg for at MySQL-brukeren har eksterne tilkoblingsrettigheter.
Manglende tabeller eller skjemafeil
Rollespillrammeverk krever ofte at databasetabeller settes opp før de kan fungere:
- Sjekk rammeverkets dokumentasjon eller GitHub-repository for SQL-importfiler (ofte kalt
database.sql,schema.sqleller lignende). - Importer SQL-filen til databasen din ved hjelp av phpMyAdmin eller en MySQL-klient.
- Noen rammeverk oppretter tabeller automatisk ved første oppstart. Sørg for at databasebrukeren har
CREATE TABLE-rettigheter.
Ytelsesproblemer
Hvis RedM-serveren din opplever lag, lav tick-rate eller generelt dårlig ytelse:
Identifisere ytelsesproblemer
Sjekk serverkonsollen for ytelsesadvarsler. RedM-servere sikter mot en tick-rate på rundt 30-64 ticks per sekund. Du kan overvåke dette med:
- txAdmin-dashbord: Hvis txAdmin er tilgjengelig, viser det sanntids ytelsesmålinger for serveren.
- Serverkonsoll: Se etter "slow tick"- eller "resource hitch"-advarsler.
- resmon-kommando: Skriv
resmon 1i serverkonsollen (eller F8-konsollen) for å aktivere ressursovervåkeren, som viser CPU-tid per ressurs.
Vanlige ytelsesløsninger
| Problem | Løsning |
|---|---|
| Høy CPU-bruk fra en bestemt ressurs | Bruk resmon 1 for å identifisere ressursen. Vurder å erstatte den med et mer optimalisert alternativ, eller kontakt ressursutvikleren. |
| For mange ressurser lastet | Hver ressurs forbruker serverressurser. Gjennomgå ressurslisten din og fjern alle som er ubrukte eller overflødige. |
| Flaskehals i databasespørringer | Trege eller uindekserte databasespørringer kan forårsake serverhakking. Sjekk oxmysql-advarsler om trege spørringer i konsollen. Legg til indekser på kolonner det ofte spørres mot. |
| Høyt spillerantall forårsaker lag | Reduser sv_maxclients til et nivå serverens maskinvare kan håndtere. Vurder å oppgradere hostingplanen din for flere ressurser. |
| OneSync-entitetsgrenser | For mange spawnede entiteter (peds, kjøretøy, objekter) kan forringe ytelsen. Bruk ressurser som rydder opp ubrukte entiteter. |
| Minnelekkasjer | Noen dårlig kodede ressurser lekker minne over tid. Overvåk serverens RAM-bruk i GPanel. Regelmessige serveromstarter (hver 6.-12. time) kan dempe dette. |
Anbefalte praksiser
- Planlegg automatiske omstarter hver 6.-12. time ved hjelp av GPanels planleggingsfunksjon eller txAdmin for å fjerne akkumulerte minne- og entitetsproblemer.
- Hold ressurser oppdatert for å dra nytte av ytelsesrettelser og optimaliseringer.
- Unngå duplisert funksjonalitet — ikke kjør to ressurser som gjør det samme (f.eks. to værsystemer).
- Test nye ressurser på en staging-server (eller med lavt spillerantall) før de distribueres til hovedserveren din.
- Overvåk servermålinger regelmessig gjennom GPanel eller txAdmin for å fange opp problemer tidlig.
Generelle feilsøkingstips
- Les alltid serverkonsollutdataene. Nesten hver feil inkluderer en melding i konsollen som forteller deg hva som gikk galt og hvor.
- Start serveren på nytt etter konfigurasjonsendringer. De fleste endringer i
server.cfgkrever en full serveromstart for å tre i kraft. - Deaktiver ressurser én om gangen for å isolere problemer. Kommenter ut
ensure-linjer iserver.cfgmed#. - Behold sikkerhetskopier av fungerende konfigurasjoner før du gjør endringer. Last ned
server.cfgog databasen din før store oppdateringer. - Sjekk Cfx.re-forumer og -dokumentasjon på docs.fivem.net for offisiell dokumentasjon som gjelder både FiveM og RedM.
- Bekreft ressurskompatibilitet med serverversjonen din. Ressurser bygget for eldre versjoner fungerer kanskje ikke med gjeldende RedM-bygg.
Relaterte artikler
- Oppsettsveiledning for RedM-server — Lisensnøkler, server.cfg-konfigurasjon, ressursforvaltning og tilkobling.
- Slik finner du server-IP-en og porten din
- Slik laster du opp filer via SFTP
- Kom i gang med din nye server
Trenger du hjelp?
Opplever du fortsatt problemer med RedM-serveren din? Åpne en supportsak og inkluder eventuelle feilmeldinger fra serverkonsollen din. Teamet vårt vil hjelpe deg med å diagnostisere og løse problemet.