Installer Zabbix Agent 2 sur Debian 11, 12 et 13 en 10 min

Superviser un serveur Debian avec Zabbix passe par l'installation d'un agent sur le système : un service léger qui collecte les métriques système et les transmet au serveur de supervision. Voir la définition complète de l'agent Zabbix.

Ce guide couvre l'installation manuelle et complète sur Debian 11 (Bullseye), 12 (Bookworm) et 13 (Trixie), avec n'importe quel serveur Zabbix.

Le plus simple : avec Logiserv

Logiserv s'appuie sur ce même moteur Zabbix et automatise l'ensemble. Depuis la page Agent du tableau de bord :

curl -sSL "https://www.logiserv.app/api/agent-script/linux?token=..." | sudo bash

Le script détecte la distribution via /etc/os-release, ajoute le dépôt, installe le paquet, génère une clé PSK unique, écrit la configuration, crée l'hôte côté serveur avec les bons templates, ajuste les permissions et démarre le service.

Comptez 1 à 2 minutes par système avec Logiserv. L'installation manuelle détaillée ci-dessous demande 6 étapes et 10 minutes environ par serveur, sans compter la création de l'hôte côté serveur Zabbix. Voir la comparaison détaillée.

Agent 1 ou Agent 2 ?

Le dépôt officiel fournit deux paquets :

• zabbix-agent — l'agent historique en C, configuration zabbix_agentd.conf
• zabbix-agent2 — la version actuelle en Go, configuration zabbix_agent2.conf

Agent 2 est recommandé pour une nouvelle installation : plugins intégrés, connexion persistante unique, empreinte mémoire réduite. Ce guide l'utilise ; pour Agent 1, remplacez agent2 par agent dans toutes les commandes et chemins.

Prérequis

