ACLClouds
ACLClouds

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.