ACLClouds
ACLClouds

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.