Nastavení Pterodactylu na Linux serveru – hostuj vlastní panel herních serverů
Zjisti, jak nainstalovat Pterodactyl Panel a Wings na Linux server a pohodlně spravovat vlastní herní servery přes webové rozhraní → Zjistit více
17. listopadu 202612 Min. doba čtení17 Zobrazení0 užitečné
Úvod
Pterodactyl je bezplatný panel s otevřeným zdrojovým kódem, který ti umožní spravovat herní servery, například Minecraft, Rust, ARK nebo CS2, přes webové rozhraní. Každý herní server přitom běží ve vlastním kontejneru Docker, odděleně od ostatních.
Pterodactyl se skládá ze dvou částí:
Panel – webové rozhraní, ve kterém spravuješ servery, uživatele a prostředky (aplikace PHP s databází a webovým serverem)
Wings – služba na serveru, která spouští, zastavuje a monitoruje kontejnery herních serverů
V tomto návodu ti krok za krokem ukážeme, jak nainstalovat Panel a Wings na VPS serveru od ZapX nebo na dedikovaném serveru, nastavit doménu s SSL a vytvořit svůj první herní server.
Příprava
K Pterodactylu potřebuješ VPS server nebo dedikovaný server s Linuxem a přístupem root přes SSH. Jak se připojit k serveru, zjistíš v našem návodu k prvnímu připojení přes SSH. Jsi u ZapX nový? Nejdřív si projdi úvod k VPS serverům nebo dedikovaným serverům.
Samotný Panel je nenáročný. Potřebné prostředky závisí hlavně na tom, kolik herních serverů chceš provozovat pomocí Wings. Pokud Panel i Wings poběží na stejném serveru, doporučujeme:
Hardware
Minimum
Doporučeno
CPU
2 jádra vCPU
4 jádra vCPU nebo více
RAM
4 GB
8 GB nebo více
Úložiště
30 GB
100 GB nebo více
Podporované operační systémy
Podle oficiální dokumentace Pterodactylu jsou aktuálně podporované tyto systémy:
Operační systém
Verze
Poznámka
Ubuntu
22.04, 24.04
U verze 22.04 potřebuješ další repozitář PHP
Debian
11, 12, 13
PHP 8.3 pochází z repozitáře Sury
Rocky Linux / AlmaLinux / RHEL
8, 9
Jiné názvy balíčků a cesty, v tomto návodu se jim nevěnujeme
V tomto návodu najdeš příkazy pro Ubuntu a Debian. Panel už nepodporuje Ubuntu 20.04 ani starší verze. Pokud systém instaluješ znovu, doporučujeme použít Ubuntu 24.04 nebo Debian 12.
Kontrola virtualizace
Wings potřebuje Docker. Docker bez problémů běží na serverech založených na KVM a na dedikovaných serverech, ale na kontejnerech OpenVZ nebo LXC většinou ne. Zkontroluj to tímto příkazem:
bash
systemd-detect-virt
Výstup kvm nebo none (dedikovaný server bez virtualizace) je v pořádku. Pokud se zobrazí openvz nebo lxc, Wings na tomto serveru zpravidla provozovat nemůžeš.
Aktualizace systému
Před instalací aktualizuj systém na nejnovější verzi:
bash
apt update && apt upgrade -y
Stažení Panelu
Vytvoř složku pro Panel a přejdi do ní:
bash
mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
Stáhni nejnovější vydání, rozbal ho a nastav oprávnění pro složky storage/ a bootstrap/cache/:
Docker vytváří vlastní pravidla pro porty kontejnerů herních serverů. Tyto porty jsou proto často dostupné, i když je v UFW nepovolíš. U herních portů se tedy nespoléhej pouze na UFW.
Vytvoření prvního herního serveru
Teď je všechno připravené pro tvůj první herní server:
Ve správcovské části otevři Servers a klikni na Create New.
Zadej název a vyber vlastníka (například svůj správcovský účet).
Vyber node a volnou alokaci.
Nastav, kolik CPU, RAM a místa na disku server dostane.
V části Nest a Egg vyber hru, například Minecraft s Paper.
Klikni na Create Server.
Wings teď stáhne odpovídající obraz Dockeru a nainstaluje server. Potom ho najdeš v běžném zobrazení Panelu, kde ho můžeš spustit, otevřít konzoli a spravovat soubory.
Závěr a další zdroje
Gratulujeme! Úspěšně jsi na serveru nainstaloval Pterodactyl Panel i Wings a teď můžeš spravovat vlastní herní servery přes webové rozhraní. Další informace najdeš v těchto zdrojích:
Poznámka: Od verze 1.11 odesílá Pterodactyl anonymní údaje o používání (telemetrii). Jak tuto funkci vypnout, najdeš v oficiální dokumentaci v části „Additional Configuration“.
Máš další otázky, na které jsi tady nenašel odpověď? Náš tým podpory ti každý den rád pomůže – stačí se nám ozvat! 🙂
FAQ
Často kladené dotazy
Pterodactyl je bezplatný panel s otevřeným zdrojovým kódem pro správu herních serverů. Skládá se z Panelu (webového rozhraní) a Wings (služby na serveru), která spouští každý herní server ve vlastním kontejneru Docker.
Podle oficiální dokumentace podporuje Ubuntu 22.04 a 24.04, Debian 11, 12 a 13 a také Rocky Linux, AlmaLinux a RHEL 8 a 9. Panel už nepodporuje Ubuntu 20.04 ani starší verze.
Panel potřebuje PHP 8.2 nebo 8.3, doporučujeme PHP 8.3. V Ubuntu 22.04 a Debianu ho získáš z dalšího repozitáře, Ubuntu 24.04 ho obsahuje už ve výchozím nastavení.
Pro Panel povol porty 80 a 443, pro Wings port 8080 (API) a port 2022 (SFTP). Dále potřebuješ herní porty svých alokací, například 25565 pro Minecraft.
Zpětná vazba
Pomohl ti tento článek?
Tvoje zpětná vazba nám pomáhá lépe určovat priority a upravovat obsah.
0 od 0 Uživatelé označili tento článek za užitečný.
Osobní pomoc
Návod nestačí?
Naše podpora ZAP zná tvůj produkt — stručně popiš, co potřebuješ, a osobně ti pomůžeme.
Ty rozhoduješ, které služby smíme aktivovat pro analýzu, personalizaci a externí obsah.
Některé služby zpracovávají osobní údaje ve třetích zemích. Svým souhlasem přijímáš i tento přenos. Další informace najdeš v našich zásadách ochrany osobních údajů.
Na našem webu používáme soubory cookie a podobné technologie k personalizaci obsahu, vkládání externích médií a lepšímu pochopení využívání jednotlivých částí webu.
Nezbytné soubory cookie
Tyto záznamy zajišťují základní funkce, jako je zabezpečení, stabilita a zpracování formulářů.
Volitelné sekce
AnalytikaMarketingPřizpůsobeníExterní média
Zpracování údajů může probíhat na základě tvého souhlasu nebo oprávněného zájmu. V nastavení cookies můžeš každou volitelnou kategorii odmítnout nebo ji jednotlivě povolit.
Některé služby zpracovávají osobní údaje ve třetích zemích. Svým souhlasem přijímáš i tento přenos. Další informace najdeš v našich zásadách ochrany osobních údajů.
Svůj výběr můžeš kdykoli později znovu otevřít a upravit. · 1.0.3
Instalace závislostí
Panel potřebuje PHP 8.2 nebo 8.3 (doporučujeme 8.3) s několika rozšířeními, databázi (MariaDB nebo MySQL), Redis, webový server (použijeme Nginx) a také curl, tar, unzip, git a Composer. Spusť příkazy pro svou distribuci.
Ubuntu 24.04
V Ubuntu 24.04 jsou PHP 8.3, MariaDB a Redis už dostupné ve výchozích repozitářích balíčků. Nemusíš tedy přidávat žádné další repozitáře:
Ubuntu 22.04 obsahuje pouze PHP 8.1. Nejdřív proto přidej repozitář PHP od Ondřeje Surého a oficiální repozitář Redis a potom nainstaluj všechny balíčky:
Zkopíruj ukázkovou konfiguraci, nainstaluj závislosti PHP a vygeneruj klíč aplikace:
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
Pozor
Záloha APP_KEY
Hodnota APP_KEY v souboru .env šifruje všechna citlivá data Panelu, například klíče API. Pokud ji ztratíš, tato data už nebude možné přečíst ani ze zálohy databáze. Zobraz si ji příkazem a ulož ji na bezpečné místo mimo server, například do správce hesel.
Nastavení úlohy cron a pracovníka fronty
Panel na pozadí provádí mnoho úloh, například naplánované úlohy, odesílání e-mailů a úklid. K tomu potřebuješ úlohu cron a pracovníka fronty.
Úloha cron
Otevři crontab příkazem sudo crontab -e a přidej tento řádek. Spustí plánovač Panelu každou minutu:
Ulož soubor pomocí STRG + X, potom stiskni a . Pak aktivuj Redis a pracovníka fronty, aby se oba automaticky spouštěli i po restartu:
Nastavení webového serveru a SSL
Aby ses k Panelu dostal přes vlastní doménu s HTTPS, nastav teď DNS, certifikát SSL a Nginx.
Vytvoření záznamu DNS
U svého poskytovatele domény vytvoř záznam A, který bude směřovat na IP adresu serveru, například panel.example.com. Pokud máš doménu u ZAP-Hosting, pomůže ti náš návod k záznamům domény. Může chvíli trvat, než se záznam rozšíří po celém světě.
Vytvoření certifikátu SSL pomocí Certbotu
Nainstaluj Certbot s pluginem pro Nginx a vytvoř certifikát. Nahraď panel.example.com svou doménou:
Certbot ověřuje doménu přes port 80. Tento port proto musí být dostupný z internetu. Více informací o Certbotu najdeš v našem návodu Nastavení Certbotu na Linux serveru.
Balíček Certbot obnovuje certifikáty automaticky. Aby Nginx a Wings načetly také obnovený certifikát, můžeš do crontabu (sudo crontab -e) přidat tento řádek:
Vlož tuto konfiguraci a na všech čtyřech místech nahraď panel.example.com svou doménou:
Instalace Wings
Wings je služba, která skutečně spouští tvoje herní servery. Můžeš ji nainstalovat na stejný server jako Panel, nebo na další servery, které pak v Panelu přidáš jako další nody.
Instalace Dockeru
Wings spouští každý herní server v kontejneru Docker. Nainstaluj Docker CE pomocí oficiálního instalačního skriptu a aktivuj službu:
Debian 13 obsahuje ve výchozím nastavení PHP 8.4, které Pterodactyl oficiálně nepodporuje. PHP 8.3 proto nainstaluješ z repozitáře Sury. MariaDB a Redis nainstaluješ přímo z repozitářů Debianu, bez dalších repozitářů:
Následujícími příkazy nastavíš relace, mezipaměť, připojení k databázi a odesílání e-mailů. Příkazy se tě interaktivně zeptají na příslušné hodnoty:
bash
php artisan p:environment:setup
php artisan p:environment:database
# Optional: Mailversand einrichten ("smtp" für einen eigenen Mailserver)
php artisan p:environment:mail
Na výzvu k zadání Application URL zadej budoucí adresu svého Panelu, například https://panel.example.com. U databáze použij 127.0.0.1, název databáze panel, uživatele pterodactyl a heslo, které jsi před chvílí nastavil. Pro mezipaměť, relace a frontu můžeš vybrat Redis.
Naplnění databáze
Panel teď vytvoří své tabulky a naimportuje dodané Nests a Eggs (šablony pro jednotlivé hry):
bash
php artisan migrate --seed --force
Informace
Počkej prosím
Může to trvat několik minut. Proces nepřerušuj, jinak databáze nebude kompletní.
Vytvoření prvního správce
Vytvoř svůj správcovský účet. Heslo musí mít alespoň 8 znaků, obsahovat velká i malá písmena a alespoň jednu číslici:
bash
php artisan p:user:make
Na otázku, zda má být uživatel správcem, odpověz yes.
Nastavení oprávnění
Aby Nginx a PHP měly přístup k souborům, předej je uživateli webového serveru:
Nginx se s touto konfigurací spustí pouze v případě, že už existuje certifikát SSL. Nejdřív ho proto vytvoř pomocí Certbotu.
Konfigurace Nginxu bez SSL
Pokud chceš Panel jen otestovat a zatím nepoužívat doménu s certifikátem, můžeš místo toho použít tuto jednodušší konfiguraci v souboru /etc/nginx/sites-available/pterodactyl.conf. Nahraď panel.example.com svou doménou nebo IP adresou serveru a také nejdřív smaž soubor /etc/nginx/sites-enabled/default:
Teď v prohlížeči otevři https://panel.example.com a přihlas se pomocí správcovského účtu, který jsi před chvílí vytvořil. Obecné informace o Nginxu najdeš v našem návodu Nastavení Nginxu a Apache na Linux serveru.
Otevři v Panelu vpravo nahoře správcovskou část (ikona ozubeného kola).
V části Locations vytvoř pomocí Create New umístění, například se zkratkou de1.
Přejdi do části Nodes a klikni na Create New.
Zadej název, vyber umístění a jako FQDN zadej doménu serveru. Pokud Wings běží na stejném serveru jako Panel, můžeš použít stejnou doménu, například panel.example.com.
Pokud Panel používá HTTPS, u položky Communicate Over SSL vyber možnost Use SSL Connection. Node pak také potřebuje platný certifikát pro svůj FQDN.
U položek Total Memory a Total Disk Space zadej, kolik RAM a místa na disku může Wings přidělit herním serverům. Ponech část prostředků jako rezervu pro samotný systém.
Ponech Daemon Port nastavený na 8080 a Daemon SFTP Port na 2022 a node ulož.
Pak node otevři a přejdi na kartu Configuration. Klikni na Generate Token a spusť zobrazený příkaz na serveru. Soubor /etc/pterodactyl/config.yml se vytvoří automaticky. Případně můžeš obsah bloku kódu ručně zkopírovat do tohoto souboru.
Test Wings
Jednou spusť Wings v režimu ladění, abys případné chyby viděl hned:
bash
sudo wings --debug
Pokud Wings běží bez chyb a u nodu se v Panelu v části Nodes zobrazuje zelené srdce, ukonči test stisknutím STRG + C.
Nastavení Wings jako služby
Aby Wings běžel trvale na pozadí, vytvoř službu systemd:
Alokace je kombinace IP adresy a portu, kterou přiřadíš hernímu serveru. Každý server potřebuje alespoň jednu. IP adresu serveru zjistíš příkazem:
bash
hostname -I | awk '{print $1}'
Otevři svůj node ve správcovské části, přejdi na kartu Allocation a pod položkou Assign New Allocations zadej IP adresu a požadované porty, například 25565-25570 pro Minecraft. Jako alokaci nikdy nepoužívej 127.0.0.1.