Installation agent (systemd / Docker)

4 min de lecture · Agents LAN (réseau interne)

En bref : l'installation de l'agent LAN prend trois minutes. Soit comme service systemd (Linux + root), soit comme conteneur Docker (Synology, Unraid, k3s). L'agent n'a besoin que d'un HTTPS sortant vers epulz.io.

1. Créez un agent dans le tableau de bord

Ouvrez Tableau de bord -> Agents LAN.
Donnez un nom raisonnable (par ex. "Firme X - salle serveur", "Pi au magasin Bratislava").
Cliquez sur Créer un agent.
Un token au format plzag_... s'affiche - copiez-le immédiatement. Il ne s'affiche qu'une seule fois ; si vous le fermez sans le copier, vous devrez créer un nouvel agent.

2a. Variante A - service systemd (Linux)

Pour Raspberry Pi, mini PC, serveur virtuel ou n'importe quelle machine Linux avec accès root :

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

Le script :

Installe Python 3 et le binaire ping (s'ils manquent).
Télécharge agent.py dans /opt/epulzio-agent.
Écrit le token dans /opt/epulzio-agent/agent.env avec les permissions 0600.
Enregistre et lance le service systemd epulzio-agent.service.

Logs après installation : journalctl -u epulzio-agent -f

2b. Variante B - Docker

Pour Synology / Unraid / k3s / TrueNAS / n'importe quel hôte Docker :

[Docker image v príprave]

--network host est essentiel : l'agent a besoin d'accéder au réseau local de l'hôte, pas seulement au réseau interne Docker.

Où il est préférable de lancer l'agent : Une machine toujours allumée et avec une bonne connexion réseau aux équipements que vous voulez surveiller. Choix classiques : Raspberry Pi sur le réseau, mini PC en rack, hôte hyperviseur, NAS. Un seul agent gère des centaines de moniteurs.

3. Vérifiez dans le tableau de bord

Dans Agents LAN, à côté de l'agent s'affiche un statut :

en ligne - l'agent envoie un heartbeat (contact plus récent que 2 minutes)
horodatage - contact dans les 10 dernières minutes
hors ligne depuis ... - contact plus ancien que 10 minutes (vous recevez un email après 5 min)

Mise à jour de l'agent

Pour 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

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


  Étape suivante :
  Création du premier moniteur LAN (ping, TCP, HTTP).
  Premier moniteur LAN