Kör en FiveM-server på CasaOS: guide för Docker-installation

Ja, en FiveM-server kan köras på en CasaOS-värd via Docker. Det var svaret i IceWhale Community-tråden från september 2023: användarens gamla speldator hade redan tillräckliga resurser för CasaOS-arbetsbelastningar, och communitymedlemmar påpekade att FiveM:s FXServer har Linux-versioner och kan köras som en anpassad CasaOS-app i en container.

Den historiska tråden använde tredjeparts- spritsail/fivem image och exponerade både FiveM-spelporten och txAdmin. Det är fortfarande en användbar startarkitektur, men den ska inte förväxlas med ett officiellt Cfx.re-paket för CasaOS. Den aktuella Cfx.re-dokumentationen stöder fortfarande FXServer på Linux, samtidigt som den uttryckligen varnar för att Linux-servern tillhandahålls som en tjänst och att Windows generellt har bättre kompatibilitets- och diagnostikstöd. År 2026 har Linux- och Docker-specifika FiveM-problem också fortsatt att dyka upp, så testa exakt den serverartefakt och spelversion du planerar att använda.

Vad den ursprungliga CasaOS-tråden bekräftade

Det ursprungliga inlägget på CasaOS-forumet frågade om en privat FiveM-server kunde köras på en äldre speldator som redan fungerade som CasaOS-server. Två svar gav det användbara svaret:

FiveM/FXServer kan köras på Linux och i Docker.
En anpassad CasaOS-app kan exponera de nödvändiga portarna och lagra konfiguration och data beständigt.
Servern behöver fortfarande en giltig Cfx.re-licensnyckel.
Maskinvaran måste vara tillräcklig för antalet spelare, resurser, skript och databasbelastning.

En startpunkt för Docker Compose från communityn

Svaret från 2023 föreslog en definition för en anpassad CasaOS-app baserad på tredjeparts- spritsail/fivem image:

services:
  fivem:
    image: spritsail/fivem
    restart: on-failure
    environment:
      LICENSE_KEY: YOUR_LICENSE_KEY
      NO_DEFAULT_CONFIG: 1
    ports:
      - "40120:40120"
      - "30120:30120"
      - "30120:30120/udp"
    volumes:
      - /DATA/AppData/fivem/config:/config
      - /DATA/AppData/fivem/data:/txData
    stdin_open: true
    tty: true

Detta är en historisk, källhärledd konfiguration och inte en appdefinition som underhålls av IceWhale. Läs den aktuella bildokumentationen innan du importerar den till ett aktivt CasaOS-system.

Vilka portar behöver FiveM?

Community-konfigurationen exponerade:

30120/TCP — huvudsaklig speltrafik för FXServer.
30120/UDP — huvudsaklig UDP-trafik för FXServer.
40120/TCP — txAdmins webbgränssnitt i källkonfigurationen.

Den aktuella Cfx.re-dokumentationen för txAdmin anger fortfarande port 40120 som standardport för txAdmins HTTP-gränssnitt. Se den aktuella txAdmin-dokumentationen.

Skapa en Cfx.re-licensnyckel

Den aktuella dokumentationen för Cfx.re-serverkonfiguration kräver en serverlicensnyckel innan FXServer startas. Registrera servern via det aktuella arbetsflödet i Cfx.re/Cfx Portal och håll nyckeln privat.

Officiell referens: Konfigurera en server.

Lägg inte in nyckeln i ett offentligt Git-arkiv och klistra inte in den i skärmbilder. CasaOS-miljövariabler är praktiska, men alla med administrativ åtkomst till Docker-konfigurationen kan kanske läsa dem.

Spara konfiguration och txAdmin-data beständigt

Den ursprungliga Compose-konfigurationen monterade:

/DATA/AppData/fivem/config → /config
/DATA/AppData/fivem/data   → /txData

Principen är viktigare än de exakta sökvägarna: serverkonfigurationen och txAdmin-profilerna bör ligga på beständig lagring på värden, så att återskapandet av containern inte raderar serverns tillstånd.

Säkerhetskopiera dessa kataloger innan du ändrar containeravbildningar eller serverartifakter.

Den aktuella FiveM-dokumentationen behandlar fortfarande Linux som en sekundär serverportering

Cfx.re:s aktuella dokumentation för vanliga installationer innehåller en viktig Linux-varning: Linux-versionen av FXServer tillhandahålls som en portering utan garantier, eftersom kompatibilitet mellan Linux-distributioner och inbyggda diagnostikverktyg kan vara svårare. Där står att problem troligare åtgärdas i Windows.

