Ir al contenido

Documentación

WISP

Conecte un panel WISP y Provibr crea, ejecuta y elimina servidores de juego en él. WISP es un fork de Pterodactyl, así que el modelo es el mismo; esta página cubre los puntos en los que se diferencia.

Un panel alojado, un nodo propio

WISP se vende como servicio alojado: wisp.gg ejecuta el panel, y el nodo que aloja los servidores de juego corre en hardware propio. El agente habla con el panel por su API y con el daemon del nodo para la consola. Las dos conexiones son salientes, así que no hace falta abrir nada a internet.

Como el panel no es propio, no hay nada que actualizar ni nada que anclar: WISP puede cambiar su API sin que medie ninguna versión bajo control propio. Provibr se prueba contra la v3.7.5 y lee del propio panel la versión en ejecución, así que una desviación aparece en la prueba de conexión y no en un pedido fallido.

Dos claves de API

WISP conserva la separación de Pterodactyl entre dos API, y ninguna clave llega a las dos. Créelas en una cuenta de administrador y pegue las dos junto con la dirección del panel.

  • La dirección del panel: la URL completa, por ejemplo https://panel.example.com. Solo hay que añadir un puerto si el panel se ejecuta realmente en él; detrás de un proxy inverso responde en el puerto predeterminado de su esquema.
  • La clave de API de aplicación: sirve para crear, suspender, reinstalar y eliminar servidores.
  • La clave de API de cliente: sirve para el encendido y apagado, las estadísticas en vivo y la consola.
  • La huella TLS (opcional): en un panel WISP alojado se deja vacía, porque su certificado viene de una autoridad pública y no hay nada a lo que anclarse.
Las claves de WISP no llevan prefijo, a diferencia de ptla_ en Pterodactyl y papp_ en Pelican. Nada avisa de que las dos se hayan intercambiado: Provibr no lo puede comprobar, y el panel responde a una clave equivocada con un 403 vacío que se lee como «permisos insuficientes». Si la prueba de conexión falla, conviene probar las dos claves al revés antes de tocar nada en el panel.
La clave de aplicación es más que gestión de servidores: el mismo listado de nodos que lee Provibr expone también la clave de licencia y el token del daemon del nodo. Conviene tratarla como una credencial de todo el panel y revocarla en WISP si alguna vez se desconecta la integración.

Transporte

Un panel WISP alojado es accesible por https con un certificado de confianza pública, así que el campo de la huella se queda vacío. Solo hay que rellenarlo cuando WISP se ejecuta por cuenta propia detrás de un certificado autofirmado; el agente confía entonces en ese certificado concreto en lugar de desactivar la verificación. Se lee con:

shell
openssl s_client -connect <host>:443 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Los comandos y la salida del terminal están en inglés en todas partes, en el panel y en estas páginas. Un solo texto, una sola verdad: lo que se lee aquí es literalmente lo que devolverá su host.

Con un certificado de una autoridad pública se deja el campo vacío, y también si el panel solo es accesible por http. Una huella junto a una dirección http se rechaza, porque no hay ningún certificado al que anclarse. Un panel en http sin cifrar sí funciona, pero entonces las dos claves viajan sin cifrar por la red.

Los eggs

Un servidor se construye a partir de un egg, exactamente igual que en Pterodactyl. WISP enumera todos sus eggs con sus variables en una sola llamada, así que el selector se rellena solo y un plan puede sobrescribir cualquier variable que el egg marque como editable.

Si una variable obligatoria se deja vacía, WISP no rechaza el pedido: rellena en silencio el valor predeterminado del propio egg. El servidor funciona, pero no es el que se pidió. Provibr comprueba las variables obligatorias antes de enviar, así que en su lugar el pedido se detiene con un mensaje que nombra la variable.

Planes

Un plan de juego lleva el egg, los límites de recursos y las variables que se sobrescriban. El pedido se hace mediante un plan: el plan decide qué egg se usa y cuánto puede consumir el servidor, y un mismo plan puede vincularse a más de un panel.

Ubicación

Un nodo de WISP informa de sus núcleos, su memoria y su disco, pero no de cuánto de eso ya está repartido. Provibr lo suma a partir de los servidores del nodo, que es lo mismo que hace con un hipervisor.

El nodo lo elige el agente y no el motor de ubicación: se queda con el nodo que más memoria libre tiene y con la primera asignación de puerto libre que hay en él. Clasificar desde Provibr los nodos de un panel WISP todavía no existe.

Ciclo de vida

Crear, iniciar, detener, reiniciar, forzar la parada, suspender, reactivar, reinstalar y eliminar funcionan todos. Un servidor suspendido se puede eliminar igualmente, y al eliminarlo su asignación de puerto vuelve a quedar libre.

WISP no informa de una instalación fallida. Un servidor está marcado como instalado o no lo está, y «todavía está en ello» y «algo ha salido mal» se ven igual desde fuera. Si un servidor nuevo sigue sin instalarse mucho más tiempo del que suele tardar un egg, conviene abrir su consola en WISP y leer allí la salida de la instalación.

Consola y mediciones

La consola es un terminal en vivo sobre el daemon del nodo, en el mismo panel que el resto de la infraestructura, y los gráficos de uso vienen de las propias mediciones del panel. La CPU, la memoria, el disco y la red se leen en cada ronda de sondeo; WISP no informa del tiempo en marcha, así que un contenedor que se reinicia entre dos rondas no siempre se reconoce como un reinicio.

Lo que Provibr no hace

Provibr no gestiona el panel, sus nodos, archivos, copias de seguridad, bases de datos ni usuarios. Los añadidos propios de WISP tampoco forman parte de la integración: el splitter, los subdominios, los borrados programados, las tiendas de mods. Lo que Provibr aprovisiona, cuenta y cobra es un servidor de juego en el panel; los servidores que no se hayan creado con Provibr se dejan intactos.