Skip to main content

専用サーバー：Pterodactylのインストール

このガイドは、以下の製品を使用して作成されました：

（詳細はプロバイダーごとの製品によって異なる場合がありますが、基本的な概念は同じです）

専用サーバー

はじめに​

Pterodactylパネルは、ゲームサーバーの管理とホスティングを簡単に行うためのオープンソースのコントロールパネルです。管理者が複数のゲームサーバーを一元的に設定・管理できるユーザーインターフェースを提供します。

このガイドでは、専用サーバー上に自分のPterodactylインスタンスをセットアップするための手順を解説します。

準備​

Pterodactylパネルをインストールするには、Linuxが動作する専用サーバーが必要です。以下の表にある対応OSのいずれかを使用してください。

OS対応バージョン
Ubuntu20.04, 22.04
CentOS7, 8
Debian11, 12

依存関係​

Pterodactylを正常にインストール・実行するには、いくつかの依存関係が必要です。また、PHPの依存関係マネージャーであるComposerも利用します。

依存関係リスト​

このガイドで必要な依存関係の概要は以下の通りです。次のセクションでインストール方法を説明します。

  • PHP 8.1 と以下の拡張機能：cli, openssl, gd, mysql, PDO, mbstring, tokenizer, bcmath, xmlまたはdom, curl, zip, fpm
  • MariaDB
  • Webサーバー - 本ガイドではNginxを使用します。
  • curl
  • tar
  • unzip
  • git
  • composer v2

依存関係のインストール​

まず、OSにデフォルトで含まれていないパッケージを追加できるように、以下のコマンドを実行してください。

apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg

次に、PHP、Redis、MariaDB（MySQL）の追加リポジトリをインストールします。

LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php

一時データ保存に必要なRedisもインストールします。

curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list

Webサーバーには信頼性が高くオープンソースのNginxを使用します。ApacheやCaddyなど他のWebサーバーも使えますが、本ガイドとは少し異なります。

sudo apt install nginx # Nginxのダウンロードとインストール
sudo ufw allow 'Nginx Full' # ファイアウォールの調整

http://[your_serverip]/ にアクセスし、Nginxが正常に動作しているか確認してください。デフォルトのウェルカムページが表示されるはずです。

続いて、MySQLデータベースとして使用するMariaDBをインストールします。

curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash

最後にリポジトリを更新し、残りの依存関係をインストールします。

apt update
apt -y install php8.1 php8.1-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server

これで必要な依存関係がすべてインストールされました。次はComposerのインストールに進みます。

Composerのインストール​

主要な依存関係が揃ったので、PHPの依存関係マネージャーであるComposerをインストールします。これにより、Pterodactylサービス全体を簡単にダウンロード・インストールできます。

以下のコマンドを実行してください。

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

パネルのダウンロード​

すべての前提条件が整ったので、Pterodactylパネルをインストールします。

まず、パネルを保存するフォルダを作成します。

mkdir /var/www/pterodactyl
cd /var/www/pterodactyl

次に、公式のPterodactyl GitHubリポジトリから必要なファイルをクローンします。

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/

クローンが完了すると、パネルのダウンロードが成功しています。次のセクションでは、パネルが正しくインストールされ、正常に動作するように各種設定を行います。

インストール​

インストールの最初のステップは、Pterodactylパネルのデータを保存するMySQLデータベースのセットアップです。すでに適切なユーザーが設定されたMySQLデータベースがある場合は、次のサブセクションをスキップして構いません。

データベースのセットアップ​

MySQLデータベースにログインします。新規のMySQLインスタンスなら、以下のコマンドでログイン可能です。

mysql -u root -p

既存のMySQLインスタンスがある場合は、-uにユーザー名、-pでパスワード入力を行います。

ログイン後、Pterodactyl用の新しいユーザーを作成します。[your_password]は任意のパスワードに置き換えてください。

CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY '[your_password]';

ユーザーが作成できたら、Pterodactyl用のデータベースを作成し、新ユーザーに権限を付与します。

CREATE DATABASE panel;
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;

これでMySQLユーザーとデータベースのセットアップが完了しました。exitコマンドでMySQL管理画面を終了してください。

セットアップの続き​

次に、環境設定ファイルのコピーを行います。

cp .env.example .env

続いて、Composerを使って必要なパッケージを自動インストールします。

composer install --no-dev --optimize-autoloader

アプリケーション用の暗号化キーを生成します。

php artisan key:generate --force

環境設定​

Pterodactylインスタンスのセットアップを開始します。以下のコマンドを順に実行すると、セッション、メール、キャッシュなど幅広い設定を対話形式で行えます。

php artisan p:environment:setup # 最初のコマンド
php artisan p:environment:database # 次のコマンド

データベースのセットアップ​

パネルの動作に必要な基本データをデータベースにセットアップします。先ほど作成したデータベースを使用します。

備考

処理には数分かかる場合があります。途中で中断すると不具合の原因になるので、完了まで気長にお待ちください :)

php artisan migrate --seed --force

管理者ユーザーの作成​

データベースの準備ができたら、Pterodactylパネルにログインするための最初の管理者ユーザーを作成します。

php artisan p:user:make

パーミッションの設定​

パネルのファイルに対して、常に読み書きが問題なく行えるようにパーミッションを設定します。

以下のコマンドを実行してください。

