O que é Pterodactyl? Painel, Wings e instalação em VPS

O Pterodactyl é um painel gratuito e de código aberto para gerenciar servidores de jogos (Minecraft, Rust, FiveM e outros) por uma interface web. Ele se divide em duas peças: o Panel (PHP/Laravel) e o Wings, um daemon que executa cada servidor em um contêiner Docker isolado. Estamos falando do software, não do pterossauro.

Se você já administra um servidor em uma hospedagem, talvez tenha usado um painel desse tipo sem saber. Aqui você vê como o Pterodactyl funciona, o que é preciso para instalá-lo e como decidir entre montar tudo sozinho ou deixar isso com um provedor.

Em resumo

• O Pterodactyl é formado por um Panel (interface web, API, banco de dados) e pelo Wings (daemon que controla o Docker em cada máquina).
• Os "eggs" são as receitas que descrevem como instalar e iniciar cada jogo.
• O software é gratuito, sob licença MIT, mas o VPS, a manutenção e a segurança ficam por sua conta.
• O Wings exige um Linux capaz de rodar Docker: KVM não dá problema, já OpenVZ e LXC são para evitar.
• Para vários servidores ou revenda, um VPS com tudo pré-instalado poupa tempo. Para um ou dois servidores, um servidor gerenciado resolve.

Para que serve o Pterodactyl e para quem?

O Pterodactyl reúne todos os seus servidores de jogos em uma única interface, com acessos separados para cada pessoa. Chega de sessões SSH e pastas espalhadas: você cria um servidor em poucos cliques e cada admin vê só o que é da sua responsabilidade.

Três perfis costumam tirar proveito dele:

• uma comunidade que mantém um Minecraft survival, um criativo, um Rust e um bot de Discord, com moderadores diferentes em cada um;
• um revendedor ou micro-hospedeiro que aluga servidores para clientes;
• um time de eSports ou um grupo que quer manter o controle da própria infraestrutura.

O painel traz contas e subusuários com permissões, console em tempo real, gerenciador de arquivos, acesso SFTP, agendador de tarefas (reinício, backup), backups e um banco de dados por servidor.

Ele não serve para todo mundo, porém. Para um único servidor entre amigos, mexer com Linux, Docker e SSL é perda de tempo. Um servidor Minecraft pronto para uso coloca você no ar em menos de um minuto, sem digitar uma linha de comando.

Panel e Wings: qual é a diferença?

O Panel é o cérebro, o Wings é o braço. O primeiro exibe a interface e guarda a configuração. O segundo executa de fato os servidores.

O esquema cabe em uma linha: Panel ↔ Wings ↔ contêineres Docker (um por servidor de jogo).

Peça	Função	Tecnologias
Panel	Interface web, API, contas, configuração dos servidores	PHP/Laravel, front-end React, banco MariaDB ou MySQL, Redis (cache e filas)
Wings	Daemon instalado em cada máquina (node): inicia os contêineres e expõe o SFTP	Go, Docker

Um único Panel pode controlar vários nodes. Você distribui os servidores entre vários VPS ou dedicados sem sair da mesma interface. Para começar, Panel e Wings podem conviver no mesmo VPS, como a maioria das comunidades pequenas faz.

O Wings substituiu o antigo daemon em Node.js e é escrito em Go. A documentação oficial detalha a instalação.

Eggs e nests: as receitas de cada jogo

Um egg é um arquivo JSON que descreve como executar um jogo: imagem Docker, script de instalação, comando de inicialização, variáveis editáveis (versão, RAM, seed do mapa…) e detecção de que o servidor subiu. Os nests agrupam os eggs por família: Minecraft, Source Engine, Rust e assim por diante.

Alguns exemplos concretos: um egg Paper para Minecraft, um egg Rust com Oxide/uMod, um egg FiveM com txAdmin. O Pterodactyl traz alguns prontos, e a comunidade publica muitos outros em repositórios públicos.

A armadilha clássica é o egg de comunidade mal mantido. O jogo recebe uma atualização e a instalação ou a inicialização quebra. Antes de importar um egg, olhe a data da última atualização e leia os comentários mais recentes de quem o usou.

O Pterodactyl é gratuito?

Sim. O repositório oficial do Panel indica um projeto livre e de código aberto sob licença MIT, sem plano pago. O custo real está em outros lugares:

• o VPS ou servidor dedicado que hospeda tudo;
• um domínio, útil para o SSL (opcional, mas recomendado);
• o seu tempo: atualizações, correções de segurança, backups;
• eventualmente temas ou addons pagos de desenvolvedores terceiros.

