Pterodactyl na VPS: painel para servidores de jogos
Instale o Pterodactyl Panel 1.15.2 e o Wings 1.13.4 numa VPS com Ubuntu 24.04, confira a virtualização, as portas e o SSL e saiba como atualizar.
Por Redação Eleven Host · @robson.direitodigital · 3 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: Pterodactyl na VPS: painel para servidores de jogos Arte: Eleven Host
O Pterodactyl na VPS é um painel web para criar e gerenciar servidores de jogos em contêineres Docker. Este guia segue a linha 1.x estável: Panel v1.15.2 e Wings v1.13.4, segundo as páginas de versões do projeto no GitHub.
A linha 2.0 está em beta aberto, e a documentação do projeto manda testar a atualização numa cópia antes. Os comandos abaixo usam versão fixa, porque a documentação avisa que o latest passará a apontar para a 2.0. Para entender o que é uma VPS antes de começar, veja o guia de servidor VPS para iniciantes.
O que é o Pterodactyl: Panel e Wings
Segundo a documentação oficial, o Panel é o site em que você gerencia usuários, nós e servidores. O Wings roda em cada nó e executa os servidores de jogos em contêineres Docker. Cada servidor roda no próprio contêiner, e os jogadores se conectam a ele direto, nas portas que você atribuir.
O Panel e o Wings podem rodar na mesma máquina. Para o Panel, a documentação da linha 1.x diz que ele foi feito para rodar no seu próprio servidor web e que é preciso ter acesso de administrador ao servidor.
O Panel é o site de gerenciamento; o Wings é o programa que, em cada nó, executa os servidores de jogos em contêineres Docker.
Requisitos oficiais da linha 1.x
Para o Panel, a documentação lista como compatíveis o Ubuntu 22.04 e 24.04, o RHEL, Rocky e AlmaLinux 8 e 9, e o Debian 11, 12 e 13. No Ubuntu 24.04, o MariaDB pode ser instalado sem o script de repositório. Este guia usa o Ubuntu 24.04 como exemplo.
- PHP 8.2 ou 8.3 (o 8.3 é o recomendado), com as extensões cli, openssl, gd, mysql, PDO, mbstring, tokenizer, bcmath, xml ou dom, curl e zip, e fpm se você usar o NGINX;
- MySQL 5.7.22 ou mais novo (o 8 é o recomendado) ou MariaDB 10.2 ou mais novo;
- Redis (
redis-server); - um servidor web, como Apache, NGINX ou Caddy;
- curl, tar, unzip e git;
- Composer v2.
O Wings também aceita Ubuntu 22.04 e 24.04, RHEL, Rocky e AlmaLinux 8 e 9, e Debian 11, 12 e 13. Segundo a documentação, ele não roda em Windows. Precisa de curl e Docker.
Virtualização: confira antes de instalar o Wings
A documentação do Wings avisa que, com virtualização Virtuozzo, OpenVZ (ou OVZ) ou LXC, você provavelmente não conseguirá rodar o Wings. Já o KVM funciona, segundo a própria página.
Recomendamos perguntar ao provedor qual virtualização a sua VPS usa antes de instalar. Para conferir pelo terminal, a documentação indica este comando:
systemd-detect-virt
Se o resultado não contiver OpenVZ nem LXC, deve ficar tudo bem. O resultado none aparece em hardware dedicado, sem virtualização. Outra checagem é o uname -r: se o kernel terminar em -xxxx-grs-ipv6-64 ou -xxxx-mod-std-ipv6-64, provavelmente é um kernel sem suporte, e o caminho é pedir ao provedor o kernel padrão da distribuição.
Procura o preço de uma VPS? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Passo 1: instalar as dependências do Panel
No Ubuntu 24.04, o PHP 8.3 já está nos repositórios (no 22.04 é preciso o repositório extra de PHP). Rode os comandos como administrador ou com sudo. Um exemplo de instalação dos pacotes, com a lista da documentação:
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
O Redis também tem um repositório próprio na documentação; siga a página oficial se quiser essa origem. Depois, instale o Composer:
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
Passo 2: baixar o Panel com versão fixa
A página de atualização do projeto avisa para não trocar a versão por latest: quando a 2.0 for publicada, o latest passa a apontar para ela. Por isso, em vez do endereço releases/latest, use a versão da linha 1.x. Confira a versão atual na página de releases do projeto no GitHub. Um exemplo com a 1.15.2:
mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/download/v1.15.2/panel.tar.gz
tar -xzvf panel.tar.gz
chmod -R 755 storage/* bootstrap/cache/
Crie o banco, no console do MariaDB como administrador. Troque a senha de exemplo por uma sua:
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'yourPassword';
CREATE DATABASE panel;
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
exit
Passo 3: configurar o Panel
Ainda na pasta do Panel, rode os comandos abaixo, um de cada vez. O key:generate é só da primeira instalação.
cp .env.example .env
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
php artisan key:generate --force
php artisan p:environment:setup
php artisan p:environment:database
php artisan p:environment:mail
php artisan migrate --seed --force
Guarde o APP_KEY fora do servidor
A documentação manda fazer backup da chave de criptografia, a variável APP_KEY do arquivo .env. Se você perder essa chave, os dados criptografados ficam permanentemente irrecuperáveis. Guarde uma cópia fora da VPS.
Crie o primeiro usuário administrador e ajuste o dono dos arquivos:
php artisan p:user:make
chown -R www-data:www-data /var/www/pterodactyl/*
O Panel precisa de um agendador. Abra o crontab com sudo crontab -e e acrescente:
* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1
Passo 4: fila, Redis e servidor web
A fila do Panel roda como serviço. Crie o arquivo /etc/systemd/system/pteroq.service com o conteúdo da documentação oficial (a descrição é Pterodactyl Queue Worker, e o comando é queue:work com as filas high, standard e low). Depois, ative os serviços. Para entender o systemctl, veja o guia systemctl: como iniciar, parar e ver serviços na VPS.
sudo systemctl enable --now redis-server
sudo systemctl enable --now pteroq.service
No NGINX, se for usar SSL, crie o certificado antes (o Certbot aparece logo abaixo). Remova o site padrão, grave a configuração do Panel (o conteúdo vem da documentação, trocando o domínio) em /etc/nginx/sites-available/pterodactyl.conf e ative:
rm /etc/nginx/sites-enabled/default
sudo ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf
sudo systemctl restart nginx
Atenção à ordem: a documentação avisa que, com a configuração de SSL, você precisa criar os certificados antes, ou o servidor web não inicia. Com o Certbot, um exemplo é:
sudo apt install -y certbot
sudo apt install -y python3-certbot-nginx
certbot certonly --nginx -d example.com
O desafio HTTP exige a porta 80 acessível para a verificação. A renovação pode ser agendada no crontab com certbot renew, como mostra a documentação.
Passo 5: instalar o Wings
O Wings precisa do Docker. O comando da documentação é este:
curl -sSL https://get.docker.com/ | CHANNEL=stable bash
sudo systemctl enable --now docker
Para o binário, fixe a versão como no Panel. Um exemplo para a arquitetura amd64, montado a partir do comando da documentação com a versão 1.13.4 (confira a versão atual na página de releases do Wings):
sudo mkdir -p /etc/pterodactyl
sudo curl -L -o /usr/local/bin/wings https://github.com/pterodactyl/wings/releases/download/v1.13.4/wings_linux_amd64
sudo chmod u+x /usr/local/bin/wings
Se a sua máquina for arm64, use o arquivo correspondente da página de releases; a documentação escolhe a arquitetura pelo uname -m.
Passo 6: criar o nó e colar a configuração
No Panel, crie o nó e abra a aba Configuration dele. Cole o conteúdo no arquivo /etc/pterodactyl/config.yml. A documentação também oferece o botão Generate Token, que gera um comando para colar no terminal.
Teste em primeiro plano. A primeira vez pode levar alguns minutos, e você sai com CTRL+C:
sudo wings --debug
Depois, crie o serviço em /etc/systemd/system/wings.service, com o conteúdo da documentação (descrição Pterodactyl Wings Daemon, depende do Docker e roda /usr/local/bin/wings), e ative:
sudo systemctl enable --now wings
Ao criar alocações, que combinam IP e porta, a documentação avisa para não usar 127.0.0.1. Para ver o IP da máquina, o comando indicado é hostname -I | awk '{print $1}'.
Portas e SSL em cada nó
Pela documentação, o navegador acessa o Panel na porta 443 (ou 80 sem SSL) e o Wings na 8080, para consoles e envio de arquivos. Clientes SFTP usam a 2022. O Panel precisa alcançar cada nó na 8080, e cada nó precisa alcançar o Panel. Essas portas podem ser mudadas por nó no Panel. Os jogadores se conectam nas portas que você atribuir a cada servidor.
Libere as portas no firewall que você usa. Para ver o que está escutando na máquina, veja o guia Portas abertas no Linux: como ver com ss e lsof na VPS. Um teste da documentação é rodar, no servidor do Panel, um curl para o endereço do nó na porta 8080.
Quando o Panel usa SSL, o Wings também precisa de um certificado para o seu FQDN. Ou seja, cada nó precisa do próprio certificado. Se a máquina só tem o Wings, a documentação mostra o Certbot com --standalone, depois de parar o servidor web.
Atualização e segurança
Ao atualizar o Panel, coloque-o em modo de manutenção, como manda a documentação. Os comandos oficiais da linha 1.x, com a versão fixa, são:
cd /var/www/pterodactyl
php artisan down
curl -L https://github.com/pterodactyl/panel/releases/download/v1.15.2/panel.tar.gz | tar -xzv
chmod -R 755 storage/* bootstrap/cache
composer install --no-dev --optimize-autoloader
php artisan view:clear
php artisan config:clear
php artisan migrate --seed --force
chown -R www-data:www-data /var/www/pterodactyl/*
php artisan queue:restart
php artisan up
Esses passos não servem para atualizar para a 2.0.
Avisos de segurança
A versão 1.15.2 do Panel é uma correção de segurança ligada ao PHP. A nota da versão pede atualizar o PHP para 8.2.35 ou 8.3.36 e atualizar os pacotes do PHP juntos, para quem não usa Docker. No Wings, a versão 1.13.1 corrigiu um aviso classificado como crítico, sobre identificadores de backup sem tratamento. O histórico de avisos do projeto mostra outros, e por isso recomendamos manter o Panel e o Wings nas versões atuais.
Resumo do caminho
A ordem é conferir a virtualização, instalar o Panel, criar o usuário administrador, instalar o Wings e conectar o nó.
Já consultou os preços de VPS da Eleven Host? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os preços
Perguntas frequentes
O Pterodactyl 2.0 já pode ser usado?
Está em beta aberto. A documentação diz para testar a atualização numa cópia antes. Este guia segue a linha 1.x, que é a estável.
A virtualização da VPS importa para o Wings?
Sim. Com OpenVZ, Virtuozzo ou LXC, o mais provável é que não rode. O KVM funciona, segundo a documentação.
Preciso instalar o Panel e o Wings na mesma máquina?
Não. Eles podem rodar na mesma máquina, mas o Wings roda em cada nó, e o Panel gerencia os nós.
Quais portas o Pterodactyl usa?
O Panel usa a 443 (ou 80 sem SSL), o Wings usa a 8080 e o SFTP usa a 2022. As duas últimas podem ser mudadas por nó.
O que acontece se eu perder o APP_KEY?
Os dados criptografados ficam permanentemente irrecuperáveis, segundo a documentação. Guarde uma cópia fora do servidor.