Które porty muszę otworzyć dla Pterodactyl?

Dla Panelu otwórz porty 80 i 443, dla Wings port 8080 (API) i port 2022 (SFTP). Potrzebne są też porty gier z twoich alokacji, na przykład 25565 dla Minecrafta.

Konfiguracja Pterodactyl na serwerze Linux – uruchom własny panel do serwerów gier

Dowiedz się, jak zainstalować Pterodactyl Panel i Wings na serwerze Linux oraz wygodnie zarządzać własnymi serwerami gier przez interfejs WWW → Dowiedz się więcej

10 listopada 202612 min czytania1 Wyświetlenia0 pomocne

Wprowadzenie

Pterodactyl to bezpłatny panel open source, który umożliwia zarządzanie serwerami gier, takimi jak Minecraft, Rust, ARK czy CS2, przez interfejs WWW. Każdy serwer gry działa we własnym kontenerze Docker, odizolowanym od pozostałych.

Pterodactyl składa się z dwóch części:

Panel – interfejs WWW, w którym zarządzasz serwerami, użytkownikami i zasobami (aplikacja PHP z bazą danych i serwerem WWW)
Wings – usługa na serwerze, która uruchamia, zatrzymuje i monitoruje kontenery serwerów gier

W tym poradniku pokażemy ci krok po kroku, jak zainstalować Panel i Wings na serwerze VPS ZapX lub serwerze dedykowanym, skonfigurować domenę z SSL i utworzyć pierwszy serwer gry.

Przygotowanie

Do działania Pterodactyl potrzebujesz serwera VPS lub serwera dedykowanego z systemem Linux i dostępem root przez SSH. Informacje o tym, jak połączyć się z serwerem, znajdziesz w naszym poradniku dotyczącym pierwszego logowania przez SSH. Dopiero zaczynasz korzystać z ZapX? Najpierw zapoznaj się z wprowadzeniem do serwerów VPS lub serwerów dedykowanych.

Wskazówka

Uwierzytelnianie za pomocą klucza SSH

Zamiast hasła zalecamy używanie klucza SSH. Dowiedz się, jak to zrobić, z naszego poradnika Tworzenie i używanie kluczy SSH.

Wymagania sprzętowe

Sam Panel jest lekki. Potrzebna ci ilość zasobów zależy przede wszystkim od liczby serwerów gier, które chcesz uruchomić za pomocą Wings. Jeśli Panel i Wings mają działać na tym samym serwerze, zalecamy:

Sprzęt	Minimum	Zalecane
CPU	2 rdzenie vCPU	4 rdzenie vCPU lub więcej
RAM	4 GB	8 GB lub więcej
Miejsce na dysku	30 GB	100 GB lub więcej

Obsługiwane systemy operacyjne

Zgodnie z oficjalną dokumentacją Pterodactyl obecnie obsługiwane są te systemy:

System operacyjny	Wersje	Uwagi
Ubuntu	22.04, 24.04	W przypadku wersji 22.04 potrzebujesz dodatkowego repozytorium PHP
Debian	11, 12, 13	PHP 8.3 pochodzi z repozytorium Sury
Rocky Linux / AlmaLinux / RHEL	8, 9	Inne nazwy pakietów i ścieżki; nie opisujemy ich w tym poradniku

W tym poradniku znajdziesz polecenia dla Ubuntu i Debiana. Panel nie obsługuje już Ubuntu 20.04 ani starszych wersji. Jeśli instalujesz system od nowa, najlepiej wybierz Ubuntu 24.04 lub Debian 12.

Sprawdź wirtualizację

Wings potrzebuje Dockera. Docker działa bez problemów na serwerach opartych na KVM i na serwerach dedykowanych, ale zwykle nie działa na kontenerach OpenVZ ani LXC. Sprawdź to za pomocą tego polecenia:

bash

systemd-detect-virt

Wynik kvm lub none (serwer dedykowany bez wirtualizacji) jest prawidłowy. Jeśli pojawi się openvz lub lxc, zwykle nie możesz uruchomić Wings na tym serwerze.

Zaktualizuj system

Przed instalacją zaktualizuj system do najnowszej wersji:

bash

apt update && apt upgrade -y

Instalowanie zależności