Antes de começar, saiba que o ecossistema está em movimento. Na data em que este texto foi escrito, a branch estável continua sendo a 1.x (v1.15.2), enquanto o Pterodactyl 2.0 está em beta e não é recomendado em produção. Em um projeto novo, confira a página de instalação da branch que você pretende usar antes de decidir. Se o seu painel já está rodando, a 1.x estável segue sendo uma escolha razoável.

Qual VPS usar para instalar o Pterodactyl?

Dimensione o VPS pelos jogos, não pelo painel. O painel é leve: quem consome RAM, CPU e disco são os servidores de jogos.

Sistema operacional e virtualização

Segundo a documentação do Wings 1.x, os sistemas compatíveis são Ubuntu 22.04 e 24.04, Rocky Linux e AlmaLinux 8 e 9, e Debian 12 e 13. O Windows não é compatível. Para o Panel, a documentação da versão 2 recomenda o Ubuntu 24.04, que já traz o PHP 8.3.

Quanto à virtualização, a regra é simples: KVM funciona com certeza. Com OpenVZ, LXC ou Virtuozzo, o Wings pode não iniciar, a menos que o provedor tenha habilitado o suporte a Docker. Para verificar sua máquina:

systemd-detect-virt

Se a saída não contiver openvz nem lxc, você está em boa situação. Também é preciso ter acesso root.

Um VPS Windows, portanto, está fora de cogitação para o Pterodactyl. Ele continua útil para necessidades específicas do Windows, como certos servidores de jogos ou ferramentas, e é para isso que serve um VPS Windows.

CPU, RAM e armazenamento conforme seus servidores

O painel é leve: some à RAM dele a de cada servidor de jogo. O consumo varia bastante conforme plugins, mods e número de jogadores, então consulte a página de cada jogo para as recomendações.

Uso	Fator principal
Só o painel	consumo baixo
Minecraft Paper	plugins e número de jogadores
FiveM	resources instalados
Rust	número de jogadores e tamanho do mapa

Dois critérios pesam mais do que o número de núcleos. O primeiro é a frequência de um único núcleo: Minecraft e Rust dependem muito de uma thread principal, e um processador rápido faz mais diferença que um exército de núcleos lentos. O segundo é o NVMe, que acelera backups e o carregamento dos mapas.

Como exemplo, a linha Premium da Fly-Serv combina Ryzen 9 7950X3D, DDR5 e NVMe. É o perfil adequado para um servidor Rust com Oxide em 1 clique ou para vários servidores Minecraft na mesma máquina.

Portas a abrir para o Pterodactyl e o Wings

As portas padrão são conhecidas, mas cada porta de jogo depende do que você definir nas alocações do node.

Porta	Protocolo	Uso
80 / 443	TCP	Panel web, HTTPS via Let's Encrypt
8080	TCP	API do Wings (configurável)
2022	TCP	SFTP do Wings (configurável)
22	TCP	SSH de administração, a restringir aos seus IPs
25565	TCP (Java)	Minecraft por padrão
28015 / 28016	UDP / TCP	Rust por padrão (jogo / RCON)
30120	TCP e UDP	FiveM por padrão

As portas 8080 e 2022 também aparecem no exemplo de Docker Compose do repositório do Wings. Para as portas de jogo, siga o egg que você usa: elas mudam de um jogo para outro.

Outro erro frequente: se o seu painel está em HTTPS, o Wings também precisa ser acessível por HTTPS, com certificado válido no domínio dele. Sem isso, o painel mostra o node em vermelho e o console fica mudo. Desconfie também do Docker: as portas que ele publica podem passar por cima do UFW. Filtre pelo firewall do provedor ou pela chain DOCKER-USER.

Sobra a questão dos ataques. As portas de jogo em UDP são o alvo favorito dos DDoS nas noites de wipe ou de eventos. Um filtro na entrada muda tudo: na Fly-Serv, ele usa XDP/eBPF, com capacidade de 2 Tbit/s incluída nos VPS.

Instalar o Pterodactyl em um VPS: etapas e armadilhas

Esta é a visão geral, sem um tutorial completo. Reserve um bom tempo para uma primeira tentativa, sobretudo se você ainda não domina o SSH.

1. Atualize o sistema operacional.
2. Instale PHP, Composer, MariaDB (ou MySQL), Redis e um servidor web (Nginx, Apache ou Caddy).
3. Baixe o painel, configure o arquivo .env, execute as migrations do banco de dados e crie a conta de administrador.

Ajuste as permissões das pastas do painel (caminho padrão da instalação 1.x):

