ローカルキャッシュサーバーを追加する

Last updated on February 4, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要

AccelByte Development Toolkit（ADT）ローカルキャッシュサーバーを使用すると、スタジオはADT Hubにダウンロードキャッシュを追加でき、開発ビルド配信中のダウンロードニーズを大幅に削減できます。これは、ビルドの初期ダウンロードをインテリジェントにキャッシュし、S3からの同じビルドのさらなるダウンロードをインターセプトして、代わりにローカルキャッシュから提供することで実現します。

前提条件

ハードウェア仕様

ADT Hubローカルキャッシュサーバーセットアップの最小要件：

• メモリ：4 GB

• CPU：2コア

• キャッシュストレージ用の高速SSD（NVMe M.2）

• 高速イーサネットネットワーク

ソフトウェア仕様

ADT Hubローカルキャッシュサーバーをセットアップする前に、次の手順に従ってください。

1. Ubuntu/Ubuntu Server >= 20.04をインストールします。これは他のOSバージョンではまだテストされていないことに注意してください。

2. Docker >= v20.10（APIバージョン1.41）をインストールします。

3. Local Cache Installerをインストールします。Local CacheはAccelByteにリクエストできるアドオンです。

• オプション。キャッシュターゲット用のディレクトリを準備します。これはフォルダまたはマウントされたディスクドライブ（例：/mnt/volume1/cache）にすることができます。

• オプション。キャッシュターゲットの権限を755に設定します。

4. ファイアウォールを設定して、マシンが特定のポート（例：8080）をリッスンできるようにします

ローカルキャッシュサーバーをインストールする

ローカルキャッシュサーバーをインストールする方法は2つあります：インタラクティブモードとコマンドラインモードです。以下で説明します。

インタラクティブモードでローカルキャッシュサーバーをインストールする

ローカルキャッシュサーバーをインストールするには、次の手順に従います：

1. 次のコマンドを実行します：

   ./local-cache-setup install -i

2. 要求された情報を入力します。

   • Cache Retention：キャッシュを保持する期間（デフォルト：12h）

   • Port：提供するローカルキャッシュサーバーポート（デフォルト：80）

   • Number of workers：提供するワーカーの数（デフォルト：8、通常はCPUコア数と同じ）

   • Cache Mount：キャッシュディレクトリの場所（デフォルト：none）（オプションフィールド）

   • Namespace：ゲームのネームスペース。

   • GameIDs：（オプションフィールド）

     Cache Retention(12h) :
     Port(80) :
     Number of worker(8) :
     Cache Mount() : <CACHE_DIRECTORY> (optional)
     Namespace() : <YOUR_NAMESPACE> (required)
     GameIDs() : <PRIORITY_GAME_ID> (optional)

     インストールが完了します。

     2021/12/21 15:23:04 prepare docker...
     2021/12/21 15:23:04 writing config file...
     2021/12/21 15:23:04 copy executable....
     2021/12/21 15:23:04 installing service...
     2021/12/21 15:23:04 blackbox local cache installed

コマンドラインモードでローカルキャッシュサーバーをインストールする

コマンドラインモードでローカルキャッシュサーバーをインストールするには、コマンドラインで次のフィールドとその値を入力します：

• -i, --install-dir：ターゲットインストールディレクトリ、デフォルト

  • -p, --port：提供されるローカルキャッシュサーバーポート

  • -w, --worker ローカルキャッシュサーバーワーカー

  • -r, --retention ローカルキャッシュサーバー保持

  • -c, --cache-mount ローカルキャッシュマウントディレクトリ

    例：

    #!/bin/sh
    
    ./ABYLocalCacheServerSetup install --port 8080 --worker 8 --retention 12h --cache-mount /home/cache

自動保持の設定可能な時間間隔

自動保持の時間間隔は、ミリ秒（ms）、秒（s）、分（m）、時間（h）、日（d）など、さまざまな単位で定義できます。これらの単位は次のサフィックスで示されます：

サフィックス	時間単位
ms	ミリ秒
s	秒
m	分
h	時間
d	日
w	週
M	月、30日
y	年、365日

単一の単位を超える時間間隔を定義する場合、単位（ミリ秒、秒、分、時間、日）の組み合わせが許可されます。これらの単位は、重要度の降順でリストし、スペースで区切る必要があります。たとえば、「1h 30m」は「90m」または「5400s」と同じ期間を示します。システムは単位なしの値を秒として解釈できますが、明確性を高めるために常に単位を明示的に指定することをお勧めします。

ローカルキャッシュサーバーを起動する

ローカルキャッシュサーバーは、インストールプロセスが成功した後、自動的に起動します。

ローカルキャッシュサーバーのステータスを確認する

ローカルキャッシュサーバーのステータスを確認するには、次の手順に従います：

1. 次を実行します：

   ./local-cache-setup status

2. サービスが実行されていることを確認します（実行されていない場合は、インストール手順を再度確認してください）

   2021/12/23 10:50:49 service is running.
   /docker-entrypoint.sh: /docker-entrypoint.d/ is not empty, will attempt to perform configuration
   /docker-entrypoint.sh: Looking for shell scripts in /docker-entrypoint.d/
   /docker-entrypoint.sh: Launching /docker-entrypoint.d/10-listen-on-ipv6-by-default.sh
   10-listen-on-ipv6-by-default.sh: info: Getting the checksum of /etc/nginx/conf.d/default.conf
   10-listen-on-ipv6-by-default.sh: info: Enabled listen on IPv6 in /etc/nginx/conf.d/default.conf
   /docker-entrypoint.sh: Launching /docker-entrypoint.d/20-envsubst-on-templates.sh
   20-envsubst-on-templates.sh: Running envsubst on /etc/nginx/templates/nginx.conf.template to /etc/nginx/nginx.conf
   /docker-entrypoint.sh: Launching /docker-entrypoint.d/30-tune-worker-processes.sh
   /docker-entrypoint.sh: Configuration complete; ready for start up

ローカルキャッシュサーバーが実行されているか確認する

ローカルキャッシュサーバーが実行されているかどうかを確認するには：

1. ADT Webにログインします。

2. ディスプレイの右上隅にあるSettingsアイコンをクリックします。

3. proxy-cacheテキストフィールドにCache Server IPアドレスを入力します。

4. Verifyボタンをクリックします。 IPアドレスが見つかると、緑色のVerifiedメッセージが表示されます。

5. Save Changesボタンをクリックします。

トラブルシューティング

キャッシュが機能しない - 同じバイナリを同じインターネット速度で2回ダウンロードしようとしました

1. ローカルキャッシュサーバーを確認して、ユーザーsystemd-journalがファイルの名前を変更できることを確認します。

2. ローカルキャッシュサーバーフォルダに777権限を与えてみてください。

3. ローカルキャッシュサーバーフォルダの所有者をroot以外のものに変更します。

ローカルキャッシュサーバーに接続できません

ファイアウォールを確認し、インストールプロセス中に指定したポートへのアクセスがあることを確認してください。

ダウンロード速度がまだ遅い

ダウンロード速度に影響を与える可能性のある要因はいくつかあります：

1. キャッシュストレージ用のサーバーに高速SSDがあることを確認してください。

2. コンピュータとローカルキャッシュサーバー間の接続がギガビットイーサネット（1 Gbps）を使用していることを確認してください。

3. ローカルキャッシュサーバーのメモリを増やしてみてください。