Tú decides qué servicios podemos activar para análisis, personalización y contenido externo.
Utilizamos cookies y tecnologías similares en nuestro sitio web para personalizar el contenido, integrar medios externos y comprender mejor el uso de determinadas secciones.
Cookies necesarias
Estas entradas garantizan funciones básicas como la seguridad, la estabilidad y el procesamiento de formularios.
Tus datos pueden tratarse con tu consentimiento o sobre la base de intereses legítimos. En la configuración de cookies puedes rechazar cada categoría opcional o autorizarla expresamente.
Algunos servicios procesan datos personales en terceros países. Al dar tu consentimiento, también aceptas esta transferencia. Encontrarás más información en nuestra política de privacidad.
Puedes volver a abrir y modificar tu selección en cualquier momento. · 1.0.2
Configurar Pterodactyl en un servidor Linux: aloja tu propio panel de servidores de juegos
Descubre cómo instalar Pterodactyl Panel y Wings en tu servidor Linux y gestionar fácilmente tus propios servidores de juegos desde una interfaz web → Descubre más
10 de noviembre de 202614 min de lectura1 Visitas0 útil
Introducción
Pterodactyl es un panel gratuito de código abierto que te permite gestionar servidores de juegos como Minecraft, Rust, ARK o CS2 desde una interfaz web. Cada servidor de juegos se ejecuta en su propio contenedor Docker, completamente separado de los demás.
Pterodactyl consta de dos partes:
Panel – la interfaz web donde gestionas los servidores, los usuarios y los recursos (aplicación PHP con base de datos y servidor web)
Wings – el servicio del servidor que inicia, detiene y supervisa los contenedores de los servidores de juegos
En esta guía te mostramos paso a paso cómo instalar Panel y Wings en tu VPS de ZapX o en un servidor dedicado, configurar un dominio con SSL y crear tu primer servidor de juegos.
Preparativos
Para usar Pterodactyl necesitas un VPS o un servidor dedicado con Linux y acceso root mediante SSH. En nuestra guía de primer acceso por SSH encontrarás cómo conectarte a tu servidor. ¿Acabas de llegar a ZapX? Primero, consulta la introducción a los VPS o a los servidores dedicados.
Consejo
Autenticación con clave SSH
Te recomendamos usar una clave SSH en lugar de una contraseña. En nuestra guía Crear y usar claves SSH encontrarás cómo hacerlo.
Requisitos de hardware
El Panel en sí es ligero. Los recursos que necesitas dependen principalmente de cuántos servidores de juegos quieras ejecutar con Wings. Si instalas Panel y Wings en el mismo servidor, te recomendamos lo siguiente:
Hardware
Mínimo
Recomendado
CPU
2 núcleos de vCPU
4 núcleos de vCPU o más
RAM
4 GB
8 GB o más
Espacio en disco
30 GB
100 GB o más
Sistemas operativos compatibles
Según la documentación oficial de Pterodactyl, actualmente son compatibles estos sistemas:
Sistema operativo
Versiones
Nota
Ubuntu
22.04, 24.04
En 22.04 necesitas un repositorio PHP adicional
Debian
11, 12, 13
PHP 8.3 se obtiene del repositorio Sury
Rocky Linux / AlmaLinux / RHEL
8, 9
Usan nombres de paquetes y rutas diferentes; no se tratan en esta guía
En esta guía encontrarás los comandos para Ubuntu y Debian. El Panel ya no es compatible con Ubuntu 20.04 ni con versiones anteriores. Si vas a instalar el sistema desde cero, te recomendamos Ubuntu 24.04 o Debian 12.
Comprobar la virtualización
Wings necesita Docker. Docker funciona sin problemas en servidores basados en KVM y en servidores dedicados, pero normalmente no en contenedores OpenVZ o LXC. Compruébalo con este comando:
bash
systemd-detect-virt
El resultado kvm o none (servidor dedicado sin virtualización) es correcto. Si aparece openvz o lxc, por lo general no podrás ejecutar Wings en ese servidor.
Actualizar el sistema
Antes de la instalación, actualiza el sistema a la versión más reciente:
bash
apt update && apt upgrade -y
Firewall y puertos
Si utilizas un firewall en tu servidor, debes abrir estos puertos:
Puerto
Protocolo
Uso
80 y 443
TCP
Panel (HTTP/HTTPS) y verificación del certificado por parte de Certbot
8080
TCP
API de Wings, que permite la comunicación entre el Panel y el nodo
2022
TCP
Acceso SFTP a los archivos de los servidores de juegos
Puertos de juego
TCP/UDP
Los puertos de tus asignaciones, por ejemplo, 25565 para Minecraft
Por ejemplo, puedes abrir los puertos con UFW de esta manera. Asegúrate de permitir SSH primero; de lo contrario, podrías bloquearte el acceso al activar el firewall:
Docker crea sus propias reglas para los puertos de los contenedores de los servidores de juegos. Por eso, esos puertos suelen ser accesibles incluso si no los has abierto en UFW. No confíes únicamente en UFW para proteger los puertos de juego.
FAQ
Preguntas frecuentes
Pterodactyl es un panel gratuito de código abierto para gestionar servidores de juegos. Consta del Panel (la interfaz web) y Wings (el servicio del servidor), que inicia cada servidor de juegos en su propio contenedor Docker.
Según la documentación oficial, admite Ubuntu 22.04 y 24.04, Debian 11, 12 y 13, y Rocky Linux, AlmaLinux y RHEL 8 y 9. El Panel ya no es compatible con Ubuntu 20.04 ni con versiones anteriores.
El Panel necesita PHP 8.2 o 8.3; se recomienda PHP 8.3. En Ubuntu 22.04 y Debian, PHP 8.3 se obtiene de un repositorio adicional; Ubuntu 24.04 ya lo incluye.
Para el Panel, los puertos 80 y 443; para Wings, el puerto 8080 (API) y el 2022 (SFTP). También necesitas los puertos de juego de tus asignaciones, por ejemplo, el 25565 para Minecraft.
Comentarios
¿Te resultó útil este artículo?
Tus comentarios nos ayudan a priorizar y mejorar los contenidos.
0 de 0 Las valoraciones consideraron útil este artículo.
Ayuda personalizada
¿No te basta con la guía?
Nuestro equipo de soporte de ZAP conoce tu producto. Describe brevemente tu consulta y te ayudaremos personalmente.
Zappy conoce esta guía y te responde directamente en el chat.
Navegación
Software
Descargar el Panel
Crea la carpeta del Panel y accede a ella:
bash
mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
Descarga la versión más reciente, descomprímela y configura los permisos de las carpetas storage/ y bootstrap/cache/:
Ya tienes todo listo para crear tu primer servidor de juegos:
En la sección de administración, abre Servers y haz clic en Create New.
Elige un nombre y selecciona al propietario (por ejemplo, tu cuenta de administrador).
Elige el nodo y una asignación disponible.
Define cuánta CPU, RAM y espacio en disco tendrá el servidor.
En Nest y Egg, elige el juego; por ejemplo, Minecraft con Paper.
Haz clic en Create Server.
Wings descargará la imagen Docker correspondiente e instalará el servidor. Después, lo encontrarás en la vista normal del Panel, desde donde podrás iniciarlo, abrir la consola y gestionar los archivos.
Conclusión y recursos adicionales
¡Enhorabuena! Has instalado correctamente Pterodactyl Panel y Wings en tu servidor. Ahora puedes gestionar tus propios servidores de juegos desde la interfaz web. Estos recursos te ayudarán a seguir:
Nota: Desde la versión 1.11, Pterodactyl envía datos de uso anónimos (telemetría). En la documentación oficial, en «Additional Configuration», encontrarás cómo desactivarla.
¿Tienes alguna pregunta que no hayamos respondido aquí? Nuestro equipo de asistencia está a tu disposición todos los días. ¡Ponte en contacto con nosotros! 🙂
Alojamiento de servidores desde 2,49 € / mes, disponible al instante, con protección DDoS incluida.
El Panel necesita PHP 8.2 o 8.3 (se recomienda 8.3) con algunas extensiones, una base de datos (MariaDB o MySQL), Redis, un servidor web (usaremos Nginx), además de curl, tar, unzip, git y Composer. Ejecuta los comandos correspondientes a tu distribución.
Ubuntu 24.04
En Ubuntu 24.04, PHP 8.3, MariaDB y Redis ya están disponibles en los repositorios de paquetes estándar. No necesitas añadir repositorios:
Ubuntu 22.04 solo incluye PHP 8.1. Por eso, primero añade el repositorio PHP de Ondřej Surý y el repositorio oficial de Redis; después, instala todos los paquetes:
Copia la configuración de ejemplo, instala las dependencias de PHP y genera la clave de la aplicación:
bash
cp .env.example .env
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
# Nur bei einer Neuinstallation ausführen, nicht bei einem bestehenden Panel
php artisan key:generate --force
Atención
Guarda una copia de APP_KEY
El valor APP_KEY del archivo cifra todos los datos confidenciales del Panel, como las claves de API. Si lo pierdes, esos datos dejarán de ser legibles, incluso si tienes una copia de seguridad de la base de datos. Muestra el valor con y guárdalo en un lugar seguro fuera del servidor, por ejemplo, en tu gestor de contraseñas.
Configurar el cronjob y el trabajador de cola
El Panel realiza muchas tareas en segundo plano, como tareas programadas, envío de correos y limpieza. Para ello, necesitas un cronjob y un trabajador de cola.
Cronjob
Abre el crontab con sudo crontab -e y añade esta línea. Ejecuta el programador del Panel cada minuto:
Para acceder al Panel mediante tu propio dominio con HTTPS, configura ahora el DNS, un certificado SSL y Nginx.
Crear un registro DNS
Crea un registro A en tu proveedor de dominios que apunte a la dirección IP de tu servidor, por ejemplo, panel.example.com. Si tu dominio está alojado en ZAP-Hosting, consulta nuestra guía sobre registros de dominio. El registro puede tardar un tiempo en activarse en todo el mundo.
Crear un certificado SSL con Certbot
Instala Certbot con el complemento de Nginx y crea el certificado. Sustituye panel.example.com por tu dominio:
Certbot verifica el dominio a través del puerto 80. Por eso, el puerto debe ser accesible desde Internet. En nuestra guía Configurar Certbot en un servidor Linux encontrarás más información sobre Certbot.
El paquete de Certbot renueva los certificados automáticamente. Para que Nginx y Wings también carguen los certificados renovados, puedes añadir esta línea al crontab (sudo crontab -e):
Crea un archivo de configuración nuevo para el Panel:
bash
nano /etc/nginx/sites-available/pterodactyl.conf
Instalar Wings
Wings es el servicio que ejecuta tus servidores de juegos. Puedes instalar Wings en el mismo servidor que el Panel o en otros servidores, que después añadirás como nodos adicionales en el Panel.
Instalar Docker
Wings inicia cada servidor de juegos en un contenedor Docker. Instala Docker CE con el script de instalación oficial y activa el servicio:
# Paketlisten neu laden und Abhängigkeiten installieren
Debian 11 y 12
En Debian 11 y 12, PHP 8.3 se obtiene del repositorio Sury, Redis del repositorio oficial de Redis y MariaDB se instala mediante el script de configuración de MariaDB:
Debian 13 incluye PHP 8.4 de forma predeterminada, que Pterodactyl no admite oficialmente. Por eso, obtén PHP 8.3 del repositorio Sury. Instala MariaDB y Redis directamente desde los repositorios de paquetes de Debian, sin añadir otros repositorios:
Con los siguientes comandos, configurarás las sesiones, la caché, la conexión con la base de datos y el envío de correo. Los comandos te preguntarán los valores de forma interactiva:
bash
php artisan p:environment:setup
php artisan p:environment:database
# Optional: Mailversand einrichten ("smtp" für einen eigenen Mailserver)
php artisan p:environment:mail
Cuando te pregunten por la Application URL, introduce la dirección que tendrá el Panel, por ejemplo, https://panel.example.com. Para la base de datos, usa 127.0.0.1, el nombre de base de datos panel, el usuario pterodactyl y la contraseña que acabas de configurar. Puedes elegir Redis para la caché, las sesiones y la cola.
Cargar la base de datos
Ahora el Panel creará sus tablas e importará los Nests y Eggs incluidos (las plantillas para cada juego):
bash
php artisan migrate --seed --force
Información
Espera a que termine
El proceso puede tardar unos minutos. No lo interrumpas; de lo contrario, la base de datos quedará incompleta.
Crear el primer administrador
Crea tu cuenta de administrador. La contraseña debe tener al menos 8 caracteres, incluir letras mayúsculas y minúsculas y contener al menos un número:
bash
php artisan p:user:make
Cuando te pregunten si el usuario debe ser administrador, responde yes.
Configurar los permisos
Para que Nginx y PHP puedan acceder a los archivos, asígnalos al usuario del servidor web:
bash
chown -R www-data:www-data /var/www/pterodactyl/*
Guarda con STRG + X, después pulsa Y y Enter. A continuación, activa Redis y el trabajador de cola para que ambos se inicien automáticamente después de reiniciar el servidor:
Nginx solo se iniciará con esta configuración si el certificado SSL ya existe. Asegúrate de crearlo antes con Certbot.
Configurar Nginx sin SSL
Si solo quieres probar el Panel y todavía no tienes un dominio con certificado, puedes usar esta configuración más sencilla en /etc/nginx/sites-available/pterodactyl.conf. Sustituye panel.example.com por tu dominio o por la dirección IP de tu servidor. También debes eliminar antes el archivo /etc/nginx/sites-enabled/default:
Sin SSL, los inicios de sesión y las contraseñas se transmiten por Internet sin cifrar. Por eso, para un uso permanente, utiliza siempre la opción con SSL.
Activar la configuración
Activa la configuración, comprueba que no tenga errores y reinicia Nginx:
Ahora abre https://panel.example.com en el navegador e inicia sesión con la cuenta de administrador que acabas de crear. En nuestra guía Configurar Nginx y Apache en un servidor Linux encontrarás información general sobre Nginx.
Abre la sección de administración desde la parte superior derecha del Panel (icono de engranaje).
En Locations, crea una ubicación con Create New, por ejemplo, con el código de1.
Ve a Nodes y haz clic en Create New.
Introduce un nombre, elige la ubicación e indica el dominio del servidor en FQDN. Si Wings se ejecuta en el mismo servidor que el Panel, puedes usar el mismo dominio, por ejemplo, panel.example.com.
En Communicate Over SSL, selecciona Use SSL Connection si tu Panel funciona con HTTPS. En ese caso, el nodo también necesita un certificado válido para su FQDN.
En Total Memory y Total Disk Space, indica cuánta RAM y espacio puede asignar Wings a los servidores de juegos. Reserva algo de margen para el propio sistema.
Deja Daemon Port en 8080 y Daemon SFTP Port en 2022 y guarda el nodo.
Después, abre el nodo y ve a la pestaña Configuration. Haz clic en Generate Token y ejecuta en tu servidor el comando que aparece. El comando creará automáticamente el archivo /etc/pterodactyl/config.yml. Si lo prefieres, también puedes copiar manualmente el contenido del bloque de código en ese archivo.
Probar Wings
Inicia Wings una vez en modo de depuración para ver los errores directamente:
bash
sudo wings --debug
Si Wings se ejecuta sin errores y aparece un corazón verde en el nodo, en Nodes del Panel, detén la prueba con STRG + C.
Configurar Wings como servicio
Para que Wings se ejecute permanentemente en segundo plano, crea un servicio de systemd:
Una asignación (allocation) es una combinación de dirección IP y puerto que asignas a un servidor de juegos. Cada servidor necesita al menos una. Puedes encontrar la dirección IP de tu servidor con este comando:
bash
hostname -I | awk '{print $1}'
En la sección de administración, abre tu nodo, ve a la pestaña Allocation e introduce la dirección IP y los puertos que quieras en Assign New Allocations, por ejemplo, 25565-25570 para Minecraft. No uses nunca 127.0.0.1 como asignación.
Fuente preferida en Google
