Go to main content

Serwer dedykowany: Instalacja Pterodactyl

Ten poradnik został stworzony z wykorzystaniem następujących produktów:

(Szczegóły mogą się różnić w zależności od produktów różnych dostawców, ale główne koncepcje pozostają takie same)

Serwer dedykowany

Wprowadzenie​

Panel Pterodactyl to open source panel administracyjny stworzony, aby łatwo zarządzać i hostować serwery gier. Zapewnia interfejs użytkownika, który pozwala administratorom centralnie konfigurować i zarządzać wieloma serwerami gier.

W tym poradniku przejdziemy przez kroki potrzebne do uruchomienia własnej instancji Pterodactyl na Twoim serwerze.

Przygotowanie​

Do instalacji panelu Pterodactyl potrzebujesz serwera dedykowanego z systemem Linux. Powinieneś użyć jednego z kompatybilnych systemów operacyjnych wymienionych w tabeli poniżej.

System operacyjnyKompatybilne wersje
Ubuntu20.04, 22.04
CentOS7, 8
Debian11, 12

Zależności​

Pterodactyl wymaga szeregu zależności, aby móc się poprawnie zainstalować i działać. Polega również na popularnym menedżerze zależności dla PHP o nazwie Composer.

Lista zależności​

Oto skrócona lista zależności, które będą potrzebne w tym poradniku. Przejdź do następnej sekcji, gdzie omówimy, jak je zainstalować.

  • PHP 8.1 z następującymi rozszerzeniami: cli, openssl, gd, mysql, PDO, mbstring, tokenizer, bcmath, xml lub dom, curl, zip oraz fpm.
  • MariaDB
  • Serwer WWW – w tym poradniku użyjemy Nginx.
  • curl
  • tar
  • unzip
  • git
  • composer v2

Instalacja zależności​

Najpierw uruchom to polecenie, które jest niezbędne, aby móc dodawać pakiety spoza domyślnych repozytoriów systemu.

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

Teraz zainstaluj dodatkowe repozytoria dla PHP, Redis i MariaDB (MySQL).

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

Musisz też zainstalować Redis, który jest potrzebny do tymczasowego przechowywania danych.

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

Do serwera WWW wybraliśmy Nginx, ponieważ jest niezawodny i open-source. Powinieneś go zainstalować lub możesz użyć alternatywnych serwerów WWW, takich jak Apache czy Caddy, choć nie będą one pasować do tego poradnika.

sudo apt install nginx # Pobierz i zainstaluj Nginx
sudo ufw allow 'Nginx Full' # Dostosuj zaporę sieciową

Zalecamy wejść na http://[twoj_adres_ip_serwera]/, zamieniając [twoj_adres_ip_serwera] na adres IP Twojego serwera, aby przetestować i upewnić się, że Nginx działa. Powinieneś zobaczyć domyślną stronę powitalną.

Następnie zainstaluj MariaDB, która będzie Twoją bazą danych MySQL.

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

Na koniec zaktualizuj listę repozytoriów i zainstaluj pozostałe zależności.

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

Teraz powinieneś mieć zainstalowane wszystkie niezbędne zależności i możesz przejść do instalacji Composera.

Instalacja Composera​

Gdy główne zależności są już zainstalowane, musisz zainstalować Composera, popularnego menedżera zależności dla PHP. Umożliwi to łatwe pobranie i instalację całego serwisu Pterodactyl.

Wystarczy uruchomić następujące polecenie:

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

Pobierz panel​

Gdy wszystkie wymagania wstępne są spełnione, musisz zainstalować panel Pterodactyl.

Musisz utworzyć folder, w którym będzie przechowywany panel, używając poniższego polecenia.

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

Teraz możesz sklonować oficjalne repozytorium Pterodactyl na GitHub, aby pobrać potrzebne pliki.

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/

Po zakończeniu pobierania panel zostanie poprawnie zainstalowany. W kolejnej sekcji skonfigurujesz szereg ustawień i opcji, aby panel działał poprawnie i stabilnie.

Instalacja​

