Pterodactyl: o que é e como instalá-lo num VPS
O painel Pterodactyl e o seu daemon Wings explicados, seguidos da instalação completa num VPS Debian ou Ubuntu: PHP, MariaDB, Redis, nginx, certbot, Docker
Aqui, Pterodactyl não é o réptil voador: é um painel open source para criar e gerir servidores de jogos a partir do browser. Este guia explica como funciona e que máquina exige, e depois instala-o passo a passo num VPS Ubuntu 24.04: o painel com PHP 8.3, MariaDB, Redis e nginx, o HTTPS com certbot e, por fim, o Wings e o Docker para correr os servidores. Os comandos seguem a documentação oficial do Pterodactyl e são executados como root.
- O Pterodactyl são dois programas: o painel web (PHP, MariaDB, Redis) e o Wings, que corre cada servidor de jogo num contentor Docker.
- Precisa de um VPS KVM com Ubuntu, Debian, Rocky ou AlmaLinux, de um domínio para o HTTPS e de 2 GB de RAM só para o painel.
- Com o Wings na mesma máquina, a RAM necessária é a do painel mais a de cada servidor de jogo.
- Guarde fora do VPS o ficheiro .env (APP_KEY), a base do painel e os volumes dos servidores.
O que é o Pterodactyl?
O Pterodactyl é um painel de gestão de servidores de jogos publicado sob licença MIT. É composto por dois programas: o painel, uma aplicação web em PHP que guarda contas, servidores e definições, e o Wings, um daemon escrito em Go que arranca cada servidor de jogo no seu próprio contentor Docker. Um painel pode controlar várias máquinas Wings, chamadas nós.
- O painel: interface web, API, base de dados MariaDB ou MySQL, cache e fila de tarefas no Redis.
- Wings: API do nó na porta 8080 e SFTP na porta 2022 por omissão, contentores Docker para os servidores.
- Os eggs: modelos de servidor (Minecraft Paper, Rust, ARK, bots e outros) que definem a imagem Docker, a instalação e o comando de arranque.
- Cada jogador ou cliente recebe acesso aos seus servidores: consola, ficheiros, cópias de segurança, tarefas agendadas e subutilizadores.
Requisitos: sistema, RAM e virtualização
A documentação oficial suporta Ubuntu 22.04 e 24.04, Debian 11, 12 e 13, bem como Rocky Linux e AlmaLinux 8 e 9. O painel precisa de PHP 8.2 ou 8.3, MariaDB 10.2 ou superior (ou MySQL 5.7.22 ou superior), Redis, um servidor web e Composer 2. O Wings precisa de Docker e de virtualização completa: o KVM funciona, o OpenVZ e o LXC dão problemas quase sempre.
- Verifique a virtualização com systemd-detect-virt: o resultado não pode conter openvz nem lxc. Os VPS da ACLClouds são máquinas KVM.
- RAM: o painel sozinho cabe em 2 GB. Com o Wings na mesma máquina, some a memória de cada servidor de jogo, por exemplo 4 GB para um servidor Minecraft Paper com cerca de dez jogadores.
- Para o HTTPS é preciso um domínio apontado para o IP do VPS; serve um subdomínio grátis em aclclouds.online.
- Para o painel e um ou dois servidores pequenos, o plano Mini (8 GB de RAM, 2 vCPU) chega; acima disso, o plano Essentiel (16 GB, 4 vCPU) dá margem. Veja os VPS Linux.
Instalar PHP, MariaDB, Redis e nginx
No Ubuntu 24.04, o PHP 8.3 vem do repositório ondrej/php. Atualize primeiro o sistema com apt update && apt -y upgrade e depois instale as dependências e o Composer. No Debian, a documentação oficial tem uma página própria com outro repositório PHP: siga-a em vez destes comandos.
- apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg
- LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php && 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
- curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
Descarregar o painel e criar a base de dados
O painel instala-se em /var/www/pterodactyl a partir do arquivo da última versão publicada no GitHub. Depois crie uma base de dados MariaDB e um utilizador usado apenas pelo painel, com uma palavra-passe longa e única.
- mkdir -p /var/www/pterodactyl && cd /var/www/pterodactyl
- 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/
- Em mariadb -u root -p: CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'palavraPasseUnica'; CREATE DATABASE panel; GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1';
- cp .env.example .env && COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
- php artisan key:generate --force: a chave APP_KEY cifra dados do painel. Copie-a para fora do servidor, porque sem ela não é possível restaurar.
Configurar o ambiente e criar o administrador
Três assistentes interativos preenchem o ficheiro .env: o endereço do painel e os drivers de cache, sessão e fila (escolha Redis), depois a ligação à base de dados e, por fim, o envio de e-mails. A migração cria então as tabelas e os eggs incluídos, e o último comando cria a primeira conta de administrador.
- php artisan p:environment:setup, depois php artisan p:environment:database e php artisan p:environment:mail
- php artisan migrate --seed --force: não o interrompa, a importação dos eggs demora um pouco.
- php artisan p:user:make: responda yes à pergunta de administrador.
- chown -R www-data:www-data /var/www/pterodactyl/*: os ficheiros pertencem ao utilizador do servidor web.
Ativar a tarefa agendada e a fila de tarefas
O painel precisa de uma tarefa cron que corra a cada minuto (limpeza, tarefas agendadas dos servidores) e de um worker que processe a fila do Redis. Sem o worker, a criação de servidores e os e-mails ficam bloqueados.
- crontab -e e depois a linha: * * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1
- Crie /etc/systemd/system/pteroq.service com User=www-data, Group=www-data, Restart=always e ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
- systemctl enable --now redis-server e depois systemctl enable --now pteroq.service
Configurar o nginx e o HTTPS com certbot
Primeiro, aponte um registo A do domínio, por exemplo panel.example.com, para o IPv4 do VPS. Obtenha depois o certificado com o plugin nginx do certbot e crie o bloco de servidor do painel a partir do modelo nginx com SSL da documentação oficial: root /var/www/pterodactyl/public, PHP enviado para o socket do PHP-FPM 8.3 e os caminhos do certificado obtido.
- apt -y install certbot python3-certbot-nginx e depois certbot certonly --nginx -d panel.example.com
- Em /etc/nginx/sites-available/pterodactyl.conf: server_name panel.example.com, ssl_certificate /etc/letsencrypt/live/panel.example.com/fullchain.pem e fastcgi_pass unix:/run/php/php8.3-fpm.sock.
- rm /etc/nginx/sites-enabled/default, ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/ e depois nginx -t && systemctl restart nginx
- A renovação é automática com o temporizador do certbot; teste-a com certbot renew --dry-run. O detalhe está no guia do certificado HTTPS grátis.
Instalar o Docker e o Wings e ligar o nó
O Wings pode correr no mesmo VPS que o painel ou noutra máquina. Instale o Docker com o script oficial e depois o binário do Wings. No painel, crie uma Location e depois um nó com o seu domínio, a opção SSL e a memória e o disco a partilhar. O separador Configuration do nó mostra o conteúdo do config.yml a copiar para /etc/pterodactyl.
- curl -sSL https://get.docker.com/ | CHANNEL=stable bash && systemctl enable --now docker
- mkdir -p /etc/pterodactyl && curl -L -o /usr/local/bin/wings https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64 && chmod u+x /usr/local/bin/wings
- Execute wings --debug uma primeira vez para ver os erros, depois crie o serviço wings.service (ExecStart=/usr/local/bin/wings, após docker.service) e ative-o com systemctl enable --now wings.
- Adicione allocations ao nó: o IP público indicado por hostname -I, nunca 127.0.0.1, e um intervalo de portas, por exemplo 25565-25600.
- O painel mostra um coração verde ao lado do nó quando o Wings responde; caso contrário, verifique o certificado e a porta 8080.
Proteger o painel e os nós
Um painel de jogos expõe uma interface de administração, uma API e portas de jogo: é um alvo. Abra apenas as portas necessárias, proteja as contas e faça cópias de segurança do que não se reinstala. As bases para reforçar um VPS estão no nosso guia de segurança Linux.
- Firewall: 22 (SSH), 80 e 443 para o painel, 8080 e 2022 para o Wings e depois as portas das allocations, em TCP e UDP conforme o jogo.
- Ative a autenticação de dois fatores nas contas de administrador e desative o acesso SSH por palavra-passe.
- Guarde cópias do ficheiro .env, da base panel (mysqldump panel) e dos dados dos servidores em /var/lib/pterodactyl/volumes, e copie-as para fora do VPS.
- Atualize o painel com php artisan p:upgrade e o Wings substituindo o binário, após uma cópia de segurança e seguindo as notas de versão.
Sem instalar nada: as opções da ACLClouds
Se quer o seu próprio painel sem passar por estes passos, o VPS Pterodactyl pré-configurado instala o painel, MariaDB, Redis, a fila de tarefas e o HTTPS a partir do seu domínio e das suas credenciais. O VPS Pterodactyl + Wings acrescenta Docker e Wings, com o nó, o seu config.yml e 100 allocations já criados. Em ambos os casos mantém o acesso root.
- Estas imagens custam o mesmo que os outros VPS: a instalação pré-configurada está incluída.
- Se só quer jogar, sem administrar um servidor, os nossos servidores de jogos funcionam no painel ACLClouds, construído sobre o Pterodactyl e o Wings: o servidor é entregue pronto, sem nada para instalar do seu lado.
Perguntas frequentes
O Pterodactyl é gratuito?
Sim. O painel e o Wings são publicados sob licença MIT, sem limite de servidores nem de utilizadores. Paga apenas a máquina onde correm.
Quanta RAM precisa o Pterodactyl?
O painel sozinho funciona com 2 GB. Se o Wings correr no mesmo VPS, some a memória de cada servidor de jogo: 8 GB chegam para um ou dois servidores pequenos, 16 GB para vários médios.
É possível instalar o Pterodactyl no Windows?
Não. O painel e o Wings foram feitos para Linux, e o Wings não funciona no Windows. Use um VPS Linux ou, para testes, uma máquina virtual Linux no seu PC.
O Pterodactyl precisa de um nome de domínio?
Para uso real, sim: o HTTPS do painel e a ligação segura entre o painel e o Wings dependem de um certificado associado a um nome. Um subdomínio grátis em aclclouds.online é suficiente.