CasaOSでFiveMサーバーを実行する：Dockerセットアップガイド

はい、FiveMサーバーはDockerを介してCasaOSホスト上で実行できます。これは2023年9月のIceWhale Communityスレッドで示された回答です。ユーザーの古いゲーミングPCにはすでにCasaOSのワークロードに十分なリソースがあり、コミュニティメンバーはFiveMのFXServerにLinuxビルドがあり、カスタムCasaOSアプリとしてコンテナ化できると指摘しました。

過去のスレッドでは、サードパーティ製のものを使用していました spritsail/fivem イメージを使用し、FiveMのゲームポートとtxAdminの両方を公開していました。これは現在でも有用な基本構成ですが、公式のCfx.re CasaOSパッケージと混同しないでください。現在のCfx.reドキュメントではLinux FXServerが引き続きサポートされていますが、Linuxサーバーは便宜的に提供されている移植版であり、通常はWindowsのほうが互換性と診断サポートに優れていると明記されています。2026年現在も、Linux/Docker固有のFiveM問題が引き続き報告されているため、使用予定の正確なサーバーアーティファクトとゲームビルドでテストしてください。

元のCasaOSスレッドで確認された内容

元の投稿では、すでにCasaOSサーバーとして稼働している古いゲーミングPCで、プライベートなFiveMサーバーを実行できるか尋ねていました。2件の返信から、次の有用な回答が得られました。

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ドキュメントでは、txAdminのデフォルトHTTPポートとしてポート40120が引き続き記載されています。最新の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版FXServerは、Linuxディストリビューションとの互換性やネイティブの診断ツールが難しい場合があるため、善意で提供されている移植版です。また、問題はWindowsのほうが修正される可能性が高いと説明されています。

これは、Linuxサーバーが使えないという意味ではありません。CasaOSのDockerデプロイメントには、通常のサポート対象Windowsサーバーと比べて、追加の互換性レイヤーがあるという意味です。

Docker固有のFiveM問題は2026年になっても存在します

最近のCitizenFXの問題報告では、LinuxのFXServerがDocker内で正常に動作する一方、特定の強制ゲームビルドやEnhancedアーティファクトによって、コンテナ固有の障害が引き続き発生することが示されています。たとえば、2026年のある問題では、クライアントクラッシュが次の設定で再現されました。 sv_enforceGameBuild 3751 Linux/Docker上では、同じバニラコンテナがその設定なしで動作しました。

そのため、コンテナが正常に起動し、txAdminページにアクセスできたとしても、すべてのFiveMアーティファクトとリソースの組み合わせが安定するとは限りません。

どれだけのハードウェアが必要ですか？

元の2023年の回答では、古いFiveMのデスクトップ最低要件が引用されていました。これらの数値は、現代のサーバー規模を決める信頼できる計算式ではありません。専用サーバーの負荷は、次の要素に大きく左右されます。

プレイヤー数。
フレームワークとリソースの数。
Lua/JavaScript/C#スクリプトの品質。
データベースのワークロード。
OneSyncの設定。
MariaDB/MySQLなどの追加サービス。

小規模なプライベートサーバーなら古いゲーミングPCでも十分な場合がありますが、過去の最低要件リストに合わせることよりも、CPUのシングルスレッド性能とRAMの余裕が重要です。

FiveMフレームワークでは別のデータベースが必要になる場合があります

ESX、QBCore、その他のフレームワークをインストールする場合、FiveMコンテナからMariaDB/MySQLコンテナへの接続が必要になることがあります。両方のサービスをユーザー定義Dockerネットワークに配置し、変化するコンテナIPアドレスではなく、安定したサービス名で通信できるようにしてください。

データベースのデータは専用の永続化されたCasaOS AppDataディレクトリに保存し、FXServerファイルとは別にバックアップしてください。

インターネットにサーバーを公開する前にLANでテストする

まずローカルテストから始めます。

FiveMコンテナが実行中のままであることを確認してください。
でtxAdminを開きます http://CASAOS_IP:40120 イメージがデフォルトポートを使用している場合。
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に関するよくある質問

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版のほうが提供される可能性が高いとされています。