Pierwszym krokiem instalacji jest skonfigurowanie bazy danych MySQL, która będzie przechowywać wszystkie dane Twojego panelu Pterodactyl. Jeśli masz już gotową bazę MySQL z odpowiednim użytkownikiem, możesz pominąć następną podsekcję.

Konfiguracja bazy danych​

Musisz zalogować się do swojej bazy MySQL, aby zacząć. Jeśli to świeża instancja MySQL, możesz to zrobić poleceniem:

mysql -u root -p

Jeśli masz już instancję MySQL, użyj swojego loginu, gdzie -u to nazwa użytkownika, a -p wywoła pole do wpisania hasła.

Po zalogowaniu musisz utworzyć nowego użytkownika, którego użyjesz dla instancji Pterodactyl. Pamiętaj, aby zastąpić [twoje_haslo] wybranym hasłem. Zrób to poleceniem:

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

Gdy użytkownik jest gotowy, musisz utworzyć bazę danych dla Pterodactyl i nadać uprawnienia nowemu użytkownikowi do zarządzania nią. Wykonaj:

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

Pomyślnie skonfigurowałeś użytkownika i bazę danych MySQL dla Pterodactyl, więc możesz kontynuować instalację. Wpisz exit, aby wyjść z konsoli MySQL.

Kontynuacja konfiguracji​

Teraz musisz skopiować domyślny plik środowiskowy, w którym przechowasz swoje tajne tokeny.

cp .env.example .env

Następnie możesz użyć Composera, aby automatycznie zainstalować wszystkie potrzebne pakiety, uruchamiając:

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

Musisz też wygenerować klucz szyfrowania dla aplikacji, co zrobisz poleceniem:

php artisan key:generate --force

Konfiguracja środowiska​

Teraz skonfigurujesz swoją instancję Pterodactyl. Wykonaj poniższe polecenia, które przeprowadzą Cię przez interaktywną konfigurację wielu ustawień, takich jak sesje, e-mail, cache i inne.

php artisan p:environment:setup # Pierwsze polecenie
php artisan p:environment:database # Drugie polecenie

Konfiguracja bazy danych​

Kolejnym krokiem jest ustawienie podstawowych danych potrzebnych do działania panelu, korzystając z wcześniej utworzonej bazy danych.

informacja

Proces ten może potrwać kilka minut. Nie przerywaj go, bo może to spowodować błędy. Prosimy o cierpliwość :)

php artisan migrate --seed --force

Tworzenie użytkownika administratora​

Gdy baza danych jest gotowa, musisz utworzyć pierwszego użytkownika administratora, aby zalogować się do panelu Pterodactyl. Zrób to poleceniem:

php artisan p:user:make

Ustawianie uprawnień​

Następny krok to ustawienie odpowiednich uprawnień do plików panelu Pterodactyl, aby panel mógł bez problemu odczytywać i zapisywać dane.

Ustaw uprawnienia poleceniem:

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

Po tym powinieneś mieć dostęp do panelu Pterodactyl, wchodząc pod adres, zamieniając twoj_adres_ip na IP Twojego serwera:

http://[twoj_adres_ip]/

Kolejkowanie zadań (Queue Workers)​

Ostatni krok instalacji panelu to konfiguracja cronjob, który będzie uruchamiany co minutę, oraz kolejki zadań odpowiedzialnej za wiele procesów w tle.

Najpierw otwórz crontab poleceniem sudo crontab -e. Gdy edytor się otworzy, dodaj poniższą linię, która uruchomi cronjob co minutę dla panelu Pterodactyl.

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

Teraz musisz utworzyć queue worker korzystając z systemd, który będzie utrzymywał działanie kolejki w tle.

Utwórz nowy plik dla workera, otwierając edytor nano:

nano /etc/systemd/system/pteroq.service

Wklej do pliku poniższą zawartość:

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

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

[Service]
# Na niektórych systemach użytkownik i grupa mogą być inne.
# Czasem jest to `apache` lub `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
notatka

Jeśli używasz CentOS, musisz zamienić redis-server.service na redis.service w powyższym pliku.

