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 Ryzen, 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.