Det betyder inte att Linux-servrar är oanvändbara. Det innebär att en CasaOS Docker-distribution har ett extra kompatibilitetslager jämfört med en vanlig Windows-server med officiellt stöd.

Docker-specifika FiveM-problem finns fortfarande 2026

Nya rapporter om CitizenFX-problem visar att en Linux-FXServer kan köras korrekt i Docker, samtidigt som specifika påtvingade spelbyggen eller Enhanced-artifakter fortfarande kan orsaka containerspecifika fel. I ett exempel från 2026 återskapades en klientkrasch med sv_enforceGameBuild 3751 på Linux/Docker, medan samma vaniljcontainer fungerade utan den inställningen.

Därför garanterar inte en fungerande containerstart och en txAdmin-sida som går att nå att alla kombinationer av FiveM-artifakter och resurser är stabila.

Hur mycket hårdvara behöver du?

Det ursprungliga svaret från 2023 citerade gamla minimikrav för FiveM på datorer. Dessa värden är inte en tillförlitlig modern formel för dimensionering av servrar. Belastningen på en dedikerad server beror i hög grad på:

antal spelare;
antal ramverk och resurser;
kvaliteten på Lua-/JavaScript-/C#-skript;
databasbelastning;
OneSync-konfiguration;
ytterligare tjänster som MariaDB/MySQL.

För en liten privat server kan en äldre speldator vara tillräcklig, men prestanda i enkeltrådad CPU-körning och tillgängligt RAM är viktigare än att enbart matcha en historisk minimilista.

FiveM-ramverk kan behöva en separat databas

Om du installerar ESX, QBCore eller något annat ramverk kan FiveM-containern behöva nå en MariaDB-/MySQL-container. Placera båda tjänsterna i ett användardefinierat Docker-nätverk så att de kan kommunicera via stabila tjänstenamn i stället för änderliga container-IP-adresser.

Lagra databasens data i en egen beständig CasaOS-AppData-katalog och säkerhetskopiera den separat från FXServer-filerna.

Testa i det lokala nätverket innan du öppnar servern mot internet

Börja med ett lokalt test:

Bekräfta att FiveM-containern fortsätter att köras.
Öppna txAdmin på http://CASAOS_IP:40120 om avbilden använder standardporten.
Slutför txAdmin-konfigurationen.
Bekräfta 30120/TCP och 30120/UDP är mappade.
Anslut från en annan enhet i det lokala nätverket.
Konfigurera router-/brandväggsregler först efter lokala tester, om spelare på internet behöver åtkomst.

Internetdrift medför säkerhetsansvar

En offentlig spelserver tar emot oönskad internettrafik. Håll själva CasaOS, SSH, Docker-API:t och databasportarna privata. Exponera endast de portar som krävs av FXServer/txAdmin och överväg att begränsa åtkomsten till txAdmin i stället för att lämna administrationsgränssnittet brett öppet.

Exponera inte MariaDB/MySQL direkt mot internet bara för att FiveM behöver en databas.

Checklista för FiveM-server på CasaOS

Bekräfta att värden har tillräckligt med CPU, RAM och lagringsutrymme.
Skapa en Cfx.re-serverlicensnyckel.
Välj en underhållen FiveM-/FXServer-Docker-avbild eller bygg avbilden själv från aktuella artefakter.
Lagra konfigurationen och txData utanför containern.
Exponera 30120/TCP och 30120/UDP.
Exponera endast txAdmin vid behov.
Testa lokalt innan du konfigurerar offentliga brandväggs-/NAT-regler.
Säkerhetskopiera txData, resurser, server.cfg och alla externa databaser.
Räkna med kompatibilitetsskillnader mellan Linux/Docker och Windows FXServer.

Vanliga frågor om FiveM på CasaOS

Kan FiveM köras på CasaOS?

Ja. Källtråden innehöll en fungerande Docker-arkitektur för en anpassad CasaOS-app. Själva containeravbilden kom från tredje part och var inte ett officiellt CasaOS-paket.

Är spritsail/fivem en officiell Cfx.re-avbild?

Nej. Det är en Docker-avbild från tredje part som communityn hänvisar till. Kontrollera dess aktuella underhållsstatus innan du använder den.

Vilka portar bör jag mappa?

Den använda källkonfigurationen 30120/TCP, 30120/UDP, och 40120/TCP för txAdmin.

Har Linux/Docker lika bra stöd som Windows?

Inte exakt. Den aktuella Cfx.re-dokumentationen beskriver uttryckligen Linux-FXServer som en inofficiell port och säger att Windows sannolikt får kompatibilitetsåtgärder först.