最終更新日: 2026年1月29日
テンプレート説明
Pterodactyl Panelは、ゲームサーバーを管理するための強力なオープンソースパネルです。PHP、React、Goで構築されており、全てのゲームサーバーを独立したDockerコンテナ内で実行することで、セキュリティと分離性を確保します。Minecraft、Rust、ARK: Survival Evolved、Terrariaなど、多様なゲームサーバーを美しく直感的なWebインターフェースで一元管理できます。
本テンプレートでは、Panel（管理用Webインターフェース）とWings（ゲームサーバー実行エージェント）の両方が自動インストールされます。Panelは起動状態ですぐにアクセス可能ですが、Wingsは初期状態では停止しており、Let’s Encrypt証明書設定後に起動する必要があります。
メモ
Pterodactylは、管理者用のPanel（コントロールパネル）と、実際にゲームサーバーを実行するWings（デーモン）の2つのコンポーネントで構成されます。本テンプレートでは両方が同一サーバーにインストールされ、すぐに利用開始できます。
スタートアップスクリプトのテンプレートを利用してサーバー作成を行う手順はご利用ガイドを参照してください。
仕様
対応OSイメージ
Ubuntu 24.04 LTS
主要ソフトウェア
| ソフトウェア名 | バージョン | ライセンス | 用途 |
|---|---|---|---|
| Pterodactyl Panel | Latest（フォールバック: v1.12.0） | MIT License | ゲームサーバー管理用Webインターフェース |
| Pterodactyl Wings | Latest | MIT License | ゲームサーバー実行エージェント |
| Docker | Latest | Apache 2.0 | コンテナ実行環境 |
| PHP | 8.3 | PHP License | Panel実行環境 |
| MariaDB | Latest | GPL v2 | Panel用データベース |
| Redis | Latest | BSD-3-Clause | キャッシュ・セッション管理 |
| Nginx | Latest | BSD-2-Clause | Webサーバー |
スタートアップスクリプト情報
| 項目 | 説明 |
|---|---|
| Panel利用ポート | 80/tcp (HTTP), 443/tcp (HTTPS) |
| Wings通信ポート | 8080/tcp (API通信) |
| ゲームサーバーポート | 2022/tcp (SFTP), 25565/tcp（Minecraft等、ゲームにより異なる） |
| Panelインストールディレクトリ | /var/www/pterodactyl |
| Wings設定ディレクトリ | /etc/pterodactyl |
| 管理スクリプト | /root/pterodactyl-*.sh |
| Panel初期状態 | サービス起動中（即座にアクセス可能） |
| Wings初期状態 | サービス停止中（SSL証明書設定後に起動） |
その他
最小システム要件
- CPU: 1コア以上（推奨: 2コア以上）
- メモリ: 最小2GB、推奨4GB以上（ゲームサーバー実行には追加メモリが必要）
- ディスク容量: 20GB以上（SSD/NVMe推奨）
- ネットワーク: パブリックIPアドレス
メモ
上記はPanel本体とWingsの動作に必要な要件です。実際にゲームサーバーを運用する場合は、各ゲームの推奨スペックに応じて追加のメモリとディスク容量が必要になります。例えば、Minecraftサーバー1つにつき最低1-2GBのメモリが推奨されます。
利用手順
メモ
スタートアップスクリプトにてアプリケーションのインストールが完了するまで数分かかります。インストール完了後、rootディレクトリに「pterodactyl-info.txt」というファイルが作成されますのでご確認ください。ファイルが存在しない場合、作成されるまでしばらくお待ちください。
重要
Pterodactyl Wingsは、セキュアな通信のためにSSL証明書が必須です。テンプレート作成直後はWingsが停止しているため、まずLet’s Encrypt証明書を設定してからWingsを起動してください。自己署名証明書では正常に動作しません。
Step 0: セキュリティグループについて
ConoHa VPS(Ver.3.0)ではサーバー毎にIPアドレスまたはポートでトラフィックを制御するセキュリティグループ(仮想ファイアウォール)が設定されます。本テンプレートをご利用の場合は、予め利用するポートの通信許可設定が必要です。詳細はセキュリティグループを参照してください。
Step 1: VPSへの接続
ConoHa VPSのコントロールパネルからVPSの情報を確認し、SSH で接続します。
鍵認証でのSSH接続コマンド例
# ssh -i 秘密鍵ファイルのパス root@VPSのグローバルIPアドレス
Step 2: インストール情報の確認
インストールが完了すると、サーバー上に認証情報ファイルが作成されています。以下のコマンドで確認してください。
# cat /root/pterodactyl-info.txt
このファイルには以下の重要情報が含まれています:
- Panel アクセスURL（https://[ドメイン名]）
- 管理者メールアドレス
- 管理者パスワード
- データベース接続情報
Step 3: Let’s Encrypt証明書の設定（必須）
Wingsを起動する前に、Let’s Encrypt証明書を設定します。これはWingsとPanelの通信に必須です。
# /root/pterodactyl-letsencrypt.sh -e [email protected]
パラメータ:
-e, --email: Let’s Encryptからの通知を受け取るメールアドレス（必須）-d, --domain: ドメイン名（省略時は現在のホスト名を使用）
重要
Let’s Encrypt証明書を取得するには、設定するドメイン名がVPSのIPアドレスに正しくDNS解決される必要があります。事前にドメインのAレコードをVPSのIPアドレスに設定してください。Let’s Encrypt証明書は90日ごとに自動更新されます。
Step 4: Panelへのアクセスと初期設定
Webブラウザから以下のURLにアクセスします。
https://[ドメイン名]
Step 2で確認した管理者メールアドレスとパスワードでログインします。初回ログイン後、以下の設定を行います:
- 管理者パスワードの変更: 右上のアイコンから「Account」→「Change Password」でパスワードを変更
- パネル設定の確認: 管理画面右上の歯車アイコンから「Settings」を開き、基本設定を確認
Step 5: Location（ロケーション）の作成
ゲームサーバーを配置する地理的な場所を定義します。管理画面から以下の手順で作成します:
- 管理画面右上の歯車アイコン → 左サイドバーから「Locations」を選択
- 「Create New」ボタンをクリック
- 以下を入力:
- Short Code: 識別コード（例: tokyo-1, local）
- Description: 説明（例: Tokyo Region, Local Node）
- 「Create」ボタンをクリック
Step 6: Node（ノード）の作成
Wingsを実行するサーバー（ノード）を登録します。
- 左サイドバーから「Nodes」を選択
- 「Create New」ボタンをクリック
- 基本情報を入力:
- Name: ノード名（例: Main Node）
- Description: 説明
- Location: Step 5で作成したLocationを選択
- FQDN: サーバーのドメイン名（Step 2で確認したドメイン）
- Communicate Over SSL: チェックを入れる（必須）
- Behind Proxy: プロキシ使用時のみチェック
- Configuration（設定）タブで以下を設定:
- Total Memory: サーバーの搭載メモリ量（MB単位）
- Memory Over-Allocation: 過剰割り当て率（0-100%、通常は0）
- Total Disk Space: 使用可能なディスク容量（MB単位）
- Disk Over-Allocation: 過剰割り当て率（0-100%、通常は0）
- 「Create Node」ボタンをクリック
メモ
Total MemoryとTotal Disk Spaceは、Panel自体のリソースを除いた、ゲームサーバーに割り当て可能な量を指定します。例えば、4GBメモリのVPSでPanel用に1GB確保する場合、3000MB（3GB）程度を設定します。
Step 7: Wings設定の生成と配置
作成したNodeの設定ファイルをWingsに配置します。
- 作成したNodeをクリックして詳細画面を開く
- 「Configuration」タブを選択
- 「Auto-Deploy」セクションの「Generate Token」ボタンをクリック
- 表示されたコマンドをコピー
- SSHで接続したサーバーでコマンドを実行
# cd /etc/pterodactyl && sudo wings configure --panel-url https://[ドメイン] --token [トークン] --node 1
次に、ゲームサーバー用のポート割り当てを設定します:
- 「Allocation」タブを選択
- 「Assign New Allocations」のIP Addressに「0.0.0.0」、Portsに「ゲームサーバーの利用ポート範囲」（例: 25565-25575）を入力し「Submit」をクリック
Step 8: Wingsサービスの起動
設定が完了したら、Wingsサービスを起動します。
# systemctl start wings # systemctl status wings
ステータスが「active (running)」と表示されれば起動成功です。Panel上のNode詳細画面でもステータスが緑色（オンライン）になることを確認してください。
重要
Wingsが起動しない場合は、以下を確認してください: (1) Let’s Encrypt証明書が正しく設定されているか、(2) Node設定でFQDNとドメイン名が一致しているか、(3) ファイアウォールでポート8080が開放されているか、(4) /etc/pterodactyl/config.ymlが正しく配置されているか
Step 9: ゲームサーバーの作成
Panelからゲームサーバーを作成します。
- 左サイドバーから「Servers」を選択
- 「Create New」ボタンをクリック
- サーバー情報を入力:
- Server Name: サーバー名
- Server Owner: サーバー所有者（ユーザー選択）
- Node: 作成したNodeを選択
- Default Allocation: ゲームサーバーの待ち受けポート
- リソース配分を設定:
- Memory: 割り当てメモリ（MB単位、推奨: 1024MB以上）
- Disk: 割り当てディスク容量（MB単位）
- CPU: CPU制限（100 = 1コア、0で無制限）
- Nest（ゲームカテゴリ）とEgg（ゲーム種類）を選択
- Minecraft: Vanilla Minecraft, Paper, Spigotなど
- その他: Rust, ARK, Terraria, CS:GOなど多数対応
- 「Create Server」ボタンをクリック
サーバーが作成されると、自動的にゲームサーバーのインストールが開始されます。完了後、サーバー詳細画面の上部メニュー一番右側「Console」タブからゲームサーバーを起動できます。
Step 10: カスタムドメインの設定（オプション）
独自ドメインを使用したい場合は、ドメイン変更スクリプトを使用します。
# /root/pterodactyl-change-domain.sh -d your-domain.com
パラメータ:
-d, --domain: 新しいドメイン名（必須）
重要
ドメイン変更後は、必ずLet’s Encrypt証明書を再取得してください（/root/pterodactyl-letsencrypt.sh -e [email protected] -d new-domain.com）。また、既に作成したNodeのFQDN設定も新しいドメインに更新する必要があります。
Step 11: システム診断
システムの動作状況を確認するには、診断スクリプトを使用します。
# /root/pterodactyl-diagnose.sh
このスクリプトは以下を確認します:
- 全サービスの起動状態（Nginx, PHP-FPM, MariaDB, Redis, pteroq, Wings, Docker）
- 使用中のポート状態
- ディスク使用量とメモリ使用量
- SSL証明書の種類（Let’s Encrypt / 自己署名）
- HTTPSアクセスの疎通確認
管理スクリプト一覧
| スクリプト名 | 機能 | 使用例 |
|---|---|---|
| pterodactyl-letsencrypt.sh | Let’s Encrypt証明書設定（必須） | # /root/pterodactyl-letsencrypt.sh -e [email protected] |
| pterodactyl-change-domain.sh | ドメイン名変更 | # /root/pterodactyl-change-domain.sh -d your-domain.com |
| pterodactyl-diagnose.sh | システム診断 | # /root/pterodactyl-diagnose.sh |
セキュリティグループ設定
ConoHa VPSのセキュリティグループで以下のポートを開放してください。
| ポート番号 | プロトコル | 用途 | 必須/オプション |
|---|---|---|---|
| 22 | TCP | SSH | 必須 |
| 80 | TCP | HTTP（Let’s Encrypt認証） | 必須 |
| 443 | TCP | HTTPS（Panel管理画面） | 必須 |
| 8080 | TCP | Wings API通信 | 必須 |
| 2022 | TCP | Wings SFTP | 必須 |
| 25565 | TCP/UDP | Minecraftサーバー（例） | オプション |
メモ
ゲームサーバー用のポート（25565など）は、作成するゲームの種類と割り当てるポート番号に応じて個別に開放してください。各ゲームで使用するポートはEgg設定で確認できます。
アプリケーションの具体的な利用方法につきましては、サービス開発元やサービス提供元の公式サイト、Wikiなどで最新情報をご確認ください。
外部リンク
| サイト名 | URL | 説明 |
|---|---|---|
| Pterodactyl公式サイト | https://pterodactyl.io/ | プロダクト情報・最新ニュース |
| Pterodactyl公式ドキュメント | https://pterodactyl.io/panel/1.0/getting_started.html | 技術ドキュメント・インストールガイド |
| PterodactylのGitHubリポジトリ（Panel） | https://github.com/pterodactyl/panel | Panelのソースコード・イシュートラッカー |
| PterodactylのGitHubリポジトリ（Wings） | https://github.com/pterodactyl/wings | Wingsのソースコード・リリース情報 |
| Pterodactyl Discord コミュニティ | https://discord.gg/pterodactyl | 公式コミュニティサポート |
