Tak, serwer FiveM może działać na hoście CasaOS za pośrednictwem Dockera. Taki wniosek wyciągnięto w wątku społeczności IceWhale z września 2023 roku: stary komputer gamingowy użytkownika miał już wystarczające zasoby do obsługi zadań CasaOS, a członkowie społeczności wskazali, że FXServer FiveM ma wersje dla systemu Linux i może być uruchamiany w kontenerze jako niestandardowa aplikacja CasaOS.
Historyczny wątek wykorzystywał zewnętrzny spritsail/fivem obraz i udostępniała zarówno port gry FiveM, jak i txAdmin. Nadal jest to użyteczny punkt wyjścia architektonicznego, ale nie należy mylić go z oficjalnym pakietem CasaOS firmy Cfx.re. Aktualna dokumentacja Cfx.re nadal obsługuje FXServer w systemie Linux, jednocześnie wyraźnie ostrzegając, że serwer linuksowy jest wersją udostępnianą w ramach uprzejmości, a system Windows zazwyczaj zapewnia lepszą zgodność i pomoc diagnostyczną. W 2026 roku nadal pojawiały się również problemy z FiveM specyficzne dla systemu Linux i Dockera, dlatego przetestuj dokładnie artefakt serwera i wersję gry, których planujesz użyć.
Co potwierdził oryginalny wątek CasaOS
Wpis źródłowy dotyczył pytania, czy prywatny serwer FiveM można uruchomić na starym komputerze gamingowym, który już pełnił funkcję serwera CasaOS. Dwie odpowiedzi zawierały przydatne informacje:
- FiveM/FXServer może działać w systemie Linux i w Dockerze.
- Niestandardowa aplikacja CasaOS może udostępniać wymagane porty oraz utrwalać konfigurację i dane.
- Serwer nadal potrzebuje prawidłowego klucza licencyjnego Cfx.re.
- Sprzęt musi być wystarczająco wydajny dla danej liczby graczy, zasobów, skryptów i obciążenia bazy danych.
Punkt wyjściowy społecznościowego pliku Docker Compose
Odpowiedź z 2023 roku proponowała definicję niestandardowej aplikacji CasaOS opartą na zewnętrznym spritsail/fivem image:
services:
fivem:
image: spritsail/fivem
restart: on-failure
environment:
LICENSE_KEY: TWÓJ_KLUCZ_LICENCYJNY
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: trueJest to historyczna konfiguracja oparta na źródłowym wpisie, a nie definicja aplikacji utrzymywana przez IceWhale. Przed zaimportowaniem jej do działającego systemu CasaOS zapoznaj się z aktualną dokumentacją obrazu.
Których portów potrzebuje FiveM?
Konfiguracja społeczności udostępniała:
-
30120/TCP— główny ruch gry FXServer. -
30120/UDP— główny ruch UDP FXServer. -
40120/TCP— interfejs internetowy txAdmin w konfiguracji źródłowej.
Aktualna dokumentacja txAdmin firmy Cfx.re nadal wskazuje port 40120 jako domyślny port HTTP txAdmin. Zobacz aktualną dokumentację txAdmin.
Utwórz klucz licencyjny Cfx.re
Najnowsza dokumentacja konfiguracji serwera Cfx.re wymaga klucza licencyjnego serwera przed uruchomieniem FXServer. Zarejestruj serwer za pomocą aktualnego procesu Cfx.re/Cfx Portal i zachowaj klucz w tajemnicy.
Oficjalny materiał referencyjny: Konfiguracja serwera.
Nie umieszczaj klucza w publicznym repozytorium Git ani nie wklejaj go do zrzutów ekranu. Zmienne środowiskowe CasaOS są wygodne, ale każda osoba z uprawnieniami administratora do konfiguracji Dockera może mieć możliwość ich odczytania.
Zachowaj konfigurację oraz dane txAdmin
Oryginalny plik Compose montował:
/DATA/AppData/fivem/config → /config
/DATA/AppData/fivem/data → /txDataZasada jest ważniejsza niż dokładne ścieżki: konfiguracja serwera i profile txAdmin powinny znajdować się na trwałej pamięci hosta, aby odtworzenie kontenera nie usunęło stanu serwera.
Przed zmianą obrazów kontenerów lub artefaktów serwera wykonaj kopię zapasową tych katalogów.
Najnowsza dokumentacja FiveM nadal traktuje Linuksa jako drugorzędny port serwera
Obecna dokumentacja konfiguracji vanilla Cfx.re zawiera ważne ostrzeżenie dotyczące systemu Linux: wersja FXServer dla Linuksa jest udostępniana jako port pomocniczy, ponieważ zgodność dystrybucji Linuksa i natywne narzędzia diagnostyczne mogą być trudniejsze w obsłudze. Dokumentacja wskazuje, że problemy częściej otrzymują poprawki w systemie Windows.
Nie oznacza to, że serwery Linux są bezużyteczne. Oznacza to, że wdrożenie Dockera w CasaOS ma dodatkową warstwę zgodności w porównaniu ze standardowym, oficjalnie wspieranym serwerem Windows.
Problemy FiveM specyficzne dla Dockera nadal występują w 2026 roku
Najnowsze zgłoszenia problemów CitizenFX pokazują, że serwer Linux FXServer może działać poprawnie w Dockerze, podczas gdy określone wymuszone wersje gry lub artefakty Enhanced nadal powodują awarie charakterystyczne dla kontenerów. Na przykład w zgłoszeniu z 2026 roku odtworzono awarię klienta przy użyciu sv_enforceGameBuild 3751 w systemie Linux/Docker, podczas gdy ten sam kontener vanilla działał bez tego ustawienia.
Dlatego poprawne uruchomienie kontenera i dostępna strona txAdmin nie gwarantują stabilności każdej kombinacji artefaktów FiveM i zasobów.
Ile sprzętu potrzebujesz?
Oryginalna odpowiedź z 2023 roku cytowała nieaktualne minimalne wymagania sprzętowe FiveM dla komputerów stacjonarnych. Te wartości nie stanowią wiarygodnego wzoru do określania wymagań współczesnego serwera. Zapotrzebowanie na zasoby serwera dedykowanego zależy w dużej mierze od:
- liczba graczy;
- liczba frameworków i zasobów;
- jakość skryptów Lua/JavaScript/C#;
- obciążenie bazy danych;
- konfiguracja OneSync;
- dodatkowych usług, takich jak MariaDB/MySQL.
W przypadku małego prywatnego serwera wystarczający może być stary komputer do gier, ale ważniejsza od zwykłego spełnienia historycznych wymagań minimalnych jest wydajność pojedynczego wątku procesora oraz zapas pamięci RAM.
Frameworki FiveM mogą wymagać osobnej bazy danych
Jeśli zainstalujesz ESX, QBCore lub inny framework, kontener FiveM może wymagać dostępu do kontenera MariaDB/MySQL. Umieść obie usługi w zdefiniowanej przez użytkownika sieci Dockera, aby mogły komunikować się za pomocą stabilnej nazwy usługi zamiast zmieniających się adresów IP kontenerów.
Przechowuj dane bazy danych w osobnym, trwałym katalogu CasaOS AppData i twórz dla nich niezależne kopie zapasowe, oddzielnie od plików FXServer.
Przetestuj działanie w sieci LAN przed udostępnieniem serwera w internecie
Rozpocznij od testu lokalnego:
- Potwierdź, że kontener FiveM nadal działa.
- Otwórz txAdmin pod adresem
http://CASAOS_IP:40120jeśli obraz używa portu domyślnego. - Dokończ konfigurację txAdmin.
- Potwierdź
30120/TCPoraz30120/UDPsą zmapowane. - Połącz się z innego urządzenia w sieci LAN.
- Dopiero po testach lokalnych skonfiguruj reguły routera/zapory, jeśli gracze z internetu mają uzyskać dostęp.
Hosting w internecie wiąże się z dodatkowymi obowiązkami w zakresie bezpieczeństwa
Publiczny serwer gier otrzymuje niezamówiony ruch z internetu. Samo CasaOS, SSH, interfejs API Dockera oraz porty bazy danych powinny pozostać prywatne. Udostępniaj tylko porty wymagane przez FXServer/txAdmin i rozważ ograniczenie dostępu do txAdmin zamiast pozostawiania jego interfejsu zarządzania szeroko otwartego.
Nie udostępniaj MariaDB/MySQL bezpośrednio w internecie tylko dlatego, że FiveM potrzebuje bazy danych.
Lista kontrolna serwera FiveM w CasaOS
- Upewnij się, że host ma wystarczającą moc procesora, pamięć RAM i przestrzeń dyskową.
- Utwórz klucz licencyjny serwera Cfx.re.
- Wybierz utrzymywany obraz Dockera FiveM/FXServer albo samodzielnie zbuduj obraz na podstawie aktualnych artefaktów.
- Przechowuj konfigurację i txData poza kontenerem.
- Udostępnij
30120/TCPoraz30120/UDP. - Udostępniaj txAdmin tylko w razie potrzeby.
- Przed skonfigurowaniem publicznych reguł zapory/NAT przetestuj wszystko lokalnie.
- Utwórz kopię zapasową txData, zasobów, server.cfg oraz wszelkich zewnętrznych baz danych.
- Należy spodziewać się różnic w zgodności systemów Linux/Docker względem FXServer dla systemu Windows.
Często zadawane pytania dotyczące FiveM na CasaOS
Czy FiveM może działać na CasaOS?
Tak. Wątek źródłowy zawierał działającą architekturę Dockera dla niestandardowej aplikacji CasaOS. Sam obraz kontenera pochodził od innej firmy, a nie z oficjalnego pakietu CasaOS.
Czy spritsail/fivem to oficjalny obraz Cfx.re?
Nie. To obraz Dockera innej firmy, na który powołuje się społeczność. Przed użyciem sprawdź jego aktualny stan utrzymania.
Które porty należy mapować?
Użyta konfiguracja źródłowa 30120/TCP, 30120/UDPoraz 40120/TCP dla txAdmin.
Czy Linux/Docker jest obsługiwany równie dobrze jak Windows?
Niezupełnie. Aktualna dokumentacja Cfx.re wyraźnie opisuje FXServer dla systemu Linux jako port udostępniony w ramach uprzejmości i wskazuje, że poprawki problemów ze zgodnością będą prawdopodobnie częściej trafiać do wersji dla systemu Windows.
