Instalar el panel Pterodactyl mediante script

Esta guía le enseñará a instalar Pterodactyl Panel y Wings en su VPS mediante el script de instalación automática simplificado. Pterodactyl es un panel de gestión gratuito y de código abierto para administrar sus servidores de juegos (Minecraft, FiveM, etc.).

📋 Requisitos previos

• Un servidor VPS con acceso root
• Mínimo 1 GB de RAM (2 GB recomendados)
• Ubuntu 22.04/24.04, Debian 11/12/13, Rocky Linux 8/9 o AlmaLinux 8/9
• Un dominio apuntando a la IP de su VPS (opcional pero recomendado)
• Puertos 80, 443, 2022 y 8080 abiertos (si usa un firewall)

💡 Recomendación de infraestructura

Pterodactyl Panel es ideal para gestionar servidores de juegos que consumen muchos recursos. Para un rendimiento óptimo, recomendamos nuestros VPS High Performance, que ofrecen procesadores de alto rendimiento y RAM DDR5, perfectos para alojar varios servidores de juegos simultáneamente (Minecraft, FiveM, etc.).

🚀 Instalación del panel Pterodactyl

Preparación del servidor

Antes de instalar Pterodactyl, prepare su 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

Instalación mediante script simplificado

El script de instalación automática simplifica mucho la instalación de Pterodactyl:

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

El script le guiará paso a paso durante la instalación:

1. Selección del tipo de instalación:

   • Instalación del panel (Pterodactyl Panel)
   • Instalación de Wings (daemon para gestionar servidores)
   • Instalación completa (Panel + Wings)

2. Configuración del sistema:

   • Instalación automática de dependencias (PHP, MySQL, Nginx, etc.)
   • Configuración de la base de datos
   • Configuración del servidor web (Nginx)
   • Configuración SSL (Let's Encrypt)

Instalación solo del panel

Si desea instalar solo el Panel (para gestionar 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

Instalación completa (Panel + Wings)

Para instalar el Panel y Wings en el mismo 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

⚙️ Configuración del panel

Configuración inicial

Tras instalar el Panel, deberá configurar:

1. Crear una cuenta de administrador:

   • El script le pedirá crear el primer usuario admin
   • Elija un correo y una contraseña segura

2. Configuración de la base de datos:

   • El script creará automáticamente una base de datos MySQL
   • Anote las credenciales de la base de datos

3. Configuración del dominio:

   • Si tiene un dominio, el script configurará Nginx automáticamente
   • De lo contrario, puede acceder mediante la IP del servidor

Acceder al panel

Una vez completada la instalación, acceda al 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

🛠️ Instalación de Wings (daemon)

Wings es el daemon que gestiona realmente los servidores de juegos. Puede instalarlo en el mismo servidor que el Panel o en un servidor separado.

Instalar Wings en el mismo 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 en un servidor separado

Si instala Wings en un servidor distinto del 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

Configuración de Wings

Tras la instalación, deberá configurar Wings:

1. Obtener la clave API:

   • Inicie sesión en el Panel
   • Vaya a Administration → Configuration → Nodes
   • Cree un nuevo nodo o use el existente
   • Copie la clave API y el FQDN

2. Configurar 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 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

🔧 Configuración del firewall (UFW)

Si usa UFW, configure los puertos necesarios:

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

📝 Configuración posterior a la instalación

Verificar la instalación

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

Actualizar Pterodactyl

Para actualizar el Panel o 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 útiles de 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

🎮 Crear su primer servidor

En el panel Pterodactyl

1. Crear un usuario:

   • Vaya a Users → New User
   • Cree una cuenta para usted (si aún no lo ha hecho)

2. Crear un servidor:

   • Haga clic en "Create a new server"
   • Seleccione un nodo (su Wings)
   • Elija un egg (Minecraft, FiveM, etc.)
   • Configure recursos (RAM, CPU, disco)
   • Establezca el nombre y la descripción

3. Iniciar el servidor:

   • Una vez creado, haga clic en su servidor
   • Haga clic en "Power" → "Start" para iniciar

✅ Verificación y pruebas

Verificar que todo 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

Probar la conexión Panel → Wings

En el Panel:

1. Vaya a Administration → Nodes
2. Verifique que su nodo está en línea (estado verde)
3. Si el nodo está fuera de línea, compruebe la configuración de Wings

🆘 Solución de problemas

El panel no se muestra

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

Wings no 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

Error de conexión 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 datos

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;

Error SSL/HTTPS

Si tiene problemas con 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 adicionales

• Documentación oficial de Pterodactyl
• Documentación de Wings
• Pterodactyl GitHub
• Script de instalación
• Soporte Infrawire

❓ Preguntas frecuentes

P: ¿Puedo instalar el Panel y Wings en servidores separados?
R: Sí, incluso se recomienda para despliegues grandes. Instale el Panel en un servidor y Wings en uno o más servidores. Luego configure Wings para conectarse al Panel mediante la clave API.

P: ¿Cuál es la diferencia entre el Panel y Wings?
R: El Panel es la interfaz web para gestionar sus servidores. Wings es el daemon que se ejecuta en los servidores de juegos y gestiona realmente los contenedores Docker y los servidores de juegos.

P: ¿Puedo instalar Pterodactyl sin dominio?
R: Sí, puede usar la IP de su servidor, pero deberá configurar SSL manualmente o aceptar un certificado autofirmado. Se recomienda encarecidamente usar un dominio con Let's Encrypt.

P: ¿El script instala Docker automáticamente?
R: Sí, el script instala automáticamente Docker y Docker Compose, que son necesarios para Wings.

P: ¿Cómo actualizo Pterodactyl tras la instalación?
R: Relance el script de instalación. Detectará la instalación existente y ofrecerá una actualización:

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

P: ¿Puedo usar otro servidor web que no sea Nginx?
R: El script instala Nginx automáticamente. Puede usar Apache en su lugar, pero deberá configurarlo manualmente tras la instalación.

P: ¿Cuánta RAM se necesita para instalar Pterodactyl?
R: Mínimo 1 GB de RAM, pero se recomiendan 2 GB. Para gestionar servidores de juegos, necesitará RAM adicional según el número y tamaño de sus servidores.

P: ¿Cómo creo varios servidores de juegos?
R: Una vez configurados el Panel y Wings, puede crear tantos servidores como desee en el Panel. Cada servidor usará una parte de sus recursos (RAM, CPU, disco).

P: ¿Puedo usar Pterodactyl para servidores que no sean de juegos?
R: Sí, Pterodactyl puede gestionar cualquier contenedor Docker. Puede usarlo para aplicaciones web, bots de Discord, etc.