chown -R www-data:www-data /var/www/pterodactyl/*

これで、以下のURLにアクセスすればPterodactylパネルに入れます。your_ipaddressはサーバーのIPアドレスに置き換えてください。

http://[your_ipaddress]/

キュー・ワーカーの設定​

インストールの最後のステップは、定期的に実行されるcronジョブと、バックグラウンドで多くのタスクを処理するキュー・ワーカーの設定です。

まず、sudo crontab -eでcrontabを開き、以下の行を追加して毎分Pterodactylのスケジュールを実行します。

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

次に、systemdを使ってキュー・ワーカーを作成し、バックグラウンドで常に動作させます。

以下のコマンドでnanoエディタを開きます。

nano /etc/systemd/system/pteroq.service

以下の内容をコピー＆ペーストしてください。

# Pterodactyl Queue Worker File
# ----------------------------------

[Unit]
Description=Pterodactyl Queue Worker
After=redis-server.service

[Service]
# 一部のシステムではユーザーやグループ名が異なる場合があります。
# apacheやnginxを使っている場合もあります。
User=www-data
Group=www-data
Restart=always
ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target
注記

CentOSを使っている場合は、上記ファイル内の redis-server.service を redis.service に置き換えてください。

編集が終わったら、CTRL + X、Yで保存してnanoを閉じます。

最後に、Redisサービスと作成したサービスを起動時に有効化します。

sudo systemctl enable --now redis-server
sudo systemctl enable --now pteroq.service

これでサーバーにPterodactylが正常にインストールされました。以下のURLでパネルにアクセスできます。[your_serverip]はサーバーのIPアドレスに置き換えてください。

http://[your_serverip]

オプション：Webサーバーの設定​

追加機能として、Webサーバーの設定を行うこともできます。本ガイドではNginxを使用しているため、ここではNginxの設定方法を解説します。

Webサーバーをさらに設定するメリットは、パネルを独自のドメインで運用できることや、SSL証明書を設定して安全にアクセスできることです。

ドメインのDNSレコード設定​

サーバーをドメインでアクセス可能にするには、そのドメインに対してAレコードを設定する必要があります。設定方法はドメインの管理会社によって異なりますが、多くの場合「DNSパネル」などの管理画面から設定可能です。レコードの内容は、利用しているサーバーのIPアドレスを指定してください。

デフォルト設定の削除​

まずはNginxのデフォルト設定を削除します。以下のコマンドでファイルを削除してください。

rm /etc/nginx/sites-enabled/default

ここからは、パネル用の新しい設定ファイルを作成します。SSLを使うかどうかで設定内容や手順が少し変わるので、どちらかを選択してください。

Certbotのセットアップ​

SSL証明書を自動管理・更新するために、オープンソースのCertbotを使います。

まずはCertbotをサーバーにインストールします。Nginx用にpython3-certbot-nginxも必要です。

sudo apt update
sudo apt install -y certbot
sudo apt install -y python3-certbot-nginx

次に、証明書発行のための検証を行います。ここではHTTPチャレンジより安全なDNSチャレンジを使います。

使用したいドメインに対してTXTレコードを作成してください。設定方法はドメイン管理会社によって異なりますが、DNSパネルなどから設定可能です。

以下のコマンドを実行すると、TXTレコードに設定すべき内容が表示されます。[your_domain]は使用したいドメインに置き換えてください。

certbot -d [your_domain] --manual --preferred-challenges dns certonly

DNSレコードを設定したら、証明書の自動更新をcronジョブで設定します。sudo crontab -eでcrontabを開き、以下の行を追加してください。これで毎日23時に証明書が更新され、更新後にNginxが再起動されます。

0 23 * * * certbot renew --quiet --deploy-hook "systemctl restart nginx"

設定ファイルの作成​

SSL証明書が準備できたら、設定ファイルを作成します。

以下のコマンドでnanoエディタを開きます。

nano /etc/nginx/sites-enabled/pterodactyl.conf

以下の内容をコピー＆ペーストしてください。[your_domain]は先ほどDNSレコードを設定したドメインに置き換えてください。

Warning

SSL証明書を設定していないと、Webサーバーが正常に起動しません。必ず証明書を用意してください。

server_tokens off;

server {
    listen 80;
    server_name [your_domain];
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name [your_domain];

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

    access_log /var/log/nginx/pterodactyl.app-access.log;
    error_log  /var/log/nginx/pterodactyl.app-error.log error;

    client_max_body_size 100m;
    client_body_timeout 120s;

    sendfile off;

    ssl_certificate /etc/letsencrypt/live/[your_domain]/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/[your_domain]/privkey.pem;
    ssl_session_cache shared:SSL:10m;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384";
    ssl_prefer_server_ciphers on;

    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";
    add_header X-Robots-Tag none;
    add_header Content-Security-Policy "frame-ancestors 'self'";
    add_header X-Frame-Options DENY;
    add_header Referrer-Policy same-origin;

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

    location ~ \.php$ {
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param PHP_VALUE "upload_max_filesize = 100M \n post_max_size=100M";
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param HTTP_PROXY "";
        fastcgi_intercept_errors off;
        fastcgi_buffer_size 16k;
        fastcgi_buffers 4 16k;
        fastcgi_connect_timeout 300;
        fastcgi_send_timeout 300;
        fastcgi_read_timeout 300;
        include /etc/nginx/fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}

設定の適用​

設定ファイルを作成したら、以下のコマンドで有効化し、Nginxを再起動します。

sudo ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf # CentOSでは不要

sudo systemctl restart nginx # Nginxを再起動

これで設定は完了です。設定したドメインでPterodactylパネルにアクセスできるはずです。

独自ドメインの利用とSSL証明書の設定によって、より安全で便利にパネルを運用できます。

Cookie settings