Sì, un server FiveM può essere eseguito su un host CasaOS tramite Docker. Questa è stata la risposta raggiunta nel thread della community IceWhale del settembre 2023: il vecchio PC da gioco dell'utente disponeva già di risorse sufficienti per i carichi di lavoro di CasaOS e i membri della community hanno segnalato che FXServer di FiveM dispone di build per Linux e può essere containerizzato come applicazione CasaOS personalizzata.
Il thread storico utilizzava l'immagine di terze parti spritsail/fivem immagine ed esponeva sia la porta di gioco di FiveM sia txAdmin. Resta un'architettura di partenza utile, ma non va confusa con un pacchetto CasaOS ufficiale di Cfx.re. La documentazione attuale di Cfx.re supporta ancora FXServer su Linux, avvertendo però esplicitamente che il server Linux è un porting fornito a titolo di cortesia e che Windows offre generalmente una compatibilità e un supporto diagnostico migliori. Nel 2026 sono continuati a comparire problemi specifici di FiveM su Linux/Docker, quindi testa esattamente l'artefatto del server e la build del gioco che intendi usare.
Cosa ha confermato il thread originale su CasaOS
Il post originale chiedeva se fosse possibile eseguire un server FiveM privato su un vecchio PC da gioco già utilizzato come server CasaOS. Due risposte fornivano l'informazione utile:
- FiveM/FXServer può essere eseguito su Linux e in Docker.
- Un'applicazione CasaOS personalizzata può esporre le porte necessarie e rendere persistenti configurazione e dati.
- Il server necessita comunque di una chiave di licenza Cfx.re valida.
- L'hardware deve essere adeguato al numero di giocatori, alle risorse, agli script e al carico del database.
Il punto di partenza con Docker Compose della community
La risposta del 2023 proponeva una definizione di app personalizzata per CasaOS basata sull'immagine di terze parti spritsail/fivem immagine:
servizi:
fivem:
immagine: spritsail/fivem
riavvio: in caso di errore
ambiente:
LICENSE_KEY: YOUR_LICENSE_KEY
NO_DEFAULT_CONFIG: 1
porte:
- "40120:40120"
- "30120:30120"
- "30120:30120/udp"
volumi:
- /DATA/AppData/fivem/config:/config
- /DATA/AppData/fivem/data:/txData
stdin_open: true
tty: trueSi tratta di una configurazione storica ricavata dalla fonte, non di una definizione dell'app gestita da IceWhale. Consulta la documentazione attuale dell'immagine prima di importarla in un sistema CasaOS attivo.
Quali porte sono necessarie per FiveM?
La configurazione della community esponeva:
-
30120/TCP— traffico di gioco principale di FXServer. -
30120/UDP— traffico UDP principale di FXServer. -
40120/TCP— interfaccia web di txAdmin nella configurazione di esempio.
La documentazione attuale di Cfx.re per txAdmin indica ancora la porta 40120 come porta HTTP predefinita di txAdmin. Consulta la documentazione di txAdmin aggiornata.
Crea una chiave di licenza Cfx.re
L'attuale documentazione di configurazione dei server Cfx.re richiede una chiave di licenza del server prima di avviare FXServer. Registra il server tramite l'attuale procedura di Cfx.re/Cfx Portal e conserva la chiave in privato.
Riferimento ufficiale: Configurazione di un server.
Non eseguire il commit della chiave in un repository Git pubblico né incollarla negli screenshot. Le variabili d'ambiente di CasaOS sono comode, ma chiunque abbia accesso amministrativo alla configurazione Docker potrebbe riuscire a leggerle.
Rendi persistenti la configurazione e i dati di txAdmin
Il Compose originale montava:
/DATA/AppData/fivem/config → /config
/DATA/AppData/fivem/data → /txDataIl principio è più importante di quei percorsi esatti: la configurazione del server e i profili txAdmin devono risiedere su uno spazio di archiviazione persistente dell'host, così la ricreazione del container non cancellerà lo stato del server.
Prima di modificare le immagini dei container o gli artifact del server, esegui il backup di quelle directory.
L'attuale documentazione di FiveM tratta ancora Linux come un porting server secondario
L'attuale documentazione ufficiale di configurazione vanilla di Cfx.re contiene un'importante avvertenza su Linux: la versione Linux di FXServer viene fornita come porting non ufficiale, poiché la compatibilità con le distribuzioni Linux e gli strumenti diagnostici nativi può essere più difficile. Specifica che è più probabile che i problemi ricevano correzioni su Windows.
Questo non significa che i server Linux siano inutilizzabili. Significa che una distribuzione Docker su CasaOS ha un ulteriore livello di compatibilità rispetto a un normale server Windows supportato.
I problemi specifici di FiveM con Docker esistono ancora nel 2026
Recenti segnalazioni di problemi di CitizenFX mostrano che un FXServer Linux può funzionare correttamente all'interno di Docker, mentre specifiche versioni di gioco forzate o artifact Enhanced possono comunque causare problemi specifici del container. Ad esempio, un problema del 2026 ha riprodotto un arresto anomalo del client con sv_enforceGameBuild 3751 su Linux/Docker, mentre lo stesso container vanilla funzionava senza quell'impostazione.
Per questo, l'avvio corretto di un container e una pagina txAdmin raggiungibile non garantiscono che ogni combinazione di artifact e risorse FiveM sia stabile.
Di quanto hardware hai bisogno?
La risposta originale del 2023 citava i vecchi requisiti minimi desktop di FiveM. Quei valori non costituiscono una formula affidabile e aggiornata per dimensionare un server. Le esigenze di un server dedicato dipendono fortemente da:
- numero di giocatori;
- numero di framework e risorse;
- qualità degli script Lua/JavaScript/C#;
- carico di lavoro del database;
- Configurazione di OneSync;
- servizi aggiuntivi come MariaDB/MySQL.
Per un piccolo server privato, un vecchio PC da gioco può essere sufficiente, ma le prestazioni single-thread della CPU e il margine di RAM sono più importanti del semplice rispetto di un vecchio elenco di requisiti minimi.
I framework FiveM potrebbero richiedere un database separato
Se installi ESX, QBCore o un altro framework, il container FiveM potrebbe dover raggiungere un container MariaDB/MySQL. Inserisci entrambi i servizi in una rete Docker definita dall'utente, così potranno comunicare tramite un nome di servizio stabile anziché tramite indirizzi IP dei container soggetti a variazioni.
Conserva i dati del database nella sua directory AppData persistente dedicata di CasaOS ed esegui il backup separatamente dai file di FXServer.
Esegui i test sulla LAN prima di rendere il server accessibile da Internet
Inizia con un test locale:
- Verifica che il container FiveM rimanga in esecuzione.
- Apri txAdmin all'indirizzo
http://CASAOS_IP:40120se l'immagine utilizza la porta predefinita. - Completa la configurazione di txAdmin.
- Conferma
30120/TCPEsp30120/UDPsono mappate. - Connettiti da un altro dispositivo sulla LAN.
- Solo dopo i test locali, configura le regole del router/firewall se i giocatori devono accedere da Internet.
L'hosting su Internet comporta ulteriori responsabilità in materia di sicurezza
Un server di gioco pubblico riceve traffico Internet non richiesto. Mantieni privati CasaOS, SSH, l'API Docker e le porte del database. Esponi solo le porte richieste da FXServer/txAdmin e valuta la possibilità di limitare l'accesso a txAdmin invece di lasciare la sua interfaccia di gestione ampiamente esposta.
Non esporre direttamente MariaDB/MySQL a Internet solo perché FiveM necessita di un database.
Checklist del server FiveM su CasaOS
- Verifica che l'host disponga di CPU, RAM e spazio di archiviazione sufficienti.
- Crea una chiave di licenza per il server Cfx.re.
- Scegli un'immagine Docker FiveM/FXServer mantenuta attivamente oppure crea autonomamente l'immagine dagli artefatti attuali.
- Mantieni la configurazione e txData al di fuori del container.
- Esp
30120/TCPEsp30120/UDP. - Esp
- Esegui i test localmente prima di configurare le regole del firewall/NAT pubblico.
- Esegui il backup di txData, delle risorse, di server.cfg e di qualsiasi database esterno.
- Prevedi differenze di compatibilità tra Linux/Docker e FXServer per Windows.
Domande frequenti su FiveM su CasaOS
FiveM può funzionare su CasaOS?
Sì. La discussione originale forniva un'architettura Docker funzionante per un'app CasaOS personalizzata. L'immagine del container era di terze parti, non un pacchetto ufficiale di CasaOS.
spritsail/fivem è un'immagine ufficiale di Cfx.re?
No. È un'immagine Docker di terze parti citata dalla community. Prima di usarla, verifica il suo attuale stato di manutenzione.
Quali porte devo mappare?
La configurazione di origine utilizzata 30120/TCP, 30120/UDPe 40120/TCP per txAdmin.
Linux/Docker è supportato tanto quanto Windows?
Non esattamente. La documentazione attuale di Cfx.re descrive esplicitamente FXServer per Linux come un porting offerto come cortesia e indica che è più probabile che Windows riceva correzioni per i problemi di compatibilità.
