Você decide que serviços podemos ativar para análise, personalização e conteúdos externos.
Utilizamos cookies e tecnologias semelhantes no nosso site para personalizar conteúdos, integrar conteúdos externos e compreender melhor a uso de cada área.
Cookies necessários
Estas entradas asseguram funções essenciais, como segurança, estabilidade e processamento de formulários.
Seções opcionais
AnálisesMarketingPersonalizaçãoMídia externa
O tratamento de dados pode basear-se no seu consentimento ou em interesses legítimos. Nas configurações de cookies, pode rejeitar ou permitir cada categoria opcional.
Alguns serviços processam dados pessoais em outros países. Ao dar seu consentimento, você também aceita essa transferência. Encontre mais informações em nossa Política de Privacidade.
Pode voltar a abrir e ajustar sua seleção a qualquer momento. · 1.0.2
Configurar o Pterodactyl em um servidor Linux – hospede seu próprio painel de servidores de jogos
Descubra como instalar o Pterodactyl Panel e o Wings no seu servidor Linux e gerenciar seus próprios servidores de jogos facilmente por uma interface web → Saiba mais
10 de novembro de 202614 min de leitura1 visualizações0 útil
Introdução
Pterodactyl é um painel gratuito e de código aberto que permite gerenciar servidores de jogos como Minecraft, Rust, ARK ou CS2 por uma interface web. Cada servidor de jogos é executado em seu próprio contêiner do Docker, isolado dos demais.
O Pterodactyl é composto por duas partes:
Panel – a interface web na qual você gerencia servidores, usuários e recursos (aplicação PHP com banco de dados e servidor web)
Wings – o serviço no servidor que inicia, interrompe e monitora os contêineres dos servidores de jogos
Neste guia, vamos mostrar passo a passo como instalar o Panel e o Wings no seu Servidor VPS ZapX ou servidor dedicado, configurar um domínio com SSL e criar seu primeiro servidor de jogos.
Preparação
Para usar o Pterodactyl, você precisa de um VPS ou servidor dedicado com Linux e acesso root via SSH. Saiba como se conectar ao seu servidor no nosso guia de primeiro acesso via SSH. É sua primeira vez usando a ZapX? Então confira primeiro as introduções sobre VPS e servidores dedicados.
Dica
Autenticação por chave SSH
Recomendamos usar uma chave SSH em vez de uma senha. Saiba como fazer isso no nosso guia Criar e usar chaves SSH.
Requisitos de hardware
O Panel é leve. Os recursos necessários dependem principalmente de quantos servidores de jogos você pretende executar pelo Wings. Para o Panel e o Wings no mesmo servidor, recomendamos:
Hardware
Mínimo
Recomendado
CPU
2 núcleos vCPU
4 núcleos vCPU ou mais
RAM
4 GB
8 GB ou mais
Espaço em disco
30 GB
100 GB ou mais
Sistemas operacionais compatíveis
De acordo com a documentação oficial do Pterodactyl, estes sistemas são compatíveis atualmente:
Sistema operacional
Versões
Observação
Ubuntu
22.04, 24.04
No 22.04, você precisa de um repositório PHP adicional
Debian
11, 12, 13
O PHP 8.3 vem do repositório Sury
Rocky Linux / AlmaLinux / RHEL
8, 9
Nomes de pacotes e caminhos diferentes; não abordados neste guia
Neste guia, você encontra os comandos para Ubuntu e Debian. O Panel não oferece mais suporte ao Ubuntu 20.04 e versões anteriores. Se for reinstalar o sistema, recomendamos usar o Ubuntu 24.04 ou o Debian 12.
Verificar a virtualização
O Wings precisa do Docker. O Docker funciona sem problemas em servidores baseados em KVM e em servidores dedicados, mas geralmente não funciona em contêineres OpenVZ ou LXC. Confira com o seguinte comando:
bash
systemd-detect-virt
A saída kvm ou none (servidor dedicado sem virtualização) é adequada. Se aparecer openvz ou lxc, normalmente você não poderá executar o Wings nesse servidor.
Atualizar o sistema
Atualize o sistema antes da instalação:
bash
apt update && apt upgrade -y
Firewall e portas
Se você estiver usando um firewall no servidor, estas portas precisam estar abertas:
Porta
Protocolo
Finalidade
80 e 443
TCP
Panel (HTTP/HTTPS) e verificação do certificado pelo Certbot
8080
TCP
API do Wings, usada pelo Panel para se comunicar com o Node
2022
TCP
Acesso SFTP aos arquivos dos servidores de jogos
Portas dos jogos
TCP/UDP
Portas das suas Allocations, por exemplo, 25565 para Minecraft
Com o UFW, por exemplo, você pode liberar as portas da seguinte forma. Libere o SSH primeiro, ou você poderá perder o acesso ao ativar o firewall:
O Docker cria regras próprias para as portas dos contêineres dos servidores de jogos. Por isso, muitas vezes essas portas continuam acessíveis mesmo que você não as tenha liberado no UFW. Portanto, não confie apenas no UFW para proteger as portas dos jogos.
FAQ
Perguntas frequentes
O Pterodactyl é um painel gratuito e de código aberto para gerenciar servidores de jogos. Ele é composto pelo Panel (interface web) e pelo Wings (serviço no servidor), que inicia cada servidor de jogos em seu próprio contêiner do Docker.
De acordo com a documentação oficial, Ubuntu 22.04 e 24.04, Debian 11, 12 e 13, além de Rocky Linux, AlmaLinux e RHEL 8 e 9. O Panel não oferece mais suporte ao Ubuntu 20.04 e versões anteriores.
O Panel precisa do PHP 8.2 ou 8.3; recomendamos o PHP 8.3. No Ubuntu 22.04 e no Debian, o PHP 8.3 vem de um repositório adicional. O Ubuntu 24.04 já inclui essa versão.
Para o Panel, as portas 80 e 443; para o Wings, a porta 8080 (API) e a porta 2022 (SFTP). Você também precisa liberar as portas de jogo das suas Allocations, por exemplo, a 25565 para Minecraft.
Feedback
Este artigo foi útil?
Sua opinião nos ajuda a definir prioridades e a melhorar os conteúdos.
0 de 0 As avaliações consideraram este artigo útil.
Ajuda personalizada
As instruções não são suficientes?
A nossa equipe de suporte da ZAP conhece seu produto — descreva brevemente seu problema e ajudaremos pessoalmente.
O Zappy conhece este guia e te responde direto no chat.
Navegação
Software
Baixar o Panel
Crie a pasta do Panel e acesse-a:
bash
mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
Baixe a versão mais recente, extraia os arquivos e defina as permissões das pastas storage/ e bootstrap/cache/:
Agora está tudo pronto para criar seu primeiro servidor de jogos:
Na área de administração, abra Servers e clique em Create New.
Dê um nome ao servidor e selecione o proprietário (por exemplo, sua conta de administrador).
Selecione o Node e uma Allocation disponível.
Defina a quantidade de CPU, RAM e espaço em disco que o servidor receberá.
Em Nest e Egg, selecione o jogo, por exemplo, Minecraft com Paper.
Clique em Create Server.
O Wings vai baixar a imagem apropriada do Docker e instalar o servidor. Depois, você o encontrará na visualização normal do Panel e poderá iniciá-lo, abrir o console e gerenciar os arquivos por lá.
Conclusão e recursos adicionais
Parabéns! Você instalou o Pterodactyl Panel e o Wings no seu servidor e agora pode gerenciar seus próprios servidores de jogos pela interface web. Estes recursos podem ajudar:
Observação: desde a versão 1.11, o Pterodactyl envia dados de uso anônimos (telemetria). Para saber como desativar esse recurso, consulte a seção “Additional Configuration” na documentação oficial.
Ainda tem dúvidas que não foram respondidas aqui? Nossa equipe de suporte está à sua disposição todos os dias — é só falar com a gente! 🙂
Hospedagem de servidores a partir de € 2,49 / mês, disponível imediatamente, com proteção DDoS incluída.
O Panel precisa do PHP 8.2 ou 8.3 (recomendamos o 8.3) com algumas extensões, um banco de dados (MariaDB ou MySQL), Redis, um servidor web (usaremos o Nginx), além de curl, tar, unzip, git e Composer. Execute os comandos correspondentes à sua distribuição.
Ubuntu 24.04
No Ubuntu 24.04, o PHP 8.3, o MariaDB e o Redis já estão disponíveis nos repositórios de pacotes padrão. Portanto, você não precisa adicionar repositórios:
O Ubuntu 22.04 inclui apenas o PHP 8.1. Por isso, primeiro adicione o repositório PHP do Ondřej Surý e o repositório oficial do Redis. Depois, instale todos os pacotes:
Copie o arquivo de configuração de exemplo, instale as dependências do PHP e gere a chave da aplicação:
bash
cp .env.example .env
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
# Nur bei einer Neuinstallation ausführen, nicht bei einem bestehenden Panel
php artisan key:generate --force
Atenção
Faça backup da APP_KEY
O valor APP_KEY no arquivo criptografa todos os dados confidenciais do Panel, como as chaves de API. Se você perdê-lo, esses dados não poderão mais ser lidos, mesmo com um backup do banco de dados. Exiba a chave com e guarde-a em um local seguro fora do servidor, por exemplo, no seu gerenciador de senhas.
Configurar o cronjob e o worker da fila
O Panel executa muitas tarefas em segundo plano, como tarefas agendadas, envio de e-mails e limpeza. Para isso, você precisa de um cronjob e de um worker da fila.
Cronjob
Abra o crontab com sudo crontab -e e adicione esta linha. Ela executa o agendador do Panel a cada minuto:
Para acessar o Panel pelo seu próprio domínio com HTTPS, agora você vai configurar o DNS, um certificado SSL e o Nginx.
Criar um registro DNS
No seu provedor de domínio, crie um registro A que aponte para o endereço IP do seu servidor, por exemplo, panel.example.com. Se o seu domínio estiver na ZAP-Hosting, consulte nosso guia sobre registros de domínio. Pode levar algum tempo até que o registro fique ativo no mundo todo.
Criar um certificado SSL com o Certbot
Instale o Certbot com o plugin do Nginx e crie o certificado. Substitua panel.example.com pelo seu domínio:
O Certbot verifica o domínio pela porta 80. Portanto, essa porta precisa estar acessível pela internet. Saiba mais sobre o Certbot no nosso guia Configurar o Certbot em um servidor Linux.
O pacote do Certbot renova os certificados automaticamente. Para que o Nginx e o Wings também carreguem os certificados renovados, você pode adicionar esta linha ao crontab (sudo crontab -e):
Crie um novo arquivo de configuração para o Panel:
bash
nano /etc/nginx/sites-available/pterodactyl.conf
Instalar o Wings
O Wings é o serviço que executa os seus servidores de jogos. Você pode instalá-lo no mesmo servidor que o Panel ou em outros servidores, que poderá adicionar ao Panel como Nodes extras.
Instalar o Docker
O Wings inicia cada servidor de jogos em um contêiner do Docker. Instale o Docker CE com o script de instalação oficial e ative o serviço:
# Paketlisten neu laden und Abhängigkeiten installieren
Debian 11 e 12
No Debian 11 e 12, o PHP 8.3 vem do repositório Sury, o Redis vem do repositório oficial do Redis e o MariaDB é instalado pelo script de configuração do MariaDB:
O Debian 13 inclui o PHP 8.4 por padrão, que não é oficialmente compatível com o Pterodactyl. Por isso, você vai obter o PHP 8.3 pelo repositório Sury. Instale o MariaDB e o Redis diretamente dos repositórios de pacotes do Debian, sem adicionar outros repositórios:
Depois, confira rapidamente se o PHP 8.3 está ativo:
bash
php -v
.env
grep APP_KEY /var/www/pterodactyl/.env
Configurar o ambiente
Use os comandos a seguir para configurar as sessões, o cache, a conexão com o banco de dados e o envio de e-mails. Os comandos vão solicitar os valores de forma interativa:
bash
php artisan p:environment:setup
php artisan p:environment:database
# Optional: Mailversand einrichten ("smtp" für einen eigenen Mailserver)
php artisan p:environment:mail
Quando solicitado, informe o endereço futuro do Panel em Application URL, por exemplo, https://panel.example.com. Para o banco de dados, use 127.0.0.1, o banco panel, o usuário pterodactyl e a senha que você definiu anteriormente. Para cache, sessões e fila, você pode selecionar o Redis.
Preencher o banco de dados
Agora o Panel vai criar as tabelas e importar os Nests e Eggs incluídos (os modelos para cada jogo):
bash
php artisan migrate --seed --force
Informações
Aguarde
Isso pode levar alguns minutos. Não interrompa o processo, ou o banco de dados ficará incompleto.
Criar o primeiro administrador
Crie sua conta de administrador. A senha deve ter pelo menos 8 caracteres, letras maiúsculas e minúsculas e pelo menos um número:
bash
php artisan p:user:make
Quando perguntado se o usuário deve ser administrador, responda yes.
Definir permissões
Para que o Nginx e o PHP possam acessar os arquivos, atribua-os ao usuário do servidor web:
bash
chown -R www-data:www-data /var/www/pterodactyl/*
Salve com STRG + X, depois Y e Enter. Em seguida, ative o Redis e o worker da fila para que ambos iniciem automaticamente após uma reinicialização:
Com essa configuração, o Nginx só inicia se o certificado SSL já existir. Portanto, crie-o com o Certbot antes de continuar.
Configurar o Nginx sem SSL
Se você quiser apenas testar o Panel e ainda não pretende usar um domínio com certificado, pode usar esta configuração mais simples em /etc/nginx/sites-available/pterodactyl.conf. Substitua panel.example.com pelo seu domínio ou pelo endereço IP do servidor e também remova antes o arquivo /etc/nginx/sites-enabled/default:
Agora, acesse https://panel.example.com no navegador e entre com a conta de administrador que você criou anteriormente. Encontre informações gerais sobre o Nginx no nosso guia Configurar o Nginx e o Apache em um servidor Linux.
No Panel, abra a área de administração pelo canto superior direito (ícone de engrenagem).
Em Locations, crie um local com Create New, por exemplo, usando a abreviação de1.
Acesse Nodes e clique em Create New.
Informe um nome, selecione a Location e, em FQDN, informe o domínio do servidor. Se o Wings estiver no mesmo servidor que o Panel, você pode usar o mesmo domínio, por exemplo, panel.example.com.
Em Communicate Over SSL, selecione Use SSL Connection se o Panel estiver usando HTTPS. Nesse caso, o Node também precisa de um certificado válido para o próprio FQDN.
Em Total Memory e Total Disk Space, informe a quantidade de RAM e espaço em disco que o Wings pode alocar para os servidores de jogos. Deixe uma margem para o próprio sistema.
Mantenha Daemon Port como 8080 e Daemon SFTP Port como 2022 e salve o Node.
Depois, abra o Node e acesse a aba Configuration. Clique em Generate Token e execute no servidor o comando exibido. Ele cria automaticamente o arquivo /etc/pterodactyl/config.yml. Como alternativa, copie manualmente o conteúdo do bloco de código para esse arquivo.
Testar o Wings
Inicie o Wings uma vez no modo de depuração para ver os erros diretamente:
bash
sudo wings --debug
Se o Wings estiver funcionando sem erros e o Node exibir um coração verde em Nodes no Panel, encerre o teste com STRG + C.
Configurar o Wings como serviço
Para manter o Wings em execução em segundo plano, crie um serviço do systemd:
Uma Allocation é uma combinação de endereço IP e porta que você atribui a um servidor de jogos. Cada servidor precisa de pelo menos uma. Descubra o endereço IP do seu servidor com:
bash
hostname -I | awk '{print $1}'
Na área de administração, abra o Node, acesse a aba Allocation e, em Assign New Allocations, informe o endereço IP e as portas desejadas, por exemplo, 25565-25570 para Minecraft. Nunca use 127.0.0.1 como Allocation.
Fonte preferida no Google
