Posted inホームラボ

スクリプト管理はもう卒業：プロ仕様のゲームホスティングを実現するPterodactyl PanelをUbuntuにインストールする方法

HomeLab tutorial - IT technology blog
HomeLab tutorial - IT technology blog

手動によるゲームサーバー管理の混乱

友人のためにMinecraftサーバーを1つ立てるだけであれば、最初は簡単です。JARファイルをダウンロードし、簡単なbashスクリプトを書き、screenセッションで実行するだけです。しかし、HomeLabが成長するにつれ、その綻びは大きな溝へと変わります。ある日Valheimサーバーを追加し、次にPalworldのインスタンスを立てると、気づけば15個の開放ポートと3つの異なるJavaバージョンを使い分ける羽目になります。ダッシュボードがなければ、どのプロセスが32GBのRAMを食いつぶしているのかを簡単に把握する術もありません。

多くのホビーユーザーがこの壁に突き当たるのを見てきました。結局、サーバーは中身のわからない「ブラックボックス」と化してしまいます。金曜日の夜10時にクラッシュした際、Discordで友人たちが不満を漏らす中、あなたは外出先からスマホでSSH越しにログを漁る羽目になります。この手動のアプローチにはリソースの隔離がありません。バグのあるプラグイン1つがメモリリークを引き起こせば、LinuxのOOM killerがホストOS自体を守るためにOS全体をシャットダウンさせてしまうことさえあります。

従来のスクリプトが大規模運用で失敗する理由

真の問題は、オーケストレーションの欠如にあります。ゲームサーバーをホストOS上で直接実行すると、主に3つのボトルネックに直面します：

  • 依存関係の競合： 最新のMinecraftにはJava 17や21が必要ですが、古い1.12.2のModパックはJava 8を要求します。これらをグローバルにインストールすることは、設定の悪夢を招きます。
  • リソースの独占： 厳格なcgroupの制限がなければ、1つのゲームプロセスがCPUサイクルを100%消費する可能性があります。これにより、DNSやPlexなど、他のHomeLabサービスに必要なリソースが枯渇してしまいます。
  • セキュリティの脆弱性： ゲームのバイナリを標準ユーザー（あるいは最悪の場合root）として実行すると、ファイルシステム全体が危険にさらされます。Arkのようなゲームにリモートコード実行の脆弱性が見つかった場合、ネットワーク全体がリスクにさらされることになります。

ソリューションの比較検討

現在のスタックに落ち着く前に、いくつかの管理プラットフォームをテストしました。一般的なHomeLab環境における比較は以下の通りです：

  • LGSM (Linux Game Server Managers): 素晴らしいコマンドラインツールです。しかし、中央管理用のWeb UIがなく、真の意味でのコンテナレベルの隔離は提供されません。
  • AMP (CubeCoders): 洗練された有料製品です。10〜20ドルのライセンス料は妥当ですが、クローズドソースのソフトウェアです。多くの愛好家は、ローカルハードウェアで動かすものにはオープンソースの透明性を好みます。
  • Pterodactyl Panel: 業界標準となっているのには理由があります。無料でオープンソース、そしてDockerを使用してすべてのゲームをサンドボックス化します。Goベースの高性能エージェントである「Wings」を利用し、プロフェッショナルな精度でコンテナを管理します。

本格的にホスティングを行うなら、Pterodactylは明白な選択肢です。商用のホスティング会社が使用しているのと同じソフトウェアです。そのレベルの管理機能を自宅のサーバーに導入できることは、まさにゲームチェンジャーと言えます。

最善のアプローチ：クリーンなUbuntuへのインストール

このセットアップは、数十回のデプロイで安定性が証明されています。インストールは、Panel（Webダッシュボード）とWings（ゲームを実行するエンジン）の2つのパートに分かれます。これらは分離することも可能ですが、ほとんどのHomeLabユーザーはオーバーヘッドを抑えるために1つのUbuntuマシンで両方を実行します。

ステップ1：システムの準備と依存関係

新規のUbuntu 22.04または24.04 LTSのインストールから始めます。安定したPHP環境、MariaDB、Redisが必要です。PterodactylはPHP 8.3で最高のパフォーマンスを発揮します。

# システムパッケージの更新
sudo apt update && sudo apt upgrade -y

# コア依存関係のインストール
sudo apt install -y software-properties-common curl apt-transport-https ca-certificates gnupg

