Esta es una guía escrita acerca de cómo instalar Pterodactyl y Blueprint utilizando el script de instalación “Pterodactyl Installer”; asumo que el lector tiene algunos conocimientos básicos de redes y Linux.

Este post está basado en este video y recomiendo ampliamente verlo, incluso subtitulado, para que vean el proceso. Yo simplemente lo he resumido en texto para que sea conveniente y agregué los pasos para instalar Blueprint.

Conocimientos previos

• Conocimientos basicos sobre como instalar y conectarse a Ubuntu Server 24 LTS por medio de SSH.

Requisitos previos

• IP local fija en la máquina.
• Registro DNS local para el dominio FQDN. Esto se puede conseguir con firewalls como OPNSense, PFsense, etc.

Instrucciones para el Panel y Wings

1. Instalar Ubuntu Server 24 LTS.
2. Acceder como root: sudo -i.
3. Ejecutar el instalador: bash <(curl -s https://pterodactyl-installer.se)
   1. Selecciona la opción 2 para instalar tanto el Panel como Wings.
   2. Rechaza las opciones de SSL y reglas de firewall (si es para uso local).
   3. Configura un dominio FQDN único y válido.
   4. Usa los nombres por defecto para la base de datos por conveniencia.
4. Finalizar instalación.
5. Configuración inicial:
   1. Abre el panel en tu navegador usando http://tu-dominio-FQDN
   2. Configura una “Location” (Ubicación).
   3. Configura el “Node” (Nodo) usando el mismo FQDN del panel como URL.
6. Configurar Wings:
   1. Ve a la terminal de root y copia el código generado en el panel para configurar Wings.
   2. Habilita el servicio: sudo systemctl enable wings
   3. Inicia el servicio: sudo systemctl start wings
   4. Verifica que todo funcione: sudo systemctl status wings

Instalación de Blueprint

1. Actualizar definiciones: sudo apt update.
2. Instalar dependencias: apt install -y zip unzip git curl wget.
3. Instalar NodeJS
   1. curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
   2. sudo apt install -y nodejs
4. Instalar Yarn globalmente: sudo npm i -g yarn.
5. Iniciar Yarn en la carpeta de Pterodactyl: cd /var/www/pterodactyl && sudo yarn
6. Descargar Blueprint
   • cd ~ && wget "$(curl -s https://api.github.com/repos/BlueprintFramework/framework/releases/latest | grep 'browser_download_url' | cut -d '"' -f 4)" -O release.zip
7. Instalar archivos (selecciona “replace All” si lo pregunta).
   • sudo mv release.zip /var/www/pterodactyl/release.zipcd /var/www/pterodactyl && sudo unzip release.zip
8. Configuración básica: touch /var/www/pterodactyl/.blueprintrc
9. ⚠️Esto es importante, llena el archivo con la configuración básica que puse abajo⚠️
10. Ejecutar instalador: sudo chmod +x blueprint.sh && sudo bash blueprint.sh

Configuración básica de Blueprint

PASO 9: Ejecuta esto para colocar la configuración básica en el archivo .blueprintrc:

Bash

echo \
'WEBUSER="www-data";
OWNERSHIP="www-data:www-data";
USERSHELL="/bin/bash";' >> /var/www/pterodactyl/.blueprintrc

Tips / Consejos

• Usa siempre sudo -i: Ubuntu requiere permisos de root para casi todas las operaciones relacionadas con el panel.
• Transferencia de archivos: Usa FileZilla mediante SSH para enviar tus archivos de Blueprint.
• Instalar extensiones: Mueve los archivos .blueprint a /var/www/pterodactyl y ejecuta:sudo blueprint -install nombre_extension.blueprint.
• Exponer los servidores al exterior: Una solución sencilla es utilizar playit.gg siempre y cuando tengas un tunnel agent dentro del mismo rango de red.

Desinstalación ⚠️

Eliminar Panel y/o Wings:

1. Ejecuta: bash <(curl -s https://pterodactyl-installer.se)
2. Selecciona la opción 6.
3. Sigue las instrucciones; permite desinstalar solo el panel, solo las wings o ambos.

Limpieza total de Base de Datos (DB Nuke):

Usa este script si necesitas borrar todo rastro de SQL para reiniciar el proceso desde cero:

Bash

set -e
echo "==> Deteniendo MySQL/MariaDB..."
sudo systemctl stop mysql || true
sudo systemctl stop mariadb || true
echo "==> Deshabilitando servicios..."
sudo systemctl disable mysql || true
sudo systemctl disable mariadb || true
echo "==> Eliminando paquetes y librerías..."
sudo apt-get update -y
sudo apt-get purge -y 'mysql-*' 'mariadb-*' 'percona-server*' 'galera-*' 'libmysql*' 'libmariadb*' || true
sudo apt-get autoremove -y --purge
sudo apt-get autoclean -y
echo "==> Eliminando directorios de datos y configuración..."
sudo rm -rf /var/lib/mysql
sudo rm -rf /etc/mysql
sudo rm -rf /var/log/mysql /var/log/mysql.*
sudo rm -rf /var/run/mysqld
echo "==> Liberando puerto 3306..."
sudo ss -ltnp | grep ':3306' || echo "Puerto libre."
echo "==> Proceso completado."

Referencias

• Pterodactyl Installer: GitHub
• Documentación de Blueprint: blueprint.zip
• Guía en Video: YouTube