Base de Conhecimento

Pterodactyl na VPS: painel para servidores de jogos

  • pterodactyl, wings, vps, docker, servidor de jogos, ubuntu
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Pterodactyl na VPS: painel para servidores de jogos

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.

Esta resposta lhe foi útil?

Artigos Relacionados