Panel wymaga PHP 8.2 lub 8.3 (zalecamy 8.3) z kilkoma rozszerzeniami, bazy danych (MariaDB lub MySQL), Redis, serwera WWW (używamy Nginx), a także curl, tar, unzip, git i Composera. Wykonaj polecenia odpowiednie dla swojej dystrybucji.

Ubuntu 24.04

W Ubuntu 24.04 PHP 8.3, MariaDB i Redis są już dostępne w standardowych repozytoriach pakietów. Nie musisz więc dodawać dodatkowych repozytoriów:

bash

apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg
apt -y install php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server

Ubuntu 22.04

Ubuntu 22.04 zawiera tylko PHP 8.1. Dlatego najpierw dodaj repozytorium PHP Ondřeja Surý’ego i oficjalne repozytorium Redis, a następnie zainstaluj wszystkie pakiety:

bash

# Werkzeuge für zusätzliche Repositories
apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg

# PHP-Repository (PPA) hinzufügen
LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php

# Offizielles Redis-Repository hinzufügen
curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
  |   /etc/apt/sources.list.d/redis.list


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

Pobieranie Panelu

Utwórz katalog Panelu i przejdź do niego:

bash

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

Pobierz najnowsze wydanie, rozpakuj je i ustaw uprawnienia do katalogów storage/ oraz bootstrap/cache/:

bash

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/

Instalowanie Panelu

Tworzenie bazy danych

Panel zapisuje wszystkie dane we własnej bazie danych. Zaloguj się do MariaDB:

bash

mariadb -u root -p

Utwórz użytkownika i bazę danych dla Panelu. Zastąp DeinSicheresPasswort własnym, bezpiecznym hasłem:

sql

CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'DeinSicheresPasswort';
CREATE DATABASE panel;
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
exit

Więcej informacji o MariaDB i innych bazach danych znajdziesz w naszym poradniku Konfiguracja baz danych na serwerze Linux.

Podstawowa konfiguracja

Skopiuj przykładową konfigurację, zainstaluj zależności PHP i wygeneruj klucz aplikacji:

bash

cp .env.example .env
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader

# Nur bei einer Neuinstallation ausführen, nicht bei einem bestehenden Panel
php artisan key:generate --force

Uwaga

Zabezpiecz APP_KEY

Wartość APP_KEY w pliku szyfruje wszystkie poufne dane Panelu, na przykład klucze API. Jeśli ją utracisz, tych danych nie da się już odczytać, nawet z kopii zapasowej bazy danych. Wyświetl ją poleceniem i zapisz w bezpiecznym miejscu poza serwerem, na przykład w menedżerze haseł.

Konfiguracja crona i procesu roboczego kolejki

Panel wykonuje wiele zadań w tle, na przykład zadania zaplanowane, wysyłkę e-maili i porządkowanie. Potrzebujesz do tego zadania cron i procesu roboczego kolejki.

Zadanie cron

Otwórz crontab poleceniem sudo crontab -e i dodaj ten wiersz. Uruchamia on harmonogram Panelu co minutę:

bash

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

Proces roboczy kolejki (pteroq)

Proces roboczy kolejki działa stale w tle jako usługa systemd. Utwórz plik:

bash

nano /etc/systemd/system/pteroq.service

Wklej tę zawartość:

ini

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

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

[Service]
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

Konfiguracja serwera WWW i SSL

Aby uzyskać dostęp do Panelu przez własną domenę z HTTPS, skonfiguruj teraz DNS, certyfikat SSL i Nginx.

Dodawanie rekordu DNS

Utwórz u dostawcy domeny rekord A wskazujący na adres IP serwera, na przykład panel.example.com. Jeśli twoja domena jest zarejestrowana w ZAP-Hosting, skorzystaj z naszego poradnika dotyczącego rekordów domeny. Aktywacja rekordu na całym świecie może trochę potrwać.

Tworzenie certyfikatu SSL za pomocą Certbota

Zainstaluj Certbota z wtyczką Nginx i utwórz certyfikat. Zastąp panel.example.com swoją domeną:

bash

apt install -y certbot python3-certbot-nginx
certbot certonly --nginx -d panel.example.com

Certbot weryfikuje domenę przez port 80. Port musi być więc dostępny z internetu. Więcej informacji o Certbocie znajdziesz w naszym poradniku Konfiguracja Certbota na serwerze Linux.

