Instalar Pterodactyl: guía completa del panel y Wings

Pterodactyl es una solución de código abierto que simplifica el alojamiento y la gestión de servidores de juegos. Su interfaz web intuitiva se comunica con un demonio llamado Wings para controlar sus instancias. Esta guía lo acompaña en la instalación completa: panel, Wings y configuración del Node.

Lo que necesita antes de comenzar

Prepare su entorno con los siguientes elementos:

Servidor compatible

• Ubuntu 20.04, 22.04 o 24.04
• Debian 10, 11 o 12

Acceso requerido

• Conexión root o usuario con derechos sudo
• Paquetes básicos instalados en el sistema

Comience actualizando su sistema:

apt update && apt upgrade -y

Luego, instale las dependencias esenciales:

apt install sudo curl

Implementar el panel de Pterodactyl

⚠️ Advertencia: El script de instalación es adecuado para uso privado. Para un entorno de producción público, prefiera una instalación manual.

Ejecute el script de instalación:

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

Seleccione la opción 0 para instalar el panel:

* Input 0-8: 0

Configuración de la base de datos

Acepte la instalación de MariaDB:

Would you like to install MariaDB (MySQL) server on the daemon as well? (y/N): y

Deje los campos de la base de datos vacíos: el script generará automáticamente una contraseña segura.

Configuración general

Establezca su zona horaria:

Select timezone [Europe/Stockholm]: Europe/Paris

Proporcione una dirección de correo electrónico válida para las notificaciones:

Provide the email address: [email protected]

Creación de la cuenta de administrador

Complete la información de la primera cuenta:

Email: [email protected]
Username: admin
First name: Admin
Last name: OuiHeberg
Password: *****

Dominio y seguridad

Especifique el nombre de dominio que apunta a su VPS:

Set the FQDN: panel.ouiheberg.com

Rechace la configuración automática del firewall para mantener el control:

Do you want to automatically configure UFW (firewall)? (y/N): n

Active el certificado SSL a través de Let's Encrypt:

Do you want to automatically configure HTTPS using Let's Encrypt? (y/N): y
I agree... (y/N): y

Confirme la instalación:

Initial configuration completed. Continue with installation? (y/N): y
(A)gree/(C)ancel: a

✅ El panel está operativo.

Instalar el demonio Wings

Vuelva a ejecutar el script de instalación:

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

Elija la opción 1 para Wings:

* Input 0-8: 1

Configuración de Wings

No reinstale MariaDB si ya está presente:

Would you like to install MariaDB... (y/N): n

Mantenga la configuración manual del firewall:

Do you want to automatically configure UFW (firewall)? (y/N): n

Configure HTTPS para asegurar las comunicaciones:

Do you want to automatically configure HTTPS... (y/N): y
Set the FQDN: node.ouiheberg.com
I agree... (y/N): y
Enter email address: [email protected]
Proceed with installation? (y/N): y

✅ Wings está listo.

Vincular el Node al panel

Inicie sesión en su panel (por ejemplo: panel.ouiheberg.com).

Crear una ubicación

Vaya a Locations y agregue una nueva ubicación. El nombre es libre: se utiliza para organizar sus nodos por zona geográfica o uso.

Agregar el Node

En Nodes, haga clic en Create New y complete los campos:

Parámetro	Descripción
Name	Nombre que identifica el node
FQDN	Dominio o IP del servidor Wings
Conexión	HTTPS si SSL está activo, HTTP de lo contrario
Total Memory	Memoria asignada (por ejemplo, 1024 para 1 GB)
Total Disk Space	Espacio en disco disponible
Over-Allocation	Porcentaje de sobreasignación permitido (0 si no se desea)

Finalizar la conexión

Después de la creación, abra la pestaña Configuration del Node. Genere un token y copie el comando mostrado.

Ejecute este comando en su VPS a través de SSH, luego active Wings:

systemctl enable --now wings
systemctl start wings

Resolver problemas comunes

Síntoma	Causa probable	Solución
Panel inaccesible	DNS mal propagado o FQDN incorrecto	Verificar la configuración DNS
Node desconectado	Puertos bloqueados por el firewall	Abrir los puertos 8080 y 2022
Wings se niega a iniciar	Certificado SSL inválido	Consultar los registros: journalctl -u wings
Error de base de datos	MariaDB inactivo o mal configurado	Verificar: systemctl status mariadb
Fallo en SSL	El dominio no apunta al VPS	Corregir el registro DNS A

Recomendaciones de seguridad

Adopte estas buenas prácticas para una instalación duradera:

• Utilice nombres de dominio dedicados para el panel y cada node
• Active HTTPS sistemáticamente con un certificado válido
• Mantenga su sistema actualizado: apt update && apt upgrade -y
• Cree cuentas de usuario separadas en lugar de utilizar el admin a diario
• Planifique copias de seguridad regulares de la base de datos y los archivos de configuración

Para concluir

El script de instalación simplifica en gran medida la implementación de Pterodactyl, pero una configuración de red y SSL rigurosa sigue siendo esencial. Al seguir esta guía y las recomendaciones de seguridad, tendrá una plataforma sólida para alojar sus servidores de juegos.