• un accès root ou sudo (sur une Debian minimale, sudo n'est pas installé par défaut : utilisez su -)
• l'adresse IP ou le nom DNS de votre serveur Zabbix
• un accès sortant vers le port 10051/TCP du serveur

Étape 1 : ajouter le dépôt officiel Zabbix

Le nom du paquet intègre le numéro de version Debian. Pour Debian 12 (Bookworm) :

wget https://repo.zabbix.com/zabbix/7.4/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
sudo dpkg -i zabbix-release_latest+debian12_all.deb
sudo apt update

Pour Debian 11, remplacez debian12 par debian11 ; pour Debian 13, par debian13.

Version indépendante de la release :

. /etc/os-release
wget -qO /tmp/zabbix-release.deb \
  "https://repo.zabbix.com/zabbix/7.4/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian${VERSION_ID}_all.deb"
sudo dpkg -i /tmp/zabbix-release.deb
sudo apt update

Si wget est absent — fréquent sur une installation minimale :

sudo apt install -y wget

Étape 2 : installer l'agent

sudo apt install -y zabbix-agent2

Le paquet crée l'utilisateur système zabbix, installe l'unité systemd et dépose la configuration dans /etc/zabbix/.

Étape 3 : configurer l'agent

sudo nano /etc/zabbix/zabbix_agent2.conf

Les directives essentielles :

# Serveur autorisé à interroger cet agent (mode passif)
Server=192.168.1.10
 
# Serveur vers lequel l'agent pousse ses métriques (mode actif)
ServerActive=192.168.1.10
 
# Doit correspondre EXACTEMENT au nom d'hôte défini côté serveur Zabbix
Hostname=srv-db-01
 
LogFile=/var/log/zabbix/zabbix_agent2.log
LogFileSize=10

Le piège du Hostname

Hostname doit être strictement identique au champ « Nom d'hôte » de l'hôte créé côté serveur. Une casse différente et les vérifications actives ne remontent jamais, sans erreur explicite.

Pour reprendre le nom du système :

HostnameItem=system.hostname

Mode actif ou passif

• Passif (Server=) : le serveur interroge l'agent sur le port 10050 — nécessite que le système soit joignable.
• Actif (ServerActive=) : l'agent pousse ses données, aucun port entrant à ouvrir. À privilégier pour tout système distant.

Étape 4 : chiffrer la liaison avec une clé PSK

openssl rand -hex 32 | sudo tee /etc/zabbix/zabbix_agent2.psk > /dev/null
sudo chown zabbix:zabbix /etc/zabbix/zabbix_agent2.psk
sudo chmod 600 /etc/zabbix/zabbix_agent2.psk

Puis dans la configuration :

TLSConnect=psk
TLSAccept=psk
TLSPSKIdentity=PSK-srv-db-01
TLSPSKFile=/etc/zabbix/zabbix_agent2.psk

Reportez la clé et l'identité dans l'onglet Chiffrement de l'hôte côté serveur. Une identité distincte par système est nécessaire : une clé partagée compromise expose l'ensemble du parc.

Étape 5 : filtrer le port 10050

Uniquement en mode passif. Debian n'installe pas UFW par défaut ; avec nftables :

sudo nft add rule inet filter input tcp dport 10050 ip saddr 192.168.1.10 accept

Avec UFW, s'il est installé :

sudo ufw allow from 192.168.1.10 to any port 10050 proto tcp

En mode actif, aucune règle entrante n'est requise.

Étape 6 : démarrer et vérifier

sudo systemctl enable --now zabbix-agent2
sudo systemctl status zabbix-agent2

Testez des métriques localement :

zabbix_agent2 -t agent.version
zabbix_agent2 -t system.cpu.load[all,avg1]
zabbix_agent2 -t vfs.fs.size[/,pfree]

Consultez le journal :

sudo tail -f /var/log/zabbix/zabbix_agent2.log

Messages d'erreur courants

Pour les métriques lisant les journaux système :

sudo usermod -aG adm zabbix
sudo systemctl restart zabbix-agent2

Debian ou Ubuntu : ce qui change

Les deux distributions partagent apt et la même structure de configuration. Les différences pratiques :

Le reste de la procédure — configuration, PSK, vérification — est identique. Voir le guide Ubuntu si votre parc mélange les deux.

Superviser plusieurs serveurs Debian

Sur un parc de plusieurs dizaines de systèmes, la procédure manuelle devient coûteuse : dépôt, paquet, configuration, clé PSK unique, création de l'hôte, report de la clé. Les approches classiques sont Ansible, cloud-init au provisionnement, ou l'auto-enregistrement Zabbix avec actions et métadonnées configurées côté serveur.

La même installation avec Logiserv

Logiserv s'appuie sur ce même moteur Zabbix et automatise l'ensemble. Depuis la page Agent du tableau de bord :

curl -sSL "https://www.logiserv.app/api/agent-script/linux?token=..." | sudo bash

Le script détecte la distribution via /etc/os-release, ajoute le dépôt, installe le paquet, génère une clé PSK unique, écrit la configuration, crée l'hôte côté serveur avec les bons templates, ajuste les permissions et démarre le service.

Installation manuelle ou Logiserv

Distributions reconnues

Debian, Ubuntu, Raspberry Pi OS, RHEL, Rocky, AlmaLinux, Amazon Linux, SLES

Détection automatique via /etc/os-release, sans paramètre à fournir.

Chiffrement

PSK unique par système

Clé de 32 octets générée à l'enrôlement, jamais partagée entre deux hôtes.

Port entrant requis

Aucun

Mode actif : seul le trafic sortant vers le serveur est nécessaire.

Sauvegarde de configuration

Automatique

Toute configuration existante est copiée en .bak horodaté avant réécriture.

Le fonctionnement de la page Agent est détaillé dans la documentation Logiserv.

Pour aller plus loin

• Installer Zabbix Agent 2 : le guide par système — vue d'ensemble et autres OS
• Installer Zabbix Agent sur Ubuntu — la distribution la plus proche
• Installer Zabbix Agent sur Rocky Linux et AlmaLinux — la famille RHEL
• Installer Zabbix Agent sur Raspberry Pi — Raspberry Pi OS repose sur Debian
• Pourquoi superviser un serveur Linux — ce que la supervision détecte avant l'incident
• Quelles métriques surveiller sur un serveur — construire son plan de supervision