🎮 Instalar Pterodactyl en tu VPS LibraHost#

Instala Pterodactyl Panel y Wings en tu VPS LibraHost usando un script de instalación automático. ¡Gestiona fácilmente tus servidores de juegos (Minecraft, Garry's Mod, CS2, etc.) desde una interfaz web moderna!

🎯 Objetivo#

Preparar el VPS para la instalación
Instalar el Panel Pterodactyl (interfaz web de administración)
Instalar Wings (daemon que gestiona los servidores de juegos)
Configurar el firewall
Crear tu primer usuario administrador

🧰 Requisitos previos#

Un VPS LibraHost con mínimo 2 GB de RAM y 20 GB de almacenamiento
Un sistema operativo compatible:
- Ubuntu 22.04 o 24.04 (recomendado)
- Debian 10, 11, 12 o 13
- Rocky Linux 8 o 9
- AlmaLinux 8 o 9
Acceso root al VPS (vía SSH)
La dirección IPv4 de tu VPS

⚠️ Importante: Esta guía utiliza la dirección IPv4 del VPS sin certificado SSL. Para un entorno de producción con nombre de dominio y HTTPS, consulta la documentación oficial de Pterodactyl.

1️⃣ Preparación del VPS#

🔹 Conectarse por SSH#

ssh root@TU_IP_VPS

🔹 Actualizar el sistema#

apt update && apt upgrade -y

🔹 Instalar las dependencias básicas#

apt install -y curl wget sudo

2️⃣ Ejecutar el script de instalación#

🔹 Ejecutar el script automático#

Ejecuta el siguiente comando como root:

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

El script muestra un menú con varias opciones:

[0] Install the panel
[1] Install Wings
[2] Install both [0] and [1] on the same machine

🔹 Elegir la opción de instalación#

Opción	Descripción	Recomendación
0	Instala únicamente el Panel (interfaz web)	Si separas Panel y Wings en dos VPS
1	Instala únicamente Wings (daemon)	Para un nodo secundario
2	Instala el Panel Y Wings en la misma máquina	✅ Recomendado para empezar

💡 Recomendación: Para empezar, elige la opción 2 para instalar ambos componentes en el mismo VPS.

3️⃣ Configuración del Panel#

Después de elegir la opción, el script te hace varias preguntas:

🔹 Configuración de la base de datos#

Database name (panel): panel
Database username (pterodactyl): pterodactyl
Database password: TuContraseñaSegura

💡 Consejo: Usa una contraseña fuerte para la base de datos. ¡Anótala con cuidado!

🔹 Configuración de la zona horaria#

Select timezone: Europe/Madrid

🔹 Configuración del email#

Email address for the initial admin account: [email protected]

🔹 Configuración del usuario administrador#

Username (admin): admin
First name: Tu
Last name: Nombre
Password: TuContraseñaAdmin

⚠️ Importante: ¡Anota bien estas credenciales, las necesitarás para iniciar sesión en el panel!

🔹 Configuración del FQDN (nombre de dominio)#

Como usamos únicamente la IPv4:

FQDN (e.g panel.example.com): TU_IP_VPS

Simplemente introduce la dirección IP de tu VPS (ej.: 51.178.xxx.xxx).

🔹 Configuración SSL#

Do you want to configure Let's Encrypt automatically? (y/N): N

Responde N porque no usamos un nombre de dominio.

🔹 Configuración del firewall#

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

Responde y para configurar automáticamente el firewall.

4️⃣ Configuración de Wings#

Si elegiste la opción 2, el script continúa con la instalación de Wings:

🔹 Configuración del FQDN para Wings#

FQDN (e.g node.example.com): TU_IP_VPS

Introduce la misma dirección IP que para el panel.

🔹 Configuración SSL para Wings#

Do you want to configure Let's Encrypt automatically? (y/N): N

Responde N.

🔹 Configuración del firewall para Wings#

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

Responde y.

🔹 Configuración de la base de datos MySQL para los hosts#

Do you want to configure MySQL to be used by hosts? (y/N): y

Responde y si quieres que tus servidores de juegos puedan usar MySQL.

5️⃣ Finalizar la configuración de Wings#

Una vez completada la instalación, debes conectar Wings al Panel:

🔹 Acceder al panel#

Abre tu navegador y accede a:

http://TU_IP_VPS

Inicia sesión con las credenciales de administrador creadas anteriormente.

🔹 Crear una Location#

Ve a Admin (icono de engranaje arriba a la derecha)
Haz clic en Locations en el menú izquierdo
Haz clic en Create New
Rellena:
- Short Code: local
- Description: Servidor local
Haz clic en Create

🔹 Crear el Node#

Haz clic en Nodes en el menú izquierdo
Haz clic en Create New
Rellena la información:

Campo	Valor
Name	Node-01
Location	Servidor local
FQDN	TU_IP_VPS
Communicate Over SSL	❌ Desmarcado (HTTP)
Behind Proxy	❌ Desmarcado
Total Memory	RAM de tu VPS en MB (ej.: 4096)
Memory Over-Allocation	0
Total Disk Space	Espacio en disco en MB (ej.: 50000)
Disk Over-Allocation	0

Haz clic en Create Node

🔹 Obtener la configuración de Wings#

Haz clic en el nodo que acabas de crear
Ve a la pestaña Configuration
Haz clic en Generate Token
Copia el comando mostrado

🔹 Aplicar la configuración en el VPS#

De vuelta en tu terminal SSH, pega y ejecuta el comando copiado. Se parece a:

cd /etc/pterodactyl && sudo wings configure --panel-url http://TU_IP_VPS --token TU_TOKEN --node 1

🔹 Iniciar Wings#

sudo systemctl enable --now wings

Verifica que Wings está funcionando:

sudo systemctl status wings

6️⃣ Añadir allocations (puertos)#

Para crear servidores de juegos, debes asignar puertos:

En el panel, ve a Admin > Nodes
Haz clic en tu nodo
Ve a la pestaña Allocation
Rellena:
- IP Address: 0.0.0.0
- Ports: 25565-25575 (para Minecraft por ejemplo)
Haz clic en Submit

💡 Consejo: Puedes añadir varios rangos de puertos según tus necesidades (ej.: 27015-27020 para servidores Source).

7️⃣ Abrir puertos en el firewall#

Para cada rango de puertos asignado, ábrelos en UFW:

sudo ufw allow 25565:25575/tcp
sudo ufw allow 25565:25575/udp

Verifica el estado del firewall:

sudo ufw status

8️⃣ FAQ y problemas frecuentes#

¿Error "Wings is not connected"? Verifica que Wings está iniciado con systemctl status wings. Asegúrate de que el FQDN en el nodo corresponde a la IP del VPS.
¿No puedes acceder al panel? Verifica que los puertos 80 y 443 están abiertos (ufw allow 80/tcp). Verifica que nginx está funcionando (systemctl status nginx).
¿Los servidores de juegos no arrancan? Verifica que los puertos están asignados en el panel Y abiertos en el firewall. Consulta los logs con docker logs <container_id>.
¿Error de conexión a la base de datos? El script puede haberse ejecutado varias veces. Reinstala el sistema y ejecuta el script en un VPS recién instalado.
¿Cómo actualizar Pterodactyl? Consulta la documentación oficial en pterodactyl.io para las actualizaciones del panel y Wings.

✅ Conclusión#

¡Tu panel Pterodactyl está ahora instalado y listo para usar! Puedes crear tus primeros servidores de juegos desde la interfaz web. No olvides instalar los "Eggs" (plantillas de servidores) correspondientes a los juegos que quieras alojar. Para más información, consulta la documentación oficial de Pterodactyl.

Tema

Idioma

Documentación

Navegación