# PHPリポジトリの追加
sudo add-apt-repository ppa:ondrej/php -y

# PHP 8.3と必要なモジュールのインストール
sudo apt install -y php8.3 php8.3-common php8.3-cli php8.3-gd php8.3-mysql php8.3-mbstring php8.3-bcmath php8.3-xml php8.3-fpm php8.3-curl php8.3-zip tar unzip git

ステップ2：データベースとRedisの設定

メタデータはMariaDBに保存され、RedisはUIのレスポンスを高速に保つためのキャッシュを処理します。ここではセキュリティが重要です。ローカルでの権限昇格を防ぐため、「password123」のようなものではなく、独自の強力なパスワードを使用してください。

# MariaDBとRedisのインストール
sudo apt install -y mariadb-server redis-server

# データベースのセキュリティ設定とパネル用ユーザーの作成
sudo mariadb -u root

CREATE DATABASE panel;
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'あなたの安全なパスワード';
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT;

ステップ3：パネルのインストール

パネルのコードは /var/www/pterodactyl に配置します。これはNginxデプロイメントの標準的なディレクトリであり、後の権限管理が非常に容易になります。

mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl

curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
tar -xzvf panel.tar.gz
chmod -R 755 storage/* bootstrap/cache/

次に、環境設定を行います。PHPのパッケージマネージャーであるComposerを使用して、残りのロジックを取り込みます。

cp .env.example .env
composer install --no-dev --optimize-autoloader

# 一意のアプリケーション暗号化キーを生成
php artisan key:generate --force

# セットアップウィザードによるデータベースの紐付け
php artisan p:environment:setup
php artisan p:environment:database

# マイグレーションを実行してテーブル構造を構築
php artisan migrate --seed --force

# メインの管理者アカウントを作成
php artisan p:user:make

ステップ4：Webサーバー（Nginx）の設定

Nginxはユーザーにとっての玄関口として機能します。SSLの終端処理を行い、PHPのリクエストをFPMワーカーに渡します。/etc/nginx/sites-available/pterodactyl.conf に設定ファイルを作成します。server_name はローカルIPまたはドメインに更新してください。

server {
    listen 80;
    server_name あなたのサーバーIP;

    root /var/www/pterodactyl/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param HTTP_PROXY "";
    }
}

設定を有効化し、サービスを再起動します：

sudo ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf
sudo systemctl restart nginx

ステップ5：Wings（エンジン）のインストール

パネルが頭脳なら、Wingsは筋肉です。Dockerと通信してゲームインスタンスを起動し、監視します。まず、公式のDockerエンジンを取得します。

# Dockerランタイムのインストール
curl -sSL https://get.docker.com/ | CHANNEL=stable bash
sudo systemctl enable --now docker

# Wingsバイナリのダウンロードとインストール
sudo mkdir -p /etc/pterodactyl
curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64"
sudo chmod +x /usr/local/bin/wings

Wingsを接続するには、パネルの管理画面に移動して新しい「Node」を作成します。UIが設定ブロックを生成するので、それを /etc/pterodactyl/config.yml に貼り付け、sudo wings でWingsを起動します。

現場で得られた教訓

このセットアップを数ヶ月運用してみて、いくつかの小さな調整が大きな違いを生むことに気づきました。Crontabの設定を忘れると、サーバーのインストールタスクが永遠に「Installing」のままになってしまいます。キューワーカーはシステムの心臓部です。

crontab -e を使用して、この行をcrontabに追加してください：

* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1

もう一つのヒント：サーバー設定では必ずメモリのハードリミットを設定してください。Minecraftサーバーに4GB割り当てるなら、制限を4.5GBに設定します。これにより、プレイヤーが10,000個のTNTを爆発させた際にコンテナが膨れ上がり、他のサービスをクラッシュさせるのを防ぐことができます。

新しいセットアップに関する最後に

手動スクリプトからPterodactylへの移行は、表計算ソフトから専用のERPシステムに移行するような感覚です。Dockerアーキテクチャにより、Minecraft環境がRustのファイルに干渉することはありません。何より、Webインターフェースのおかげで、外出先でもスマホからサーバーを再起動できます。初期設定には30分ほどかかりますが、長期的に節約できるトラブルシューティングの時間を考えれば、その価値は十分にあります。

Share:
Tags: