CasaOS에서 FiveM 서버 실행하기: Docker 설정 가이드

예, Docker를 통해 CasaOS 호스트에서 FiveM 서버를 실행할 수 있습니다. 이는 2023년 9월 IceWhale 커뮤니티 스레드에서 도출된 답변입니다. 사용자의 구형 게이밍 PC에는 이미 CasaOS 워크로드를 처리할 충분한 리소스가 있었고, 커뮤니티 회원들은 FiveM의 FXServer에 Linux 빌드가 있으며 사용자 지정 CasaOS 애플리케이션으로 컨테이너화할 수 있다고 설명했습니다.

과거 스레드에서는 서드파티를 사용했습니다. spritsail/fivem image를 사용해 FiveM 게임 포트와 txAdmin을 모두 노출했습니다. 이는 여전히 유용한 시작 아키텍처이지만, 공식 Cfx.re CasaOS 패키지로 혼동해서는 안 됩니다. 현재 Cfx.re 문서에서도 Linux FXServer를 계속 지원하지만, Linux 서버는 편의상 제공되는 포트이며 일반적으로 Windows에서 호환성과 진단 지원이 더 우수하다고 명시적으로 경고합니다. 2026년에도 Linux/Docker 관련 FiveM 문제가 계속 보고되고 있으므로, 사용하려는 정확한 서버 아티팩트와 게임 빌드를 테스트하세요.

원본 CasaOS 스레드에서 확인된 내용

원본 CasaOS 스레드에서는 CasaOS 서버로도 사용 중인 구형 게이밍 PC에서 비공개 FiveM 서버를 실행할 수 있는지 질문했습니다. 두 답변에서 유용한 내용을 제시했습니다.

FiveM/FXServer는 Linux 및 Docker에서 실행할 수 있습니다.
사용자 지정 CasaOS 애플리케이션에서 필요한 포트를 노출하고 구성 및 데이터를 영구 저장할 수 있습니다.
서버에는 여전히 유효한 Cfx.re 라이선스 키가 필요합니다.
하드웨어는 플레이어 수, 리소스, 스크립트 및 데이터베이스 작업량에 충분해야 합니다.

커뮤니티 Docker Compose 시작점

2023년 답변에서는 서드파티를 기반으로 한 CasaOS 사용자 지정 앱 정의를 제안했습니다. 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

이는 소스에서 파생된 과거 구성으로, IceWhale이 유지 관리하는 앱 정의가 아닙니다. 실제 CasaOS 시스템으로 가져오기 전에 현재 이미지 문서를 검토하세요.

FiveM에 필요한 포트는 무엇인가요?

커뮤니티 구성에 노출된 항목:

30120/TCP 기본 FXServer 게임 트래픽.
30120/UDP 기본 FXServer UDP 트래픽.
40120/TCP 소스 구성의 txAdmin 웹 인터페이스.

현재 Cfx.re txAdmin 문서에는 여전히 40120이 기본 txAdmin HTTP 포트로 표시되어 있습니다. 최신 txAdmin 문서를 참조하세요.

Cfx.re 라이선스 키 생성

현재 Cfx.re 서버 설정 문서에서는 FXServer를 시작하기 전에 서버 라이선스 키가 필요합니다. 현재 Cfx.re/Cfx Portal 절차를 통해 서버를 등록하고 키를 안전하게 비공개로 보관하세요.

공식 참조: 서버 설정.

키를 공개 Git 저장소에 커밋하거나 스크린샷에 붙여 넣지 마세요. CasaOS 환경 변수는 편리하지만 Docker 구성에 대한 관리자 액세스 권한이 있는 사람은 이를 읽을 수 있습니다.

구성 및 txAdmin 데이터 영구 저장

원래 Compose에서는 다음을 마운트했습니다.

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

정확한 경로보다 중요한 원칙은 다음과 같습니다. 컨테이너를 다시 만들더라도 서버 상태가 삭제되지 않도록 서버 구성과 txAdmin 프로필은 영구 호스트 저장소에 있어야 합니다.

컨테이너 이미지나 서버 아티팩트를 변경하기 전에 해당 디렉터리를 백업하세요.

현재 FiveM 문서에서도 Linux를 보조적인 서버 포트로 취급합니다

Cfx.re의 현재 바닐라 설정 문서에는 중요한 Linux 경고가 포함되어 있습니다. Linux 배포판 호환성과 기본 진단 도구 사용이 더 어려울 수 있으므로 Linux 버전의 FXServer는 편의상 제공되는 포트라고 설명합니다. 또한 Windows에서 문제가 해결될 가능성이 더 높다고 명시합니다.

이는 Linux 서버를 사용할 수 없다는 뜻이 아닙니다. 일반적으로 지원되는 Windows 서버와 비교하면 CasaOS Docker 배포에는 추가적인 호환성 계층이 있다는 의미입니다.

2026년에도 Docker 전용 FiveM 문제가 여전히 존재합니다

최근 CitizenFX 이슈 보고에 따르면 Linux FXServer는 Docker 내부에서 정상적으로 실행될 수 있지만, 특정 게임 빌드나 Enhanced 아티팩트를 강제로 사용하면 컨테이너별 오류가 계속 발생할 수 있습니다. 예를 들어 2026년에 보고된 한 이슈에서는 다음 설정으로 클라이언트 충돌이 재현되었습니다. sv_enforceGameBuild 3751 Linux/Docker에서는 동일한 바닐라 컨테이너가 해당 설정 없이 작동했습니다.

