Fejlfindingsguide til almindelige RedM-serverproblemer, herunder licensnøglefejl, serverbrowsersynlighed, ressourcefejl, klientforbindelser, databaseproblemer og ydeevneoptimering. For indledende opsætningsinstruktioner, se vores RedM Server Opsætningsguide.
Licensnøglefejl
Licensnøgleproblemer er det mest almindelige problem, når man starter en ny RedM-server. Her er de typiske fejl og deres løsninger:
"Invalid license key" eller "Could not authenticate"
| Årsag | Løsning |
|---|---|
| Licensnøglen er indtastet forkert eller har ekstra mellemrum | Kopiér nøglen direkte fra Keymaster. Fjern eventuelle indledende/efterfølgende mellemrum fra CFX_LICENSE opstartsvariablen i GPanel eller sv_licenseKey-linjen i server.cfg. |
| IP-adresse stemmer ikke overens | Nøglen er registreret til en anden IP end din servers faktiske IP. Gå til Keymaster, kontrollér den registrerede IP og opdatér den, så den matcher din server-IP vist i GPanel. |
| Nøgle angivet i både GPanel og server.cfg med forskellige værdier | Sørg for, at nøglen er konsistent. Det er bedst at angive den i GPanel-opstartsvariablen og lade egg'et håndtere videregivelsen til serveren. Fjern eller udkommenter sv_licenseKey fra server.cfg, hvis GPanel håndterer det. |
| Cfx.re-kontoproblem eller nøgle tilbagekaldt | Log ind på Keymaster og verificér, at nøglen stadig er aktiv. Generér en ny nøgle, hvis den gamle blev slettet eller er udløbet. |
| Keymaster-tjenesten er midlertidigt nede | Tjek Cfx.re statussiden for driftsforstyrrelser. Vent og prøv igen senere. |
Serveren vises ikke i browseren
Hvis din server kører, men spillere ikke kan finde den i RedM-serverbrowseren:
Tjekliste
- Vent mindst 5 minutter. Efter opstart har serveren brug for tid til at registrere sig hos Cfx.re-masterlisten. Nye servere kan tage flere minutter om at vises.
- Verificér, at licensnøglen er gyldig. Serveren vil ikke blive opført uden en fungerende licensnøgle. Tjek serverkonsollen for licensrelaterede fejl.
- Kontrollér endpoint-konfigurationen. Sørg for, at
endpoint_add_tcpogendpoint_add_udpiserver.cfgbruger den korrekte port:
Porten skal matche den, der er tildelt i GPanel.endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" - Tjek for "sv_master1" eller listeindstillinger. Sørg for, at du ikke ved et uheld har indstillet serveren til ikke at opføre sig selv. Der bør ikke være nogen
sv_master1 ""i din konfiguration (dette deaktiverer masterlisteregistrering). - Verificér, at serveren faktisk kører. Tjek GPanel-konsollen. Hvis serveren er crashet eller stoppet, vil den ikke vises i browseren.
- Prøv direkte forbindelse. Selvom serveren ikke er i browseren, bør direkte forbindelse fungere. Lad en spiller trykke F8 i RedM og skrive:
connect YOUR_SERVER_IP:PORT
http://YOUR_SERVER_IP:PORT/info.json i en webbrowser. Hvis serveren kører og er tilgængelig, vil den returnere et JSON-svar med serveroplysninger.
Fejl ved indlæsning af ressourcer
Ressourcefejl er almindelige, når man tilføjer nye scripts eller frameworks til sin server. Her er de hyppigste problemer:
"Could not find resource [resource_name]"
- Ressourcemappen eksisterer ikke i
resources/-mappen, eller er placeret forkert. - Mappenavnet matcher ikke det navn, der bruges i
ensure. Ressourcenavne skelner mellem store og små bogstaver. - Løsning: Verificér, at ressourcemappen eksisterer, og at navnet i
server.cfgmatcher nøjagtigt. Brug GPanel filhåndtering eller SFTP til at kontrollere.
"Failed to load resource [resource_name]: manifest error"
- Ressourcens
fxmanifest.luaeller__resource.luahar en syntaksfejl. - Manifestet refererer til filer, der ikke eksisterer i ressourcemappen.
- Løsning: Åbn manifestfilen og tjek for stavefejl, manglende kommaer eller referencer til ikke-eksisterende filer. Tjek serverkonsollen for det specifikke linjenummer for fejlen.
"Error loading script [filename]: [error details]"
- En Lua-, C#- eller JavaScript-fil inden for ressourcen har en syntaks- eller kørselsfejl.
- Løsning: Læs den fulde fejlmeddelelse i konsollen. Den vil inkludere filnavnet og linjenummeret. Almindelige årsager inkluderer:
- Manglende afhængigheder (en anden ressource der skal indlæses først)
- Forældet ressource der ikke er kompatibel med den aktuelle RedM-serverversion
- Forkerte konfigurationsværdier i ressourcens konfigurationsfil
Problemer med ressourceindlæsningsrækkefølge
Ressourcer i server.cfg indlæses i den rækkefølge, de vises. Hvis en ressource afhænger af en anden (f.eks. vorp_inventory afhænger af vorp_core), skal afhængigheden stå 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 klientforbindelse
Når spillere ikke kan oprette forbindelse til din server:
"Connection timed out" / "Failed to connect"
| Årsag | Løsning |
|---|---|
| Serveren kører ikke | Tjek GPanel-konsollen for at bekræfte, at serveren er online og ikke er crashet. |
| Forkert IP eller port | Verificér, at spilleren bruger den korrekte IP og port fra GPanel. Se How to Find Your Server IP and Port. |
| Endpoint-fejlkonfiguration | Sørg for, at endpoint_add_tcp og endpoint_add_udp i server.cfg bruger port 0.0.0.0:PORT, hvor PORT matcher GPanel. |
| Serveren er fuld | Tjek om sv_maxclients er nået. Forøg værdien, hvis din hostingplan tillader det. |
"Connection rejected by server"
- Serveradgangskode: Hvis
sv_passworder angivet, skal spilleren indtaste den korrekte adgangskode. - Whitelist/allowlist-ressource: Hvis du har en whitelist-ressource aktiveret, skal spilleren godkendes, før de kan oprette forbindelse.
- Udelukkelse: Spilleren kan være udelukket. Tjek din ban-liste eller database for deres identifikatorer.
Klienten crasher ved forbindelse
- En ressource på serveren sender ugyldige data eller har en klientside-scriptfejl, der crasher klienten.
- Løsning: Deaktivér nyligt tilføjede ressourcer én ad gangen for at identificere den problematiske. Tjek serverkonsollen for fejl under klientforbindelse.
- Sørg for, at spillerens RedM-klient er opdateret.
"Could not download file"-fejl
- Serveren forsøger at sende en stor fil (f.eks. et streaming-aktiv), der overskrider overførselsgrænser, eller forbindelsen er ustabil.
- Løsning: Reducér størrelsen på streamede aktiver, brug et CDN/ekstern hosting til store filer, hvis det understøttes, eller lad spilleren prøve forbindelsen igen.
Databaseproblemer (MySQL / oxmysql)
De fleste RedM-rollespilsframeworks bruger MySQL til persistent datalagring. Den mest almindelige databaseconnector er oxmysql.
Fejl ved forbindelsesfejl
Hvis oxmysql (eller en anden MySQL-connector) ikke kan oprette forbindelse, skal du kontrollere følgende:
# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"
| Fejl | Løsning |
|---|---|
ECONNREFUSED eller "Connection refused" |
MySQL-serveren kører ikke, host/port er forkert, eller MySQL-serveren accepterer ikke eksterne forbindelser. Verificér host, port, og at din databaseserver er online. |
ER_ACCESS_DENIED_ERROR |
Forkert brugernavn eller adgangskode i forbindelsesstrengen. Dobbelttjek legitimationsoplysninger i dit database-hostingpanel. |
ER_BAD_DB_ERROR |
Databasenavnet eksisterer ikke. Opret først databasen via dit databaseadministrationspanel (phpMyAdmin osv.). |
ETIMEDOUT |
Databaseserveren er utilgængelig. Tjek om der er firewallregler, der blokerer forbindelsen, eller om databasehosten er korrekt. |
| "Too many connections" | Databasen har nået sin maksimale forbindelsesgrænse. Dette kan ske, hvis ressourcer ikke lukker forbindelser korrekt, eller hvis grænsen er for lav. Genstart serveren og tjek din MySQL max_connections-indstilling. |
localhost eller 127.0.0.1 som host. Hvis de er på forskellige servere, brug databaseserverens IP-adresse og sørg for, at MySQL-brugeren har fjernforbindelsesrettigheder.
Manglende tabeller eller skemafejl
Rollespilsframeworks kræver ofte, at databasetabeller er opsat, før de kan fungere:
- Tjek frameworkets dokumentation eller GitHub-repository for SQL-importfiler (ofte navngivet
database.sql,schema.sqleller lignende). - Importér SQL-filen til din database ved hjælp af phpMyAdmin eller en MySQL-klient.
- Nogle frameworks opretter automatisk tabeller ved første start. Sørg for, at databasebrugeren har
CREATE TABLE-rettigheder.
Ydeevneproblemer
Hvis din RedM-server oplever lag, lav tick rate eller generelt dårlig ydeevne:
Identificering af ydeevneproblemer
Tjek serverkonsollen for ydeevneadvarsler. RedM-servere sigter mod en tick rate på omkring 30-64 ticks per sekund. Du kan overvåge dette med:
- txAdmin dashboard: Hvis txAdmin er tilgængelig, viser det serverens ydeevnemålinger i realtid.
- Serverkonsol: Hold øje med "slow tick" eller "resource hitch"-advarsler.
- resmon-kommando: Skriv
resmon 1i serverkonsollen (eller F8-konsollen) for at aktivere ressourcemonitoren, der viser CPU-tid per ressource.
Almindelige ydeevneløsninger
| Problem | Løsning |
|---|---|
| Højt CPU-forbrug fra en specifik ressource | Brug resmon 1 til at identificere ressourcen. Overvej at erstatte den med et mere optimeret alternativ, eller kontakt ressourceudvikleren. |
| For mange ressourcer indlæst | Hver ressource forbruger serverressourcer. Gennemgå din ressourceliste og fjern eventuelle ubrugte eller overflødige. |
| Databaseforespørgselsflaskehals | Langsomme eller uindekserede databaseforespørgsler kan forårsage serverrystelser. Tjek oxmysql slow query-advarsler i konsollen. Tilføj indekser til hyppigt forespurgte kolonner. |
| Højt antal spillere forårsager lag | Reducér sv_maxclients til et niveau, din serverhardware kan håndtere. Overvej at opgradere din hostingplan for flere ressourcer. |
| OneSync entitetsgrænser | For mange spawnede entiteter (peds, køretøjer, objekter) kan forringe ydeevnen. Brug ressourcer, der rydder op i ubrugte entiteter. |
| Hukommelseslækager | Nogle dårligt kodede ressourcer lækker hukommelse over tid. Overvåg serverens RAM-forbrug i GPanel. Regelmæssige servergenstarter (hver 6-12 timer) kan afhjælpe dette. |
Anbefalede fremgangsmåder
- Planlæg automatiske genstarter hver 6-12 timer ved hjælp af GPanel's planlægningsfunktion eller txAdmin for at rydde akkumulerede hukommelses- og entitetsproblemer.
- Hold ressourcer opdaterede for at drage fordel af ydeevnerettelser og optimeringer.
- Undgå duplikeret funktionalitet — kør ikke to ressourcer, der gør det samme (f.eks. to vejrsystemer).
- Test nye ressourcer på en staging-server (eller med lavt antal spillere), før du deployer til din hovedserver.
- Overvåg servermålinger regelmæssigt via GPanel eller txAdmin for at opdage problemer tidligt.
Generelle fejlfindingstips
- Læs altid serverkonsollens output. Næsten enhver fejl inkluderer en meddelelse i konsollen, der fortæller dig, hvad der gik galt og hvor.
- Genstart serveren efter konfigurationsændringer. De fleste ændringer i
server.cfgkræver en fuld servergenstart for at træde i kraft. - Deaktivér ressourcer én ad gangen for at isolere problemer. Udkommenter
ensure-linjer iserver.cfgmed#. - Lav sikkerhedskopier af fungerende konfigurationer, før du foretager ændringer. Download din
server.cfgog database før større opdateringer. - Tjek Cfx.re-fora og dokumentation på docs.fivem.net for officiel dokumentation, der gælder for både FiveM og RedM.
- Verificér ressourcekompatibilitet med din serverversion. Ressourcer bygget til ældre versioner fungerer muligvis ikke med aktuelle RedM-builds.
Relaterede artikler
- RedM Server Opsætningsguide — Licensnøgler, server.cfg-konfiguration, ressourcestyring og oprettelse af forbindelse.
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Getting Started with Your New Server
Brug for hjælp?
Oplever du stadig problemer med din RedM-server? Opret en supportbillet og inkludér eventuelle fejlmeddelelser fra din serverkonsol. Vores team vil hjælpe dig med at diagnosticere og løse problemet.