Zapisz plik, naciskając CTRL + X, a następnie Y, aby potwierdzić.

Na koniec włącz usługę Redis oraz utworzony serwis, aby startowały automatycznie wraz z systemem:

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

Pomyślnie zainstalowałeś Pterodactyl na swoim serwerze. Panel powinien być dostępny pod adresem, zamieniając [twoj_adres_ip_serwera] na IP Twojego serwera:

http://[twoj_adres_ip_serwera]

Opcjonalnie: Konfiguracja serwera WWW​

Dodatkowo możesz skonfigurować swój serwer WWW. W tym poradniku użyliśmy Nginx, więc ta sekcja pokaże, jak dostosować konfigurację dla niego.

Dzięki dalszej konfiguracji serwera WWW będziesz mógł ustawić panel na własnej domenie i dodać certyfikat SSL dla strony panelu.

Rekord DNS domeny​

Aby Twój serwer był dostępny pod domeną, musisz ustawić rekord DNS typu A dla tej domeny. To zależy od dostawcy domeny, ale zwykle znajdziesz to w panelu zarządzania DNS domeny. Wartością rekordu powinien być adres IP Twojego serwera.

Usuwanie domyślnej konfiguracji​

Zacznij od usunięcia domyślnej konfiguracji Nginx. Zrobisz to, usuwając plik:

rm /etc/nginx/sites-enabled/default

Teraz użyj poniższej zawartości, aby stworzyć nowy plik konfiguracyjny dla strony panelu Pterodactyl. Na tym etapie zdecyduj, czy chcesz używać SSL, ponieważ konfiguracja i kroki będą się różnić.

Konfiguracja Certbota​

Aby Twoja strona miała certyfikat SSL, musisz skonfigurować system automatycznego zarządzania i odnawiania certyfikatów. W tym przypadku użyjesz Certbota, który jest open-source.

Najpierw zainstaluj Certbota na serwerze. Dla Nginx potrzebujesz też pakietu python3-certbot-nginx.

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

Następnie musisz ustawić weryfikację, aby umożliwić wygenerowanie certyfikatu. Użyjemy wyzwania DNS, które jest bezpieczniejsze niż HTTP.

Musisz utworzyć rekord DNS typu TXT dla domeny, której chcesz użyć. To zależy od dostawcy domeny, ale zwykle znajdziesz to w panelu zarządzania DNS.

Uruchom poniższe polecenie, które poda Ci zawartość rekordu TXT. Zamień [twoja_domena] na swoją domenę.

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

Po ustawieniu rekordu DNS, skonfiguruj automatyczne odnawianie certyfikatu za pomocą cronjob. Otwórz crontab poleceniem sudo crontab -e i dodaj linię, która będzie odnawiać certyfikat codziennie o 23:00 czasu systemowego.

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

Tworzenie pliku konfiguracyjnego​

Gdy masz już certyfikat SSL, możesz zacząć tworzyć plik konfiguracyjny.

Uruchom poniższe polecenie, aby otworzyć edytor nano w odpowiednim folderze i pliku.

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

Wklej do edytora poniższą konfigurację. Pamiętaj, aby zastąpić [twoja_domena] domeną, dla której ustawiłeś rekord DNS.

ostrzeżenie

Upewnij się, że masz skonfigurowany certyfikat SSL, inaczej serwer WWW nie uruchomi się poprawnie.

server_tokens off;

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

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

    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/[twoja_domena]/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/[twoja_domena]/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;
    }
}

Zastosowanie konfiguracji​

Po wprowadzeniu zmian w konfiguracji musisz ją aktywować, wykonując poniższe polecenia.

sudo ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf # Niepotrzebne na CentOS

sudo systemctl restart nginx # Restart Nginx

Jeśli wszystko przebiegło pomyślnie, powinieneś teraz mieć łatwy dostęp do panelu Pterodactyl, korzystając z domeny, którą skonfigurowałeś w tej sekcji.

Pomyślnie skonfigurowałeś serwer WWW, aby używać własnej domeny i dodać certyfikat SSL do swojej strony.

Cookie settings