Pakiet Certbot automatycznie odnawia certyfikaty. Aby Nginx i Wings wczytały odnowiony certyfikat, możesz dodać ten wiersz do crontaba (sudo crontab -e):

bash

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

Konfiguracja Nginx z SSL

Usuń domyślną konfigurację Nginx:

bash

rm /etc/nginx/sites-enabled/default

Utwórz nowy plik konfiguracyjny Panelu:

bash

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

Wklej tę konfigurację i we wszystkich czterech miejscach zastąp swoją domeną:

Instalowanie Wings

Wings to usługa, która uruchamia twoje serwery gier. Możesz zainstalować Wings na tym samym serwerze co Panel lub na dodatkowych serwerach, które następnie dodasz w Panelu jako kolejne węzły.

Instalowanie Dockera

Wings uruchamia każdy serwer gry w kontenerze Docker. Zainstaluj Docker CE za pomocą oficjalnego skryptu instalacyjnego i aktywuj usługę:

bash

curl -sSL https://get.docker.com/ | CHANNEL=stable bash
sudo systemctl enable --now docker

Więcej informacji o Dockerze znajdziesz w naszym poradniku Konfiguracja Dockera na serwerze Linux.

Pobieranie Wings

Utwórz katalog konfiguracji i pobierz najnowszą wersję Wings dla swojej architektury procesora:

bash

