OKWszystkie usługi działają prawidłowo
InfrawireLogo InfrawireDokumentacja

Instalacja panelu Pterodactyl przez skrypt

Kompletny przewodnik instalacji Pterodactyl Panel i Wings na VPS za pomocą uproszczonego automatycznego skryptu instalacyjnego do łatwego zarządzania serwerami gier.

~4 min czytania
pterodactylpanelgryserweryminecraftgamingwings

Ten przewodnik opisuje instalację Pterodactyl Panel i Wings na VPS przy użyciu uproszczonego automatycznego skryptu instalacyjnego. Pterodactyl to darmowy i otwarty panel do zarządzania serwerami gier (Minecraft, FiveM itd.).

📋 Wymagania wstępne

  • Serwer VPS z dostępem root
  • Minimum 1 GB RAM (zalecane 2 GB)
  • Ubuntu 22.04/24.04, Debian 11/12/13, Rocky Linux 8/9 lub AlmaLinux 8/9
  • Domena wskazująca na IP VPS (opcjonalnie, ale zalecane)
  • Otwarte porty 80, 443, 2022 i 8080 (jeśli używasz zapory)

💡 Rekomendacja infrastruktury

Panel Pterodactyl świetnie nadaje się do zarządzania wymagającymi serwerami gier. Dla optymalnej wydajności polecamy nasz VPS Performance z wydajnymi procesorami i pamięcią DDR5 — idealny do hostowania wielu serwerów gier jednocześnie (Minecraft, FiveM itd.).

Informacja — Aby zautomatyzować instalację Pterodactyl (panel i Wings), możesz wybrać nasz hosting Pterodactyl.

🚀 Instalacja panelu Pterodactyl

Przygotowanie serwera

Przed instalacją Pterodactyl przygotuj serwer:

Bash
1# Aktualizacja systemu
2sudo apt update && sudo apt upgrade -y
3
4# Instalacja curl w razie potrzeby
5sudo apt install curl -y
6
7# Sprawdź, czy jesteś root lub używasz sudo
8whoami

Instalacja przez uproszczony skrypt

Automatyczny skrypt instalacyjny znacznie upraszcza instalację Pterodactyl:

