El agente de WarDogs

¿Agente o dirección RCON?

• Servidor de juego alquilado (xREALM, Nitrado, …): normalmente no puedes ejecutar programas allí. Usa Dirección RCON en el panel con el puerto RCON que te indique tu hosting.
• Tu propia máquina (servidor root, VPS, un PC en casa): usa el agente. RCON puede quedarse en 127.0.0.1 y no hay que abrir nada en el firewall.
• Un agente puede atender hasta diez servidores de juego en la misma máquina. Un Discord puede tener cinco agentes.

Paso a paso

1. 1

   Activa RCON en la config del servidor

   En ServerSettings.ini, la sección [/Script/WDRCON.WDRCONSettings] necesita RCON activado y una contraseña. Con el agente puede escuchar solo en esta máquina:

   [/Script/WDRCON.WDRCONSettings]
   bEnabled=true
   BindAddress=127.0.0.1
   Port=7776
   Password=choose-a-long-password

   Reinicia el servidor de juego después de cambiar esta sección.

2. 2

   Crea el agente en el panel

   Abre tu servidor en el panel, ve a Resumen → Directamente con RCON → Agente de WarDogs (o Ajustes → Conexión si ya estás conectado directamente), ponle un nombre a la máquina y pulsa Crear agente. El panel muestra el comando de inicio con tu token incluido. El token solo se muestra una vez.

3. 3

   Inícialo en el servidor

   Con Docker (Linux). --network host le permite llegar a RCON en 127.0.0.1:

   docker run -d --name wardogs-agent --restart unless-stopped --network host \
     -e WARDOGS_TOKEN=wda_your_token \
     -e RCON_URL=http://127.0.0.1:7776 \
     -e RCON_PASSWORD=your-rcon-password \
     registry.wardogsbot.com/wardogs-agent:1

   O con Docker Compose, junto a tus otros servicios:

   services:
     wardogs-agent:
       image: registry.wardogsbot.com/wardogs-agent:1
       restart: unless-stopped
       network_mode: host
       environment:
         WARDOGS_TOKEN: wda_your_token
         RCON_URL: http://127.0.0.1:7776
         RCON_PASSWORD: your-rcon-password

   La imagen está compilada para Linux en x86-64 y ARM64. La versión 1 recibe correcciones bajo la misma etiqueta.

   Con Node.js 18 o posterior (Linux o Windows), por ejemplo junto a un servidor de juego en Windows:

   Invoke-WebRequest https://wardogsbot.com/api/agent/wardogs-agent.js -OutFile wardogs-agent.js
   $env:WARDOGS_TOKEN="wda_your_token"; $env:RCON_PASSWORD="your-rcon-password"
   node wardogs-agent.js

   Mantenlo en marcha: Docker lo reinicia solo; con Node.js usa un servicio, una tarea programada al arrancar o pm2.

4. 4

   Hecho

   En pocos segundos el panel muestra el agente como Online y lista tu servidor. El panel de estado, la moderación, los bans, la whitelist, la rotación, los resúmenes y el editor de config del servidor funcionan ahora a través de él.

Ajustes

Seguridad

• El agente solo hace peticiones HTTPS salientes a wardogsbot.com. Nada escucha conexiones.
• Solo reenvía peticiones a la API RCON del juego (rutas bajo /v1/) en las direcciones que indiques. No se puede llegar a nada más de la máquina a través de él.
• La contraseña RCON se queda en el entorno del agente. Solo guardamos un hash del token del agente.
• El script no tiene dependencias y es lo bastante corto para leerlo: wardogs-agent.js. La imagen de Docker es ese script sobre node:22-alpine, ejecutado como usuario sin privilegios. El panel te avisa cuando sale una versión nueva.
• Para actualizar: docker pull registry.wardogsbot.com/wardogs-agent:1, luego docker rm -f wardogs-agent y otra vez el comando de inicio (Compose: docker compose pull && docker compose up -d). Con Node.js, vuelve a descargar el script.
• ¿Se ha filtrado un token? Pulsa el botón de la llave junto al agente para obtener uno nuevo, o elimina el agente. El token antiguo deja de funcionar al instante.

Solución de problemas

• Se queda en “Esperando el primer inicio”: el agente no llegó a wardogsbot.com. Revisa su log (docker logs wardogs-agent) y el HTTPS saliente.
• Online, pero “no se pudo llegar al servidor de juego”: RCON está desactivado, en otro puerto, o el servidor está caído. Revisa RCON_URL y reinicia el juego tras cambiar la config.
• “no acepta la contraseña RCON configurada en el agente”: RCON_PASSWORD no coincide con Password en la config.
• “El token no fue aceptado” en el log del agente: el agente se eliminó o recibió un token nuevo. Inícialo con el actual.
• Docker en Windows o macOS no tiene red host: ejecuta allí la versión de Node.js, o usa RCON_URL=http://host.docker.internal:7776 con RCON enlazado a 0.0.0.0.