sudo mkdir -p /etc/pterodactyl
curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_$([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64")"
sudo chmod u+x /usr/local/bin/wings

Tworzenie lokalizacji i węzła w Panelu

Zanim uruchomisz Wings, utwórz w Panelu węzeł, czyli serwer, na którym działa Wings:

Firewall i porty

Jeśli na serwerze korzystasz z firewalla, musisz otworzyć te porty:

Port	Protokół	Przeznaczenie
80 i 443	TCP	Panel (HTTP/HTTPS) i weryfikacja certyfikatu przez Certbota
8080	TCP	API Wings, za pomocą którego Panel komunikuje się z węzłem
2022	TCP	Dostęp SFTP do plików serwerów gier
Porty gier	TCP/UDP	Porty twoich alokacji, na przykład `25565` dla Minecrafta

Na przykład za pomocą UFW możesz otworzyć porty w ten sposób. Najpierw koniecznie zezwól na SSH, żeby nie zablokować sobie dostępu po włączeniu firewalla:

bash

ufw allow OpenSSH
ufw allow 80,443/tcp
ufw allow 8080/tcp
ufw allow 2022/tcp
ufw allow 25565:25570/tcp
ufw allow 25565:25570/udp
ufw enable

Więcej informacji znajdziesz w naszym poradniku dotyczącym zarządzania firewallem w systemie Linux.

Informacje

Docker i UFW

Docker tworzy własne reguły dla portów kontenerów serwerów gier. Dlatego te porty często są dostępne nawet wtedy, gdy nie zostały otwarte w UFW. Nie polegaj wyłącznie na UFW w kwestii portów gier.

Tworzenie pierwszego serwera gry

Wszystko jest już gotowe do utworzenia pierwszego serwera gry:

W sekcji administracyjnej otwórz Servers i kliknij Create New.
Wpisz nazwę i wybierz właściciela, na przykład swoje konto administratora.
Wybierz węzeł i wolną alokację.
Określ ilość CPU, pamięci RAM i miejsca na dysku przydzieloną serwerowi.
W sekcjach Nest i Egg wybierz grę, na przykład Minecraft z Paper.
Kliknij Create Server.

Wings pobierze teraz odpowiedni obraz Dockera i zainstaluje serwer. Następnie znajdziesz go w standardowym widoku Panelu. Możesz tam uruchomić serwer, otworzyć konsolę i zarządzać plikami.

Podsumowanie i dodatkowe zasoby

Gratulacje! Panel Pterodactyl i Wings są już zainstalowane na twoim serwerze. Możesz teraz zarządzać własnymi serwerami gier przez interfejs WWW. Te zasoby pomogą ci dowiedzieć się więcej:

pterodactyl.io – oficjalna strona
Dokumentacja Pterodactyl – instalacja, aktualizacje i dodatkowa konfiguracja
GitHub – kod źródłowy i wydania

Uwaga: od wersji 1.11 Pterodactyl wysyła anonimowe dane o użytkowaniu (telemetrię). Informacje o tym, jak ją wyłączyć, znajdziesz w oficjalnej dokumentacji w sekcji „Additional Configuration”.

Masz jeszcze pytania, na które nie ma tu odpowiedzi? Nasz zespół pomocy służy ci wsparciem każdego dnia — po prostu skontaktuj się z nami! 🙂

FAQ

Często zadawane pytania

Pterodactyl to bezpłatny panel open source do zarządzania serwerami gier. Składa się z Panelu (interfejsu WWW) i Wings (usługi na serwerze), która uruchamia każdy serwer gry we własnym kontenerze Docker.

Zgodnie z oficjalną dokumentacją są to Ubuntu 22.04 i 24.04, Debian 11, 12 i 13 oraz Rocky Linux, AlmaLinux i RHEL 8 i 9. Panel nie obsługuje już Ubuntu 20.04 ani starszych wersji.

Panel wymaga PHP 8.2 lub 8.3; zalecana jest wersja 8.3. W Ubuntu 22.04 i Debianie PHP 8.3 pochodzi z dodatkowego repozytorium, a Ubuntu 24.04 zawiera je domyślnie.

Opinia

Czy ten artykuł był pomocny?

Twoja opinia pomaga nam lepiej ustalać priorytety i aktualizować treści.

0 od 0 Osoby oceniające uznały ten artykuł za pomocny.

Indywidualna pomoc

Instrukcja nie wystarcza?

Nasz zespół wsparcia ZAP zna twój produkt — opisz krótko problem, a pomożemy ci osobiście.

Zappy zna tę instrukcję i odpowie ci bezpośrednio na czacie.

server { listen 80; server_name panel.example.com; return 301 https://$server_name$request_uri; } server { listen 443 ssl http2; server_name panel.example.com; 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; # Größere Uploads und längere Laufzeiten erlauben client_max_body_size 100m; client_body_timeout 120s; sendfile off; # SSL-Konfiguration ssl_certificate /etc/letsencrypt/live/panel.example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/panel.example.com/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.3-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; } }

Wprowadzenie

Przygotowanie

Wymagania sprzętowe

Obsługiwane systemy operacyjne

Sprawdź wirtualizację

Zaktualizuj system

Instalowanie zależności

Ubuntu 24.04

Ubuntu 22.04

Pobieranie Panelu

Instalowanie Panelu

Tworzenie bazy danych

Podstawowa konfiguracja

Konfiguracja crona i procesu roboczego kolejki

Zadanie cron

Proces roboczy kolejki (pteroq)

Konfiguracja serwera WWW i SSL

Dodawanie rekordu DNS

Tworzenie certyfikatu SSL za pomocą Certbota

Konfiguracja Nginx z SSL

Instalowanie Wings

Instalowanie Dockera

Pobieranie Wings

Tworzenie lokalizacji i węzła w Panelu

Firewall i porty

Tworzenie pierwszego serwera gry

Podsumowanie i dodatkowe zasoby

Często zadawane pytania

Oprogramowanie

Pobieranie Panelu

Tworzenie pierwszego serwera gry

Podsumowanie i dodatkowe zasoby

Game Server

Serwery i hosting

ZAPX

Zasoby

ZAP-Hosting

Instalowanie zależności

Ubuntu 24.04

Ubuntu 22.04

Instalowanie Panelu

Tworzenie bazy danych

Podstawowa konfiguracja

Konfiguracja crona i procesu roboczego kolejki

Zadanie cron

Proces roboczy kolejki (pteroq)

Konfiguracja serwera WWW i SSL

Dodawanie rekordu DNS

Tworzenie certyfikatu SSL za pomocą Certbota

Konfiguracja Nginx z SSL

Instalowanie Wings

Instalowanie Dockera

Pobieranie Wings

Tworzenie lokalizacji i węzła w Panelu

Debian 11 i 12

Debian 13

Instalowanie Composera

Konfiguracja środowiska

Wypełnianie bazy danych

Tworzenie pierwszego administratora

Ustawianie uprawnień

Konfiguracja Nginx bez SSL

Aktywowanie konfiguracji

Testowanie Wings

Konfiguracja Wings jako usługi

Tworzenie alokacji