따라서 컨테이너가 정상적으로 시작되고 txAdmin 페이지에 접속할 수 있다고 해서 모든 FiveM 아티팩트/리소스 조합이 안정적으로 작동한다는 보장은 없습니다.

어느 정도의 하드웨어가 필요한가요?

2023년 원래 답변은 오래된 FiveM 최소 데스크톱 요구 사항을 인용했습니다. 이러한 값은 최신 서버 사양을 결정하는 신뢰할 만한 공식이 아닙니다. 전용 서버의 요구 사항은 다음 요소에 크게 좌우됩니다.

플레이어 수;
프레임워크 및 리소스 수;
Lua/JavaScript/C# 스크립트 품질;
데이터베이스 워크로드;
OneSync 구성;
MariaDB/MySQL과 같은 추가 서비스.

For a small private server, an old gaming PC can be adequate, but CPU single-thread performance and RAM headroom matter more than simply matching a historical minimum list.

소규모 비공개 서버라면 오래된 게이밍 PC도 충분할 수 있지만, 과거의 최소 사양 목록을 단순히 충족하는 것보다 CPU의 싱글 스레드 성능과 여유 RAM이 더 중요합니다.

FiveM 프레임워크에는 별도의 데이터베이스가 필요할 수 있습니다

ESX, QBCore 또는 다른 프레임워크를 설치하는 경우 FiveM 컨테이너가 MariaDB/MySQL 컨테이너에 연결해야 할 수 있습니다. 두 서비스를 사용자 정의 Docker 네트워크에 배치하면 변경되는 컨테이너 IP 주소가 아니라 안정적인 서비스 이름으로 서로 통신할 수 있습니다.

데이터베이스 데이터는 별도의 영구 CasaOS AppData 디렉터리에 보관하고 FXServer 파일과 별도로 백업하세요.

인터넷에 서버를 공개하기 전에 LAN에서 테스트하세요

로컬 테스트로 시작하세요:
FiveM 컨테이너가 계속 실행 중인지 확인하세요. http://CASAOS_IP:40120 txAdmin을 다음 주소에서 여세요:
이미지가 기본 포트를 사용하는 경우
txAdmin 구성을 완료하세요. 30120/TCP 및 30120/UDP 매핑되어 있는지 확인하세요.
LAN의 다른 기기에서 접속하세요.
로컬 테스트를 완료한 후, 인터넷 플레이어가 접속해야 한다면 라우터/방화벽 규칙을 구성하세요.

인터넷 호스팅에는 추가적인 보안 책임이 따릅니다

공용 게임 서버는 인터넷에서 들어오는 원치 않는 트래픽을 받습니다. CasaOS 자체, SSH, Docker API 및 데이터베이스 포트는 비공개로 유지하세요. FXServer/txAdmin에 필요한 포트만 외부에 노출하고, txAdmin 관리 인터페이스를 광범위하게 공개된 상태로 두기보다는 접근을 제한하는 방안을 고려하세요.

FiveM에 데이터베이스가 필요하다는 이유만으로 MariaDB/MySQL을 인터넷에 직접 노출하지 마세요.

CasaOS FiveM 서버 체크리스트

호스트에 충분한 CPU, RAM 및 저장 공간이 있는지 확인하세요.
Cfx.re 서버 라이선스 키를 생성하세요.
유지 관리되는 FiveM/FXServer Docker 이미지를 선택하거나, 현재 아티팩트로 직접 이미지를 빌드하세요.
구성 파일과 txData를 컨테이너 외부에 영구 저장하세요.
노출 30120/TCP 및 30120/UDP.
필요한 경우에만 txAdmin을 외부에 노출하세요.
공용 방화벽/NAT 규칙을 구성하기 전에 로컬에서 테스트하세요.
txData, 리소스, server.cfg 및 외부 데이터베이스를 백업하세요.
Linux/Docker와 Windows FXServer 간에 호환성 차이가 있을 수 있습니다.

CasaOS FiveM 서버 FAQ

FiveM을 CasaOS에서 실행할 수 있나요?

예. 원본 스레드에서는 맞춤형 CasaOS 앱에 사용할 수 있는 작동하는 Docker 아키텍처를 제공했습니다. 다만 컨테이너 이미지 자체는 공식 CasaOS 패키지가 아니라 타사 이미지였습니다.

spritsail/fivem은 공식 Cfx.re 이미지인가요?

아니요. 커뮤니티에서 참조하는 타사 Docker 이미지입니다. 사용하기 전에 현재 유지 관리 상태를 확인하세요.

어떤 포트를 매핑해야 하나요?

사용된 소스 구성 30120/TCP, 30120/UDP및 40120/TCP txAdmin용입니다.

Linux/Docker도 Windows만큼 지원되나요?

정확히는 아닙니다. 현재 Cfx.re 문서에서는 Linux FXServer를 편의상 제공되는 포트로 명시하며, 호환성 문제에 대한 수정 사항은 Windows에 먼저 제공될 가능성이 높다고 설명합니다.