Ayuda y guías › Agentes LAN (red interna) › Instalación agent (systemd / Docker)

Instalación agent (systemd / Docker)

4 min de lectura · Agentes LAN (red interna)

En resumen: La instalación del LAN agent dura tres minutos. Como servicio systemd (Linux + root) o como contenedor Docker (Synology, Unraid, k3s). El agente solo necesita HTTPS saliente a epulz.io.

1. Cree el agente en el panel

  1. Abra Panel → LAN agents.
  2. Introduzca un nombre razonable (por ejemplo "Empresa X - sala de servidores", "Pi en la tienda de Bratislava").
  3. Pulse Crear agente.
  4. Aparecerá un token con formato plzag_… - cópielo inmediatamente. Se muestra solo una vez; si lo cierra sin copiarlo, deberá crear un nuevo agente.

2a. Variante A - servicio systemd (Linux)

Para Raspberry Pi, mini PC, servidor virtual o cualquier máquina Linux con acceso root:

sudo bash <(curl -s https://epulz.io/install-agent.sh) plzag_SU_TOKEN

El script:

  • Instala Python 3 y el binario ping (si faltan).
  • Descarga agent.py en /opt/epulzio-agent.
  • Escribe el token en /opt/epulzio-agent/agent.env con permisos 0600.
  • Registra y arranca el servicio systemd epulzio-agent.service.

Logs tras la instalación: journalctl -u epulzio-agent -f

2b. Variante B - Docker

Para Synology / Unraid / k3s / TrueNAS / cualquier host Docker:

[Docker image v príprave]

--network host es clave: el agente necesita acceso a la red local del host, no solo a la red interna de Docker.

Dónde ejecutar mejor el agente: Una máquina siempre encendida y con buena conectividad de red hacia los dispositivos que quiere monitorizar. Opciones clásicas: Raspberry Pi en la red, mini PC en el rack, host hypervisor, NAS. Un solo agente gestiona cientos de monitores.

3. Verifique en el panel

En LAN agents, junto al agente se muestra el estado:

  • ● online - el agente envía heartbeat (contacto en los últimos 2 minutos)
  • marca de tiempo - contacto en los últimos 10 minutos
  • offline desde … - contacto hace más de 10 minutos (recibirá correo a los 5 min)

Actualización del agente

Para la variante systemd:

sudo curl -sfL https://epulz.io/static/agent/epulzio-agent.py -o /opt/epulzio-agent/agent.py
sudo systemctl restart epulzio-agent

Para Docker: # Docker image v príprave - použite systemd inštaláciu nižšie

Siguiente paso:

Creación del primer monitor LAN (ping, TCP, HTTP).

Primer monitor LAN →
Siguiente →
Crear primer monitor LAN