Ajuda e guias › Agentes LAN (rede interna) › Instalação agent (systemd / Docker)

Instalação agent (systemd / Docker)

4 min de leitura · Agentes LAN (rede interna)

Em resumo: A instalação do LAN agent leva três minutos. Seja como serviço systemd (Linux + root), seja como container Docker (Synology, Unraid, k3s). O agente precisa apenas de HTTPS de saída para epulz.io.

1. Crie o agente no dashboard

  1. Abra Dashboard -> LAN agentes.
  2. Insira um nome razoável (por exemplo "Empresa X - sala dos servidores", "Pi na loja de Bratislava").
  3. Pressione Criar agente.
  4. Aparece o token no formato plzag_... - copie-o imediatamente. É exibido apenas uma vez; se você fechar sem copiar, terá que criar um novo agente.

2a. Variante A - serviço systemd (Linux)

Para Raspberry Pi, mini PC, servidor virtual ou qualquer máquina Linux com acesso root:

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

O script:

  • Instala Python 3 e o binário ping (se faltarem).
  • Baixa o agent.py para /opt/epulzio-agent.
  • Escreve o token em /opt/epulzio-agent/agent.env com permissões 0600.
  • Registra e inicia o serviço systemd epulzio-agent.service.

Logs após a instalação: journalctl -u epulzio-agent -f

2b. Variante B - Docker

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

[Docker image v príprave]

--network host é fundamental: o agente precisa acessar a rede local do host, não apenas a rede interna do Docker.

Onde é melhor rodar o agente: Uma máquina que está sempre ligada e tem boa conexão de rede com os dispositivos que você quer monitorar. Escolhas clássicas: Raspberry Pi na rede, mini PC no rack, hypervisor host, NAS. Um único agente aguenta centenas de monitores.

3. Verifique no dashboard

Em LAN agentes ao lado do agente aparece o status:

  • online - o agente envia heartbeat (contato com menos de 2 minutos)
  • timestamp - contato nos últimos 10 minutos
  • offline desde ... - contato com mais de 10 minutos (você recebe e-mail após 5 min)

Atualização do agente

Para 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

Próximo passo:

Criação do primeiro monitor LAN (ping, TCP, HTTP).

Primeiro monitor LAN
Próximo →
Criar primeiro monitor LAN