Instalar o Pterodactyl Panel via script

Este guia ensina-o a instalar o Pterodactyl Panel e Wings no seu VPS usando o script de instalação automática simplificado. O Pterodactyl é um painel de gestão gratuito e open-source para gerir os seus servidores de jogos (Minecraft, FiveM, etc.).

📋 Pré-requisitos

• Um servidor VPS com acesso root
• Mínimo 1 GB de RAM (2 GB recomendados)
• Ubuntu 22.04/24.04, Debian 11/12/13, Rocky Linux 8/9 ou AlmaLinux 8/9
• Um domínio apontado para o IP do VPS (opcional mas recomendado)
• Portas 80, 443, 2022 e 8080 abertas (se usar firewall)

💡 Recomendação de infraestrutura

O Pterodactyl Panel é ideal para gerir servidores de jogos com uso intensivo de recursos. Para desempenho ótimo, recomendamos os nossos VPS High Performance, que oferecem processadores de alto desempenho e RAM DDR5, perfeitos para alojar vários servidores de jogos em simultâneo (Minecraft, FiveM, etc.).

🚀 Instalar o Pterodactyl Panel

Preparação do servidor

Antes de instalar o Pterodactyl, prepare o servidor:

Bash
1# Update the system
2sudo apt update && sudo apt upgrade -y
3
4# Install curl if necessary
5sudo apt install curl -y
6
7# Verify that you are root or use sudo
8whoami

Instalação via script simplificado

O script de instalação automática simplifica muito a instalação do Pterodactyl:

Bash
# Launch the Pterodactyl installation script
bash <(curl -s https://pterodactyl-installer.se)

O script irá guiá-lo passo a passo:

1. Seleção do tipo de instalação:

   • Instalação do Panel (Pterodactyl Panel)
   • Instalação do Wings (daemon para gerir servidores)
   • Instalação completa (Panel + Wings)

2. Configuração do sistema:

   • Instalação automática de dependências (PHP, MySQL, Nginx, etc.)
   • Configuração da base de dados
   • Configuração do servidor web (Nginx)
   • Configuração SSL (Let's Encrypt)

Instalar apenas o Panel

Se quiser instalar apenas o Panel (para gerir servidores):

Bash
1# Launch the script
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Choose option "1" to install the Panel
5# Follow the script instructions

Instalação completa (Panel + Wings)

Para instalar o Panel e Wings no mesmo servidor:

Bash
1# Launch the script
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Choose option "3" for complete installation
5# Follow the script instructions

⚙️ Configuração do Panel

Configuração inicial

Após a instalação do Panel, terá de configurar:

1. Criar uma conta de administrador:

   • O script pedirá para criar o primeiro utilizador admin
   • Escolha um email e uma palavra-passe segura

2. Configuração da base de dados:

   • O script criará automaticamente uma base de dados MySQL
   • Anote as credenciais da base de dados

3. Configuração do domínio:

   • Se tiver um domínio, o script configurará automaticamente o Nginx
   • Caso contrário, pode aceder via IP do servidor

Aceder ao Panel

Quando a instalação estiver concluída, aceda ao Panel:

Bash
1# If you configured a domain
2https://your-domain.com
3
4# If you don't have a domain
5http://YOUR_SERVER_IP

🛠️ Instalar o Wings (Daemon)

O Wings é o daemon que gere efetivamente os servidores de jogos. Pode instalá-lo no mesmo servidor que o Panel ou num servidor separado.

Instalar Wings no mesmo servidor

Bash
1# Launch the script
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Choose option "3" for complete installation
5# Or option "2" if you already installed the Panel

Instalar Wings num servidor separado

Se instalar o Wings num servidor diferente do Panel:

Bash
1# On the server where you want to install Wings
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Choose option "2" to install Wings only
5# Follow the script instructions

Configuração do Wings

Após a instalação, terá de configurar o Wings:

1. Obter a chave API:

   • Inicie sessão no Panel
   • Aceda a Administration → Configuration → Nodes
   • Crie um novo nó ou use o existente
   • Copie a chave API e o FQDN

2. Configurar o Wings:

   Bash
   1# Edit the Wings configuration file
   2sudo nano /etc/pterodactyl/config.yml
   3
   4# Paste the API key and FQDN from the Panel
   5# Save and quit (Ctrl+X, then Y, then Enter)

3. Iniciar o Wings:

   Bash
   1# Start the Wings service
   2sudo systemctl start wings
   3
   4# Enable Wings on boot
   5sudo systemctl enable wings
   6
   7# Verify status
   8sudo systemctl status wings

🔧 Configuração do firewall (UFW)

Se usar UFW, configure as portas necessárias:

Bash
1# Allow ports for Pterodactyl Panel
2sudo ufw allow 80/tcp
3sudo ufw allow 443/tcp
4
5# Allow Wings port (default 8080)
6sudo ufw allow 8080/tcp
7
8# Allow Wings SFTP port (default 2022)
9sudo ufw allow 2022/tcp
10
11# Verify rules
12sudo ufw status

📝 Configuração pós-instalação

Verificar a instalação

Bash
1# Verify that the Panel works
2curl -I http://localhost
3
4# Verify that Wings works
5sudo systemctl status wings
6
7# Check Wings logs
8sudo journalctl -u wings -f

Atualizar o Pterodactyl

Para atualizar o Panel ou Wings:

Bash
1# Relaunch the installation script
2bash <(curl -s https://pterodactyl-installer.se)
3
4# Choose the update option
5# The script will detect the existing installation and offer an update

Comandos úteis do Wings

Bash
1# Restart Wings
2sudo systemctl restart wings
3
4# Stop Wings
5sudo systemctl stop wings
6
7# View logs in real-time
8sudo journalctl -u wings -f
9
10# Reload Wings configuration without restarting
11sudo wings --debug

🎮 Criar o seu primeiro servidor

No Pterodactyl Panel

1. Criar um utilizador:

   • Aceda a Users → New User
   • Crie uma conta para si (se ainda não o fez)

2. Criar um servidor:

   • Clique em "Create a new server"
   • Selecione um nó (o seu Wings)
   • Escolha um egg (Minecraft, FiveM, etc.)
   • Configure recursos (RAM, CPU, disco)
   • Defina o nome e a descrição

3. Iniciar o servidor:

   • Uma vez criado, clique no seu servidor
   • Clique em "Power" → "Start" para iniciar

✅ Verificação e testes

Verificar se tudo funciona

Bash
1# Verify the Panel (should return HTTP 200)
2curl -I http://localhost
3
4# Verify Wings
5sudo systemctl status wings
6
7# Verify required services
8sudo systemctl status nginx
9sudo systemctl status mysql
10sudo systemctl status redis

Testar ligação Panel → Wings

No Panel:

1. Aceda a Administration → Nodes
2. Verifique se o seu nó está online (estado verde)
3. Se o nó estiver offline, verifique a configuração do Wings

🆘 Resolução de problemas

O Panel não é exibido

Bash
1# Verify that Nginx works
2sudo systemctl status nginx
3
4# Check Nginx logs
5sudo tail -f /var/log/nginx/error.log
6
7# Restart Nginx
8sudo systemctl restart nginx
9
10# Verify Nginx configuration
11sudo nginx -t

O Wings não arranca

Bash
1# Check Wings logs
2sudo journalctl -u wings -n 50
3
4# Check configuration file
5sudo nano /etc/pterodactyl/config.yml
6
7# Verify configuration syntax
8sudo wings --debug
9
10# Verify that port 8080 is free
11sudo netstat -tlnp | grep 8080

Erro de ligação Panel → Wings

Bash
1# Verify API key in config.yml
2sudo cat /etc/pterodactyl/config.yml | grep -i "api\|token"
3
4# Verify that FQDN is correct
5sudo cat /etc/pterodactyl/config.yml | grep -i "remote"
6
7# Verify network connectivity
8curl -I https://YOUR_PANEL_DOMAIN
9
10# Restart Wings
11sudo systemctl restart wings

Problema de base de dados

Bash
1# Verify that MySQL works
2sudo systemctl status mysql
3
4# Connect to MySQL
5sudo mysql -u root -p
6
7# In MySQL, list databases
8SHOW DATABASES;
9
10# Verify that pterodactyl database exists
11USE pterodactyl;
12SHOW TABLES;

Erro SSL/HTTPS

Se tiver problemas com SSL:

Bash
1# Verify Certbot
2sudo certbot --version
3
4# Renew SSL certificate
5sudo certbot renew
6
7# Verify Nginx SSL configuration
8sudo nginx -t
9sudo systemctl reload nginx

📚 Recursos adicionais

• Documentação oficial Pterodactyl
• Documentação Wings
• Pterodactyl GitHub
• Script de instalação
• Suporte Infrawire

❓ Perguntas frequentes

P: Posso instalar o Panel e Wings em servidores separados?
R: Sim, é até recomendado para implementações grandes. Instale o Panel num servidor e Wings noutro(s). Depois configure o Wings para se ligar ao Panel via chave API.

P: Qual é a diferença entre Panel e Wings?
R: O Panel é a interface web para gerir os seus servidores. O Wings é o daemon que corre nos servidores de jogos e gere efetivamente contentores Docker e servidores de jogos.

P: Posso instalar o Pterodactyl sem domínio?
R: Sim, pode usar o IP do servidor, mas terá de configurar SSL manualmente ou aceitar um certificado autoassinado. Recomenda-se fortemente usar um domínio com Let's Encrypt.

P: O script instala o Docker automaticamente?
R: Sim, o script instala automaticamente Docker e Docker Compose, necessários para o Wings.

P: Como atualizo o Pterodactyl após a instalação?
R: Relance o script de instalação. Detetará a instalação existente e oferecerá uma atualização:

Bash
bash <(curl -s https://pterodactyl-installer.se)

P: Posso usar outro servidor web que não o Nginx?
R: O script instala automaticamente o Nginx. Pode usar Apache, mas terá de configurar manualmente após a instalação.

P: Quanta RAM é necessária para instalar o Pterodactyl?
R: Mínimo 1 GB de RAM, mas 2 GB são recomendados. Para gerir servidores de jogos, precisará de RAM adicional consoante o número e tamanho dos servidores.

P: Como criar vários servidores de jogos?
R: Quando o Panel e Wings estiverem configurados, pode criar quantos servidores quiser no Panel. Cada servidor usará uma parte dos seus recursos (RAM, CPU, disco).

P: Posso usar o Pterodactyl para servidores que não sejam de jogos?
R: Sim, o Pterodactyl pode gerir qualquer contentor Docker. Pode usá-lo para aplicações web, bots Discord, etc.