Cómo instalar la extensión de ReforgerOps en Aether Panel
Aether Panel es un panel de hosting para servidores de juegos, de la misma familia que Pterodactyl. Si tu servidor de Arma Reforger corre ahí, la extensión de ReforgerOps une los dos paneles: desde Aether llegas a tu servidor en ReforgerOps con un clic, y Aether le avisa a ReforgerOps en cuanto el servidor se cae, se apaga o arranca, sin que tengas que configurar nada más. Esta guía explica qué hace la extensión, quién la instala, cómo conectar un servidor desde ella y qué revisar si algo no funciona.
Qué hace la extensión
La extensión es un archivo .zip que se instala una sola vez en el panel Aether. A partir de ese momento hace tres cosas:
- Una pestaña «ReforgerOps» en cada servidor de Arma Reforger. Solo aparece en los servidores creados con la plantilla de Arma Reforger (tipo de plantilla
armareforger); los servidores de otros juegos del mismo panel no la ven. - Un botón «Abrir en ReforgerOps». Abre ese mismo servidor en ReforgerOps, en una pestaña nueva del navegador. Si ya lo tienes conectado, entras directo; si no, te lleva a conectarlo con el panel y el servidor ya rellenados.
- Avisos de Aether a ReforgerOps. Cuando el servidor se cae, Aether lo informa al momento y ReforgerOps manda un solo aviso por Discord, Telegram o notificación al teléfono (los que tengas activos), con el código de salida si Aether lo informa y el final del log, para que veas qué pasó sin abrir archivos. Si Aether lo reinició solo, el aviso también lo dice. Cuando el servidor se apaga o arranca, el mensaje de estado del servidor en Discord pasa a «Apagado» o «Arrancando» enseguida, sin esperar a la siguiente comprobación y sin aviso de caída: apagarlo tú no es una caída.
Un solo aviso quiere decir uno de verdad: cuando Aether ya avisó de la caída, la detección normal de ReforgerOps no manda otro por la misma caída. Cada evento queda además en el Registro del servidor en ReforgerOps, con el usuario aether, así después sabes cuándo se apagó o se cayó. Y si borras el servidor en Aether, ReforgerOps lo desconecta de Aether y te avisa, pero no borra el servidor ni su historial.
Lo que la extensión no hace: no muestra jugadores ni baneos dentro de Aether (eso se hace en ReforgerOps), no instala nada en el juego y no le da por sí sola a ReforgerOps acceso a tus servidores. El acceso lo das tú, servidor por servidor, con un cliente OAuth que puedes borrar cuando quieras.
Quién la instala
La instala quien administra el panel Aether, no cada cliente. Hay dos casos y el proceso es exactamente el mismo:
- Tienes tu propio panel Aether. Eres administrador y cliente a la vez: instalas la extensión y después conectas tus servidores desde la pestaña.
- Eres una empresa de hosting. La instalas una vez y todos tus clientes con servidores de Arma Reforger ven la pestaña. El hosting no necesita cuenta en ReforgerOps ni tiene que pegar claves por cada cliente: cada cliente usa su propia cuenta y conecta su servidor cuando quiera.
Si eres cliente de un hosting que usa Aether, no tienes que instalar nada. Si no ves la pestaña en tu servidor, pídele a tu hosting que instale la extensión; puedes pasarle el enlace a esta guía.
Instalar la extensión
- Descarga el archivo: reforgerops-aether.zip. No hace falta descomprimirlo.
- En Aether, entra en Configuración → Extensiones y pulsa «Instalar extensión».
- Sube el .zip. La extensión aparece en la lista con el nombre «ReforgerOps».
- Activa su interruptor. Instalada pero apagada no muestra la pestaña ni manda avisos.
En esa misma pantalla vas a ver dos cosas que no tienes que tocar:
- La dirección de eventos viene puesta:
https://reforgerops.net/api/aether/events. Es adonde Aether manda los avisos. No la cambies: con otra dirección los avisos dejan de llegar. - La «Clave de firma» que muestra Aether no hace falta copiarla en ninguna parte. ReforgerOps comprueba cada aviso con la clave de identidad del propio panel, que Aether publica por su cuenta, así que no hay ninguna clave que pegar.
Un requisito: la dirección del panel tiene que estar configurada en los ajustes de Aether, y con https://. Es la dirección con la que el panel se identifica. Sin ella, la pestaña no puede decirle a ReforgerOps de qué panel viene el servidor; sin HTTPS, los avisos no se aceptan.
Conectar un servidor desde la pestaña
Con la extensión instalada, cada dueño conecta su servidor así:
- Abre el servidor en Aether y entra en la pestaña ReforgerOps.
- Pulsa «Abrir en ReforgerOps». Se abre una pestaña nueva del navegador.
- Entra con tu cuenta o crea una. Si tienes que confirmar el correo, no pasa nada: al volver, ReforgerOps retoma el servidor que estabas conectando.
- Si ese servidor ya estaba conectado a tu cuenta, entras directo a él. Si no, ReforgerOps te muestra el panel y el servidor ya rellenados y solo te pide un cliente OAuth. Si tu plan no tiene lugar para otro servidor, te lo dice antes de pedirte nada.
- Crea el cliente OAuth en Aether: Perfil → Clientes OAuth → Nuevo, con «Acceso: solo este servidor» y estos permisos: encender y apagar, ver CPU y memoria, consola, y ver y editar archivos. Si no ves «Clientes OAuth» en tu perfil, tu cuenta no tiene ese permiso: pídeselo a tu hosting.
- Pega el
client_idy elclient_secreten ReforgerOps y pulsa «Conectar el servidor».
Con eso, ReforgerOps lee el config.json del servidor a través de Aether, toma la dirección pública, el puerto y la contraseña de RCON, comprueba que el RCON responde y crea el servidor en tu cuenta. La contraseña de RCON va de Aether a ReforgerOps directamente: nunca pasa por tu navegador ni tienes que copiarla a mano. Después sigue el asistente de conexión de siempre: Steam Query, el mod compañero (que se puede instalar solo, porque ya hay acceso a los archivos) y Discord.
Limitar el cliente a «solo este servidor» es lo recomendable: si algún día la clave se filtra, solo sirve para ese servidor y solo para lo que le diste. Puedes borrar el cliente en Aether en cualquier momento y ReforgerOps deja de tener acceso.
Seguridad, en pocas palabras
- Los avisos van firmados por el panel. Aether firma cada aviso con la clave de identidad de su panel y ReforgerOps lo comprueba antes de hacer nada. Nadie puede mandar un «servidor caído» falso en nombre de tu panel.
- Solo reciben avisos los servidores comprobados. Un servidor recibe los avisos de Aether solo si ReforgerOps ya habló con Aether por ese servidor usando un cliente OAuth válido. Escribir el panel y el número de servidor de otra persona no alcanza para recibir sus caídas.
- ReforgerOps comprueba que la dirección es de verdad un Aether antes de pedirte las claves. El enlace de la pestaña lo puede armar cualquiera, así que si la dirección no publica la identidad de un panel Aether, no aparecen los campos para pegar nada.
- Solo HTTPS. Un panel servido por
http://no puede probar quién es y mandaría tus claves sin cifrar: no se conecta desde la pestaña y no recibe avisos. - Mira la dirección antes de pegar. Junto a los campos, ReforgerOps muestra en grande la dirección del panel. Si no es la de tu panel Aether, no pegues tu
client_secret.
Código abierto
El código de la extensión es público, con licencia MIT, en su repositorio de GitHub. Cualquiera puede leerlo antes de instalarlo, y es lo que suele querer hacer una empresa de hosting antes de meter algo en su panel. Cada versión publicada en la página de versiones trae el .zip y su huella SHA-256: puedes comprobar que el archivo que descargaste es exactamente ese (por ejemplo, con sha256sum reforgerops-aether.zip) o armarlo tú desde el código con npm test && npm run build. El zip sale idéntico byte a byte.
Si algo no funciona
La pestaña no aparece
- El interruptor de la extensión está apagado en Configuración → Extensiones.
- El servidor no usa la plantilla de Arma Reforger: la pestaña solo sale en servidores cuyo tipo de plantilla es
armareforger. - Tenías Aether abierto desde antes de instalarla: recarga la página.
«Tu hosting todavía no configuró la dirección del panel»
Lo dice la pestaña cuando Aether no tiene la dirección del panel en sus ajustes. Si el panel es tuyo, configúrala con https://; si no, pídeselo a tu hosting.
«No pudimos comprobar esta dirección»
ReforgerOps no pudo llegar al panel para confirmar que es un Aether. Casi siempre es que el panel está caído o no responde en ese momento: prueba en un rato. Si el panel es tuyo y sigue sin responder, puedes conectar el servidor a mano desde Ajustes → Integraciones en ReforgerOps.
«Al cliente OAuth le falta…»
Al cliente OAuth le falta uno de los permisos de la lista de arriba, o no tiene acceso a este servidor. Edítalo en tu Perfil de Aether → Clientes OAuth, agrega el que falta y vuelve a intentarlo. Si el mensaje dice que Aether rechazó el client_id o el client_secret, revisa que los copiaste enteros, sin espacios al principio ni al final.
«No encontramos el config.json»
ReforgerOps busca el archivo en /config.json. Si tu servidor lo guarda en otra carpeta, aparece un campo para escribir la ruta, empezando por /. Si el archivo está pero le falta publicAddress o el bloque rcon con port y password, complétalos, reinicia el servidor y vuelve a intentarlo; la guía para activar RCON explica ese bloque.
Los avisos no llegan
- El panel Aether no usa HTTPS, o la dirección del panel no está configurada en sus ajustes.
- Mira la tarjeta de Aether en ReforgerOps (Ajustes → Configuración → Conexiones): dice «Recibiendo avisos de Aether» con la hora del último, o qué falta. Si dice que espera que Aether confirme el acceso, el cliente OAuth todavía no funcionó para ese servidor.
- Los avisos salen por los canales que tengas configurados en ReforgerOps: sin Discord, Telegram ni notificaciones al teléfono, la caída queda en el Registro pero no te llega a ninguna parte.
Hay una versión nueva de la extensión
Cuando la anunciemos en Novedades, vuelve a descargar el .zip desde el mismo enlace e instálalo otra vez desde Configuración → Extensiones. Tus servidores conectados no cambian: la conexión vive en ReforgerOps, no en la extensión.
Si vienes de Pterodactyl
Para ReforgerOps, Aether y Pterodactyl son dos formas de llegar al mismo contenedor: el reinicio completo, el editor del config.json con copia de seguridad, la lista de mods y los reinicios programados funcionan igual con los dos. Lo que cambia es la forma de dar acceso (en Pterodactyl es una clave de API de tu cuenta, en Aether un cliente OAuth que puede limitarse a un servidor) y que con Aether la caída llega como evento en vez de deducirse. En la guía de Pterodactyl están los puertos, dónde vive el config.json y dónde buscar los logs, que valen también para un servidor en Aether; y para que los avisos y el estado lleguen a un canal, mira cómo poner el estado del servidor en Discord.
