Felsökningsguide för vanliga RedM-serverproblem inklusive licensnyckelfel, synlighet i serverwebbläsaren, resursfel, klientanslutningar, databasproblem och prestandaoptimering. För instruktioner om grundläggande installation, se vår Installationsguide för RedM-server.
Licensnyckelfel
Problem med licensnyckeln är det vanligaste problemet när man startar en ny RedM-server. Här är de typiska felen och deras lösningar:
"Invalid license key" eller "Could not authenticate"
| Orsak | Lösning |
|---|---|
| Licensnyckeln är felaktigt skriven eller har extra mellanslag | Kopiera nyckeln direkt från Keymaster. Ta bort eventuella inledande/efterföljande blanksteg från startvariabeln CFX_LICENSE i GPanel eller raden sv_licenseKey i server.cfg. |
| IP-adressen matchar inte | Nyckeln är registrerad till en annan IP än din servers faktiska IP. Gå till Keymaster, kontrollera den registrerade IP-adressen och uppdatera den så att den matchar din servers IP som visas i GPanel. |
| Nyckeln är angiven i både GPanel och server.cfg med olika värden | Se till att nyckeln är konsekvent. Det är bäst att ange den i GPanel-startvariabeln och låta egget hantera överföringen till servern. Ta bort eller kommentera ut sv_licenseKey från server.cfg om GPanel hanterar den. |
| Problem med Cfx.re-kontot eller nyckeln återkallad | Logga in på Keymaster och verifiera att nyckeln fortfarande är aktiv. Generera en ny nyckel om den gamla togs bort eller löpte ut. |
| Keymaster-tjänsten är tillfälligt nere | Kontrollera Cfx.re statussida för driftstörningar. Vänta och försök igen senare. |
Servern visas inte i webbläsaren
Om din server körs men spelare inte kan hitta den i RedM-serverwebbläsaren:
Checklista
- Vänta minst 5 minuter. Efter start behöver servern tid för att registreras hos Cfx.re-masterserverlistan. Nya servrar kan ta flera minuter att visas.
- Verifiera att licensnyckeln är giltig. Servern kommer inte att listas utan en fungerande licensnyckel. Kontrollera serverkonsolen för licensrelaterade fel.
- Kontrollera endpoint-konfigurationen. Se till att
endpoint_add_tcpochendpoint_add_udpiserver.cfganvänder rätt port:
Porten måste matcha den som tilldelats i GPanel.endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" - Kontrollera "sv_master1" eller listningsinställningar. Se till att du inte av misstag har ställt in servern på att inte lista sig själv. Det bör inte finnas något
sv_master1 ""i din konfiguration (detta inaktiverar registrering i masterlistan). - Verifiera att servern faktiskt körs. Kontrollera GPanel-konsolen. Om servern kraschade eller stoppades visas den inte i webbläsaren.
- Prova direktanslutning. Även om servern inte finns i webbläsaren bör direktanslutning fungera. Be en spelare trycka på F8 i RedM och skriva:
connect YOUR_SERVER_IP:PORT
http://YOUR_SERVER_IP:PORT/info.json i en webbläsare. Om servern körs och är tillgänglig kommer den att returnera ett JSON-svar med serverinformation.
Fel vid laddning av resurser
Resursfel är vanliga när man lägger till nya skript eller ramverk på sin server. Här är de vanligaste problemen:
"Could not find resource [resource_name]"
- Resursmappen finns inte i katalogen
resources/, eller är på fel plats. - Mappnamnet matchar inte namnet som används i
ensure. Resursnamn är skiftlägeskänsliga. - Åtgärd: Verifiera att resursmappen finns och att namnet i
server.cfgmatchar exakt. Använd GPanels filhanterare eller SFTP för att kontrollera.
"Failed to load resource [resource_name]: manifest error"
- Resursens
fxmanifest.luaeller__resource.luahar ett syntaxfel. - Manifestet refererar till filer som inte finns i resursmappen.
- Åtgärd: Öppna manifestfilen och kontrollera efter stavfel, saknade kommatecken eller referenser till obefintliga filer. Kontrollera serverkonsolen för det specifika radnumret för felet.
"Error loading script [filename]: [error details]"
- En Lua-, C#- eller JavaScript-fil i resursen har ett syntax- eller körtidsfel.
- Åtgärd: Läs hela felmeddelandet i konsolen. Det inkluderar filnamnet och radnumret. Vanliga orsaker är:
- Saknade beroenden (en annan resurs som måste laddas först)
- Föråldrad resurs som inte är kompatibel med den aktuella RedM-serverversionen
- Felaktiga konfigurationsvärden i resursens konfigurationsfil
Problem med laddningsordning för resurser
Resurser i server.cfg laddas i den ordning de visas. Om en resurs är beroende av en annan (t.ex. vorp_inventory är beroende av vorp_core) måste beroendet listas 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
Problem med klientanslutning
När spelare inte kan ansluta till din server:
"Connection timed out" / "Failed to connect"
| Orsak | Lösning |
|---|---|
| Servern körs inte | Kontrollera GPanel-konsolen för att bekräfta att servern är online och inte har kraschat. |
| Fel IP eller port | Verifiera att spelaren använder rätt IP och port från GPanel. Se Hur du hittar din server-IP och port. |
| Felkonfigurerad endpoint | Se till att endpoint_add_tcp och endpoint_add_udp i server.cfg använder porten 0.0.0.0:PORT där PORT matchar GPanel. |
| Servern är full | Kontrollera om sv_maxclients har uppnåtts. Öka värdet om ditt hostingpaket tillåter det. |
"Connection rejected by server"
- Serverlösenord: Om
sv_passwordär inställt måste spelaren ange rätt lösenord. - Whitelist/allowlist-resurs: Om du har en whitelist-resurs aktiverad måste spelaren godkännas innan anslutning.
- Ban: Spelaren kan vara bannlyst. Kontrollera din ban-lista eller databas för deras identifierare.
Klienten kraschar vid anslutning
- En resurs på servern skickar dålig data eller har ett skriptfel på klientsidan som kraschar klienten.
- Åtgärd: Inaktivera nyligen tillagda resurser en i taget för att identifiera den problematiska. Kontrollera serverkonsolen för fel under klientanslutning.
- Se till att spelarens RedM-klient är uppdaterad.
"Could not download file"-fel
- Servern försöker skicka en stor fil (t.ex. en streaming-tillgång) som överskrider överföringsgränserna eller så är anslutningen instabil.
- Åtgärd: Minska storleken på streamade tillgångar, använd ett CDN/extern hosting för stora filer om det stöds, eller be spelaren försöka ansluta igen.
Databasproblem (MySQL / oxmysql)
De flesta RedM-rollspelsramverk använder MySQL för permanent datalagring. Den vanligaste databasanslutningen är oxmysql.
Connection Failed-fel
Om oxmysql (eller en annan MySQL-anslutning) inte kan ansluta, kontrollera följande:
# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"
| Fel | Lösning |
|---|---|
ECONNREFUSED eller "Connection refused" |
MySQL-servern körs inte, värden/porten är fel, eller MySQL-servern accepterar inte externa anslutningar. Verifiera värden, porten och att din databasserver är online. |
ER_ACCESS_DENIED_ERROR |
Fel användarnamn eller lösenord i anslutningssträngen. Dubbelkolla uppgifterna i din databashostingpanel. |
ER_BAD_DB_ERROR |
Databasnamnet finns inte. Skapa databasen först via din databashanteringspanel (phpMyAdmin etc.). |
ETIMEDOUT |
Databasservern är onåbar. Kontrollera om det finns brandväggsregler som blockerar anslutningen, eller om databasvärden är korrekt. |
| "Too many connections" | Databasen har nått sin maximala anslutningsgräns. Detta kan hända om resurser inte stänger anslutningar korrekt, eller om gränsen är för låg. Starta om servern och kontrollera din MySQL-inställning för max_connections. |
localhost eller 127.0.0.1 som värd. Om de finns på olika servrar, använd databasserverns IP-adress och se till att MySQL-användaren har behörighet för fjärranslutning.
Saknade tabeller eller schemafel
Rollspelsramverk kräver ofta att databastabeller ställs in innan de kan fungera:
- Kontrollera ramverkets dokumentation eller GitHub-repository för SQL-importfiler (ofta namngivna
database.sql,schema.sqleller liknande). - Importera SQL-filen till din databas med phpMyAdmin eller en MySQL-klient.
- Vissa ramverk skapar tabeller automatiskt vid första start. Se till att databasanvändaren har behörighet för
CREATE TABLE.
Prestandaproblem
Om din RedM-server upplever lagg, låg tick-frekvens eller generellt dålig prestanda:
Identifiera prestandaproblem
Kontrollera serverkonsolen för prestandavarningar. RedM-servrar siktar på en tick-frekvens på cirka 30-64 tick per sekund. Du kan övervaka detta med:
- txAdmin-instrumentpanel: Om txAdmin är tillgängligt visar den serverprestandamätvärden i realtid.
- Serverkonsol: Håll utkik efter varningar om "slow tick" eller "resource hitch".
- resmon-kommando: Skriv
resmon 1i serverkonsolen (eller F8-konsolen) för att aktivera resursövervakaren, som visar CPU-tid per resurs.
Vanliga prestandalösningar
| Problem | Lösning |
|---|---|
| Hög CPU-användning från en specifik resurs | Använd resmon 1 för att identifiera resursen. Överväg att ersätta den med ett mer optimerat alternativ, eller kontakta resursutvecklaren. |
| För många resurser laddade | Varje resurs förbrukar serverresurser. Granska din resurslista och ta bort sådana som är oanvända eller överflödiga. |
| Flaskhals i databasförfrågningar | Långsamma eller oindexerade databasförfrågningar kan orsaka serverhack. Kontrollera oxmysqls varningar om långsamma förfrågningar i konsolen. Lägg till index på kolumner som ofta efterfrågas. |
| Högt spelarantal orsakar lagg | Minska sv_maxclients till en nivå som din serverhårdvara kan hantera. Överväg att uppgradera ditt hostingpaket för mer resurser. |
| OneSync-entitetsgränser | För många spawnade entiteter (peds, fordon, objekt) kan försämra prestandan. Använd resurser som rensar upp oanvända entiteter. |
| Minnesläckor | Vissa dåligt kodade resurser läcker minne över tid. Övervaka serverns RAM-användning i GPanel. Regelbundna omstarter av servern (var 6-12:e timme) kan mildra detta. |
Rekommenderade metoder
- Schemalägg automatiska omstarter var 6-12:e timme med GPanels schemafunktion eller txAdmin för att rensa ackumulerade minnes- och entitetsproblem.
- Håll resurser uppdaterade för att dra nytta av prestandafixar och optimeringar.
- Undvik dubblerad funktionalitet — kör inte två resurser som gör samma sak (t.ex. två vädersystem).
- Testa nya resurser på en staging-server (eller med lågt spelarantal) innan du distribuerar till din huvudserver.
- Övervaka servermätvärden regelbundet via GPanel eller txAdmin för att upptäcka problem tidigt.
Allmänna felsökningstips
- Läs alltid serverkonsolens utdata. Nästan varje fel inkluderar ett meddelande i konsolen som talar om vad som gick fel och var.
- Starta om servern efter konfigurationsändringar. De flesta ändringar i
server.cfgkräver en fullständig omstart av servern för att träda i kraft. - Inaktivera resurser en i taget för att isolera problem. Kommentera ut
ensure-rader iserver.cfgmed#. - Behåll säkerhetskopior av fungerande konfigurationer innan du gör ändringar. Ladda ner din
server.cfgoch databas före större uppdateringar. - Kontrollera Cfx.re-forum och dokumentation på docs.fivem.net för officiell dokumentation som gäller både FiveM och RedM.
- Verifiera resurskompatibilitet med din serverversion. Resurser byggda för äldre versioner kanske inte fungerar med aktuella RedM-builds.
Relaterade artiklar
- Installationsguide för RedM-server — Licensnycklar, server.cfg-konfiguration, resurshantering och anslutning.
- Hur du hittar din server-IP och port
- Hur du laddar upp filer via SFTP
- Kom igång med din nya server
Behöver du hjälp?
Upplever du fortfarande problem med din RedM-server? Öppna ett supportärende och inkludera eventuella felmeddelanden från din serverkonsol. Vårt team hjälper dig att diagnostisera och lösa problemet.