chown -R www-data:www-data /var/www/pterodactyl/
chmod -R 755 storage/* bootstrap/cache/

1. Configure o SSL com Let's Encrypt.
2. Instale o Docker e depois o Wings. No painel, crie o node e as alocações de portas, e cole na máquina a configuração gerada.
3. Importe os eggs e crie um primeiro servidor.

Para a versão 2.0 em beta, a documentação pede PHP 8.3 ou 8.4, MariaDB 10.11 ou 11 (ou MySQL 8 ou 9), Redis e Composer 2. Na 1.x, as versões exatas são diferentes: abra a página de instalação da sua branch antes de digitar o primeiro comando.

As armadilhas mais comuns:

• uma versão errada do PHP;
• permissões incorretas nas pastas do painel;
• SSL mal configurado entre o Panel e o Wings;
• porta 8080 bloqueada por um firewall;
• ausência de swap em um VPS pequeno;
• atualizações esquecidas, com o painel exposto na internet.

Existem scripts de instalação da comunidade que automatizam tudo isso. Costumam funcionar, mas você os executa como root: leia o código antes de rodar e teste primeiro em um VPS descartável.

Instalar por conta própria, VPS pré-instalado ou servidor gerenciado?

Depende do número de servidores e do tempo que você quer dedicar à administração.

Opção	Para quem	O que você gerencia
Instalação manual	Admin que quer controle total e aprender	Tudo: instalação, atualizações, segurança, eggs
VPS Pterodactyl pré-instalado	Vários servidores, revenda, comunidade estruturada	Os servidores e os eggs, sem a instalação do Panel nem do Wings
Servidor de jogo gerenciado via FlyPanel	1 ou 2 servidores, jogador ou equipe pequena	Apenas o jogo: mods em 1 clique, console, backups

O VPS Pterodactyl da Fly-Serv é voltado a quem prefere não montar a pilha por conta própria. Os detalhes da configuração oferecida (sistema, versão do painel, eggs fornecidos) estão na página da oferta.

Quanto ao orçamento, os preços dos VPS e servidores de jogos da Fly-Serv não têm fidelidade, com descontos de 5% a 20% conforme o período escolhido (3, 6 ou 12 meses). Se a sua dúvida é entre servidor com painel e VPS, este guia ajuda a escolher entre painel e VPS.

Perguntas frequentes

O que é o Pterodactyl e para que serve?

O Pterodactyl é um painel de código aberto para gerenciar servidores de jogos. Pela interface web, você cria, inicia, monitora e faz backup de servidores de Minecraft, Rust, FiveM e muitos outros, cada um isolado em um contêiner Docker. Ele serve a comunidades, revendedores e equipes que administram vários servidores.

Qual é a diferença entre o painel Pterodactyl e o Wings?

O painel é a interface web: contas, API, banco de dados, configuração dos servidores. O Wings é o daemon escrito em Go, instalado em cada máquina (node), que controla o Docker e expõe o SFTP. Um painel pode controlar vários nodes, e os dois podem rodar no mesmo VPS para começar.

O que é um egg do Pterodactyl?

Um egg é um arquivo JSON que descreve como instalar e iniciar um tipo de servidor: imagem Docker, script de instalação, comando de inicialização e variáveis editáveis. Os eggs ficam organizados em nests, por família de jogos. Antes de importar um egg da comunidade, confira a data da última atualização.

Que configuração de VPS é necessária para instalar o Pterodactyl?

Você precisa de um Linux compatível (Ubuntu, Debian, Rocky ou Alma), virtualização KVM compatível com Docker e acesso root. O painel consome pouca RAM; some a ela a RAM que cada servidor de jogo exigir. Um processador de alta frequência e NVMe contam mais do que o número de núcleos.

Quais portas abrir para o Pterodactyl e o Wings?

Abra 80 e 443 em TCP para o painel, 8080 para a API do Wings e 2022 para o SFTP (valores padrão, que podem ser alterados). Acrescente as portas de jogo definidas nas suas alocações, por exemplo 25565 para Minecraft ou 30120 para FiveM. Restrinja a porta 22 aos seus endereços IP.

O Pterodactyl é gratuito?

Sim, o software é de código aberto sob licença MIT e não tem versão paga. Você paga o VPS ou o dedicado, eventualmente um domínio e addons de terceiros, e investe tempo em manutenção. Se preferir não montar nada, o VPS Pterodactyl da Fly-Serv já vem pronto para uso.

Qual opção escolher para o seu próximo servidor?

Primeiro, conte quantos servidores você realmente administra. Depois, pense em quanto tempo quer gastar com Linux, SSL e Docker. Se você tem vários servidores ou revende hospedagem, o VPS Pterodactyl poupa a parte chata: dependências, Docker, portas, configuração do Wings. Você mantém hardware pensado para jogos (Ryzen 9 7950X3D, DDR5, NVMe), Anti-DDoS incluído nas portas de jogo, ausência de fidelidade e uma equipe acessível pelo Discord.

E se um único servidor basta, um servidor de jogo gerenciado via FlyPanel faz o trabalho sem nenhuma administração de sistema.