Bash
# Uruchomienie skryptu instalacyjnego Pterodactyl
bash <(curl -s https://pterodactyl-installer.se)

Skrypt przeprowadzi Cię krok po kroku przez instalację:

  1. Wybór typu instalacji:

    • instalacja panelu (Pterodactyl Panel)
    • instalacja Wings (demon zarządzający serwerami)
    • instalacja pełna (Panel + Wings)

  2. Konfiguracja systemu:

    • automatyczna instalacja zależności (PHP, MySQL, Nginx itd.)
    • konfiguracja bazy danych
    • konfiguracja serwera WWW (Nginx)
    • konfiguracja SSL (Let’s Encrypt)

Tylko panel

Jeśli chcesz zainstalować sam panel (do zarządzania serwerami):

Bash
1# Uruchom skrypt
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Wybierz opcję „1”, aby zainstalować panel
5# Postępuj zgodnie z instrukcjami skryptu

Pełna instalacja (Panel + Wings)

Aby zainstalować Panel i Wings na tym samym serwerze:

Bash
1# Uruchom skrypt
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Wybierz opcję „3” dla instalacji pełnej
5# Postępuj zgodnie z instrukcjami skryptu

⚙️ Konfiguracja panelu

Konfiguracja początkowa

Po instalacji panelu skonfiguruj:

  1. Konto administratora:

    • skrypt poprosi o utworzenie pierwszego użytkownika admina
    • wybierz adres e-mail i silne hasło

  2. Baza danych:

    • skrypt automatycznie utworzy bazę MySQL
    • zapisz dane dostępowe do bazy

  3. Domena:

    • jeśli masz domenę, skrypt zwykle skonfiguruje Nginx
    • w przeciwnym razie dostęp możliwy jest przez IP serwera

Dostęp do panelu

Po zakończeniu instalacji wejdź do panelu:

Bash
1# Jeśli skonfigurowałeś domenę
2https://twoja-domena.pl
3
4# Bez domeny
5http://IP_TWOJEGO_SERWERA

🛠️ Instalacja Wings (demon)

Wings to demon faktycznie zarządzający serwerami gier. Możesz go zainstalować na tym samym serwerze co panel lub na osobnym serwerze.

Wings na tym samym serwerze

Bash
1# Uruchom skrypt
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Wybierz opcję „3” dla instalacji pełnej
5# lub opcję „2”, jeśli panel jest już zainstalowany

Wings na osobnym serwerze

Jeśli instalujesz Wings na innym serwerze niż panel:

Bash
1# Na serwerze docelowym dla Wings
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Wybierz opcję „2”, aby zainstalować tylko Wings
5# Postępuj zgodnie z instrukcjami skryptu

Konfiguracja Wings

Po instalacji skonfiguruj Wings:

  1. Pobierz klucz API:

    • zaloguj się do panelu
    • przejdź do Administration → Configuration → Nodes
    • utwórz nowy węzeł lub użyj istniejącego
    • skopiuj klucz API i FQDN

  2. Konfiguracja Wings:

    Bash
    1# Edycja pliku konfiguracyjnego Wings
2sudo nano /etc/pterodactyl/config.yml
3
4# Wklej klucz API i FQDN z panelu
5# Zapisz i wyjdź (Ctrl+X, potem Y, potem Enter)

  3. Uruchomienie Wings:

    Bash
    1# Uruchomienie usługi Wings
2sudo systemctl start wings
3
4# Autostart przy starcie systemu
5sudo systemctl enable wings
6
7# Status
8sudo systemctl status wings

🔧 Zapora UFW

Jeśli używasz UFW, otwórz wymagane porty:

Bash
1# Porty panelu Pterodactyl
2sudo ufw allow 80/tcp
3sudo ufw allow 443/tcp
4
5# Port Wings (domyślnie 8080)
6sudo ufw allow 8080/tcp
7
8# Port SFTP Wings (domyślnie 2022)
9sudo ufw allow 2022/tcp
10
11# Sprawdzenie reguł
12sudo ufw status

📝 Konfiguracja po instalacji

Weryfikacja instalacji

Bash
1# Czy panel odpowiada
2curl -I http://localhost
3
4# Czy Wings działa
5sudo systemctl status wings
6
7# Logi Wings
8sudo journalctl -u wings -f

Aktualizacja Pterodactyl

Aby zaktualizować panel lub Wings:

Bash
1# Ponowne uruchomienie skryptu instalacyjnego
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Wybierz opcję aktualizacji
5# Skrypt wykryje istniejącą instalację i zaproponuje aktualizację

Przydatne polecenia Wings

Bash
1# Restart Wings
2sudo systemctl restart wings
3
4# Zatrzymanie Wings
5sudo systemctl stop wings
6
7# Logi na żywo
8sudo journalctl -u wings -f
9
10# Przeładowanie konfiguracji bez pełnego restartu (debug)
11sudo wings --debug

🎮 Pierwszy serwer

W panelu Pterodactyl

  1. Utwórz użytkownika:

    • Users → New User
    • utwórz konto (jeśli jeszcze nie masz)

  2. Utwórz serwer:

    • „Create a new server”
    • wybierz węzeł (Wings)
    • wybierz egg (Minecraft, FiveM itd.)
    • ustaw zasoby (RAM, CPU, dysk)
    • nazwa i opis

  3. Uruchom serwer:

    • po utworzeniu otwórz serwer
    • Power → Start

✅ Weryfikacja i testy

Sprawdzenie działania

Bash
1# Panel (powinien zwrócić HTTP 200)
2curl -I http://localhost
3
4# Wings
5sudo systemctl status wings
6
7# Usługi pomocnicze
8sudo systemctl status nginx
9sudo systemctl status mysql
10sudo systemctl status redis

Test połączenia Panel → Wings

W panelu:

  1. Administration → Nodes
  2. Sprawdź, czy węzeł jest online (status zielony)
  3. Jeśli offline — sprawdź konfigurację Wings

🆘 Rozwiązywanie problemów

Panel się nie wyświetla

Bash
1# Status Nginx
2sudo systemctl status nginx
3
4# Logi błędów Nginx
5sudo tail -f /var/log/nginx/error.log
6
7# Restart Nginx
8sudo systemctl restart nginx
9
10# Test konfiguracji Nginx
11sudo nginx -t

Wings nie startuje

Bash
1# Logi Wings
2sudo journalctl -u wings -n 50
3
4# Plik konfiguracyjny
5sudo nano /etc/pterodactyl/config.yml
6
7# Składnia i debug
8sudo wings --debug
9
10# Czy port 8080 jest wolny
11sudo netstat -tlnp | grep 8080

Błąd połączenia Panel → Wings

Bash
1# Klucz API w config.yml
2sudo cat /etc/pterodactyl/config.yml | grep -i "api\|token"
3
4# FQDN
5sudo cat /etc/pterodactyl/config.yml | grep -i "remote"
6
7# Łączność z panelem
8curl -I https://TWOJA_DOMENA_PANELU
9
10# Restart Wings
11sudo systemctl restart wings

Problem z bazą danych

Bash
1# Status MySQL
2sudo systemctl status mysql
3
4# Połączenie
5sudo mysql -u root -p
6
7# Lista baz
8SHOW DATABASES;
9
10# Baza pterodactyl
11USE pterodactyl;
12SHOW TABLES;

Błąd SSL/HTTPS

Bash
1# Wersja Certbot
2sudo certbot --version
3
4# Odnawianie certyfikatu
5sudo certbot renew
6
7# Nginx + SSL
8sudo nginx -t
9sudo systemctl reload nginx

📚 Dodatkowe zasoby

❓ Często zadawane pytania

P: Czy mogę zainstalować Panel i Wings na osobnych serwerach?
O: Tak, przy większych wdrożeniach jest to wręcz zalecane. Panel na jednym serwerze, Wings na jednym lub wielu innych. Wings łączysz z panelem kluczem API.

P: Jaka jest różnica między Panelem a Wings?
O: Panel to interfejs WWW do zarządzania serwerami. Wings to demon na maszynach z grami, który faktycznie zarządza kontenerami Docker i procesami serwerów gier.

P: Czy mogę zainstalować Pterodactyl bez domeny?
O: Tak, możesz użyć IP serwera, ale SSL trzeba skonfigurować ręcznie lub zaakceptować certyfikat podpisany. Zdecydowanie zaleca się domenę z Let’s Encrypt.

P: Czy skrypt instaluje Dockera automatycznie?
O: Tak, skrypt instaluje Dockera i Docker Compose, które są wymagane przez Wings.

P: Jak zaktualizować Pterodactyl po instalacji?
O: Uruchom ponownie skrypt instalacyjny. Wykryje istniejącą instalację i zaproponuje aktualizację:

Bash
bash <(curl -s https://pterodactyl-installer.se)

P: Czy mogę użyć innego serwera WWW niż Nginx?
O: Skrypt domyślnie instaluje Nginx. Apache jest możliwy, ale wymaga ręcznej konfiguracji po instalacji.

P: Ile RAM potrzeba do instalacji Pterodactyl?
O: Minimum 1 GB, zalecane 2 GB. Do hostowania gier potrzebna będzie dodatkowa pamięć w zależności od liczby i rozmiaru serwerów.

P: Jak zrobić wiele serwerów gier?
O: Po skonfigurowaniu Panelu i Wings możesz tworzyć dowolną liczbę serwerów w panelu. Każdy zużywa część zasobów (RAM, CPU, dysk).

P: Czy Pterodactyl nadaje się tylko do gier?
O: Nie — Pterodactyl może zarządzać dowolnymi kontenerami Docker: aplikacje WWW, boty Discord itd.

Poprzedni

Instalacja Plesk na VPS z Linuxem

Następny

Instalacja i konfiguracja UFW na VPS

Potrzebujesz pomocy?

Wsparcie

Nasz zespół jest dostępny 24/7

Discord

Dołącz do społeczności