Pterodactyl: qué es y cómo instalarlo en un VPS
El panel Pterodactyl y su demonio Wings explicados, y después la instalación completa en un VPS Debian o Ubuntu: PHP, MariaDB, Redis, nginx, certbot
Aquí Pterodactyl no es el reptil volador: es un panel de código abierto para crear y gestionar servidores de juegos desde el navegador. Esta guía explica cómo funciona y qué máquina necesita, y luego lo instala paso a paso en un VPS con Ubuntu 24.04: el panel con PHP 8.3, MariaDB, Redis y nginx, el HTTPS con certbot y, por último, Wings y Docker para ejecutar los servidores. Los comandos siguen la documentación oficial de Pterodactyl y se ejecutan como root.
- Pterodactyl son dos programas: el panel web (PHP, MariaDB, Redis) y Wings, que ejecuta cada servidor de juego en un contenedor Docker.
- Necesita un VPS KVM con Ubuntu, Debian, Rocky o AlmaLinux, un dominio para el HTTPS y 2 GB de RAM solo para el panel.
- Con Wings en la misma máquina, la RAM necesaria es la del panel más la de cada servidor de juego.
- Guarde fuera del VPS el archivo .env (APP_KEY), la base del panel y los volúmenes de los servidores.
¿Qué es Pterodactyl?
Pterodactyl es un panel de gestión de servidores de juegos publicado con licencia MIT. Consta de dos programas: el panel, una aplicación web en PHP que guarda cuentas, servidores y ajustes, y Wings, un demonio escrito en Go que arranca cada servidor de juego en su propio contenedor Docker. Un mismo panel puede controlar varias máquinas Wings, llamadas nodos.
- El panel: interfaz web, API, base de datos MariaDB o MySQL, caché y cola de tareas en Redis.
- Wings: API del nodo en el puerto 8080 y SFTP en el puerto 2022 por defecto, contenedores Docker para los servidores.
- Los eggs: plantillas de servidor (Minecraft Paper, Rust, ARK, bots y más) que definen la imagen Docker, la instalación y el comando de arranque.
- Cada jugador o cliente recibe acceso a sus servidores: consola, archivos, copias de seguridad, tareas programadas y subusuarios.
Requisitos: sistema, RAM y virtualización
La documentación oficial admite Ubuntu 22.04 y 24.04, Debian 11, 12 y 13, y Rocky Linux y AlmaLinux 8 y 9. El panel necesita PHP 8.2 u 8.3, MariaDB 10.2 o superior (o MySQL 5.7.22 o superior), Redis, un servidor web y Composer 2. Wings necesita Docker y virtualización completa: KVM funciona, mientras que OpenVZ y LXC dan problemas casi siempre.
- Compruebe la virtualización con systemd-detect-virt: la salida no debe contener openvz ni lxc. Los VPS de ACLClouds son máquinas KVM.
- RAM: el panel solo cabe en 2 GB. Si Wings va en la misma máquina, sume la memoria de cada servidor de juego, por ejemplo 4 GB para un servidor Minecraft Paper de unos diez jugadores.
- Para el HTTPS hace falta un dominio que apunte a la IP del VPS; sirve un subdominio gratuito en aclclouds.online.
- Para el panel y uno o dos servidores pequeños basta el plan Mini (8 GB de RAM, 2 vCPU); por encima, el plan Essentiel (16 GB, 4 vCPU) deja margen. Vea los VPS Linux.
Instalar PHP, MariaDB, Redis y nginx
En Ubuntu 24.04, PHP 8.3 viene del repositorio ondrej/php. Actualice primero el sistema con apt update && apt -y upgrade y luego instale las dependencias y Composer. Para Debian, la documentación oficial tiene una página propia con otro repositorio de PHP: sígala en lugar de estos comandos.
- apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg
- LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php && apt update
- apt -y install php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server
- curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
Descargar el panel y crear la base de datos
El panel se instala en /var/www/pterodactyl a partir del archivo de la última versión publicada en GitHub. Después cree una base de datos MariaDB y un usuario que solo use el panel, con una contraseña larga y única.
- mkdir -p /var/www/pterodactyl && cd /var/www/pterodactyl
- curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz && tar -xzvf panel.tar.gz && chmod -R 755 storage/* bootstrap/cache/
- En mariadb -u root -p: CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'contrasenaUnica'; CREATE DATABASE panel; GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1';
- cp .env.example .env && COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
- php artisan key:generate --force: la clave APP_KEY cifra datos del panel. Guarde una copia fuera del servidor, porque sin ella no se puede restaurar.
Configurar el entorno y crear el administrador
Tres asistentes interactivos rellenan el archivo .env: la dirección del panel y los controladores de caché, sesión y cola (elija Redis), luego la conexión a la base de datos y, por último, el envío de correos. La migración crea después las tablas y los eggs incluidos, y el último comando crea la primera cuenta de administrador.
- php artisan p:environment:setup, después php artisan p:environment:database y php artisan p:environment:mail
- php artisan migrate --seed --force: no lo interrumpa, la importación de los eggs tarda un poco.
- php artisan p:user:make: responda yes a la pregunta de administrador.
- chown -R www-data:www-data /var/www/pterodactyl/*: los archivos pertenecen al usuario del servidor web.
Activar la tarea programada y la cola de tareas
El panel necesita una tarea cron que se ejecute cada minuto (limpieza, tareas programadas de los servidores) y un worker que procese la cola de Redis. Sin el worker, la creación de servidores y los correos se quedan bloqueados.
- crontab -e y después la línea: * * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1
- Cree /etc/systemd/system/pteroq.service con User=www-data, Group=www-data, Restart=always y ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
- systemctl enable --now redis-server y después systemctl enable --now pteroq.service
Configurar nginx y el HTTPS con certbot
Primero apunte un registro A del dominio, por ejemplo panel.example.com, a la IPv4 del VPS. Obtenga después el certificado con el plugin nginx de certbot y cree el bloque de servidor del panel a partir de la plantilla nginx con SSL de la documentación oficial: root /var/www/pterodactyl/public, PHP enviado al socket de PHP-FPM 8.3 y las rutas del certificado obtenido.
- apt -y install certbot python3-certbot-nginx y después certbot certonly --nginx -d panel.example.com
- En /etc/nginx/sites-available/pterodactyl.conf: server_name panel.example.com, ssl_certificate /etc/letsencrypt/live/panel.example.com/fullchain.pem y fastcgi_pass unix:/run/php/php8.3-fpm.sock.
- rm /etc/nginx/sites-enabled/default, ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/ y después nginx -t && systemctl restart nginx
- La renovación es automática con el temporizador de certbot; pruébela con certbot renew --dry-run. El detalle está en la guía del certificado HTTPS gratuito.
Instalar Docker y Wings, y conectar el nodo
Wings puede ir en el mismo VPS que el panel o en otra máquina. Instale Docker con el script oficial y después el binario de Wings. En el panel, cree una Location y luego un nodo con su dominio, la opción SSL y la memoria y el disco que quiera compartir. La pestaña Configuration del nodo muestra el contenido de config.yml que debe copiar en /etc/pterodactyl.
- curl -sSL https://get.docker.com/ | CHANNEL=stable bash && systemctl enable --now docker
- mkdir -p /etc/pterodactyl && curl -L -o /usr/local/bin/wings https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64 && chmod u+x /usr/local/bin/wings
- Ejecute wings --debug una primera vez para ver los errores, después cree el servicio wings.service (ExecStart=/usr/local/bin/wings, tras docker.service) y actívelo con systemctl enable --now wings.
- Añada allocations al nodo: la IP pública que muestra hostname -I, nunca 127.0.0.1, y un rango de puertos, por ejemplo 25565-25600.
- El panel muestra un corazón verde junto al nodo cuando Wings responde; si no, revise el certificado y el puerto 8080.
Proteger el panel y los nodos
Un panel de juegos expone una interfaz de administración, una API y puertos de juego: es un objetivo. Abra solo los puertos necesarios, proteja las cuentas y haga copias de lo que no se puede reinstalar. Lo básico para endurecer un VPS está en nuestra guía de seguridad Linux.
- Cortafuegos: 22 (SSH), 80 y 443 para el panel, 8080 y 2022 para Wings y, después, los puertos de las allocations, en TCP y UDP según el juego.
- Active la autenticación en dos pasos en las cuentas de administrador y desactive el acceso SSH con contraseña.
- Haga copias del archivo .env, de la base panel (mysqldump panel) y de los datos de los servidores en /var/lib/pterodactyl/volumes, y guárdelas fuera del VPS.
- Actualice el panel con php artisan p:upgrade y Wings sustituyendo el binario, tras una copia de seguridad y siguiendo las notas de versión.
Sin instalar nada: las opciones de ACLClouds
Si quiere su propio panel sin pasar por estos pasos, el VPS Pterodactyl preconfigurado instala el panel, MariaDB, Redis, la cola de tareas y el HTTPS a partir de su dominio y sus credenciales. El VPS Pterodactyl + Wings añade Docker y Wings, con el nodo, su config.yml y 100 allocations ya creados. En ambos casos conserva el acceso root.
- Estas imágenes cuestan lo mismo que los demás VPS: la instalación preconfigurada está incluida.
- Si solo quiere jugar sin administrar un servidor, nuestros servidores de juegos funcionan con el panel de ACLClouds, construido sobre Pterodactyl y Wings: el servidor se entrega listo, sin nada que instalar por su parte.
Preguntas frecuentes
¿Pterodactyl es gratuito?
Sí. El panel y Wings se publican con licencia MIT, sin límite de servidores ni de usuarios. Solo paga la máquina en la que funcionan.
¿Cuánta RAM necesita Pterodactyl?
El panel solo funciona con 2 GB. Si Wings va en el mismo VPS, sume la memoria de cada servidor de juego: 8 GB dan para uno o dos servidores pequeños y 16 GB para varios medianos.
¿Se puede instalar Pterodactyl en Windows?
No. El panel y Wings están pensados para Linux y Wings no funciona en Windows. Use un VPS Linux o, para pruebas, una máquina virtual Linux en su PC.
¿Pterodactyl necesita un nombre de dominio?
Para un uso real, sí: el HTTPS del panel y la conexión segura entre el panel y Wings dependen de un certificado ligado a un nombre. Basta con un subdominio gratuito en aclclouds.online.