Installation agent Zabbix passif (Linux)

Auteur : [‘Gautier RAYEROUX’] | Date : 2026-04-08 00:00:00

Installation d’un agent Zabbix passif sur Linux

Prérequis

OS : Debian 12/13 ou Ubuntu 22.04/24.04
Accès root ou sudo
Connectivité réseau avec le serveur Zabbix
Port 10050/TCP ouvert en entrée sur la machine cible

1. Ajouter le dépôt Zabbix

Debian 12

wget https://repo.zabbix.com/zabbix/7.2/release/debian/pool/main/z/zabbix-release/zabbix-release_latest_7.2+debian12_all.deb
dpkg -i zabbix-release_latest_7.2+debian12_all.deb
apt update

Ubuntu 22.04

wget https://repo.zabbix.com/zabbix/7.2/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest_7.2+ubuntu22.04_all.deb
dpkg -i zabbix-release_latest_7.2+ubuntu22.04_all.deb
apt update

2. Installer l’agent Zabbix

apt install -y zabbix-agent

3. Configurer l’agent

Éditer le fichier de configuration :

nano /etc/zabbix/zabbix_agentd.conf

Paramètres essentiels

Paramètre	Valeur	Description
`Server`	IP du serveur Zabbix	Adresse autorisée à interroger l’agent (mode passif)
`ServerActive`	(laisser vide ou commenter)	Non utilisé en mode purement passif
`Hostname`	Nom de l’hôte (identique à Zabbix UI)	Doit correspondre exactement au nom défini dans l’interface
`ListenPort`	`10050`	Port d’écoute de l’agent (défaut)
`ListenIP`	`0.0.0.0`	Interface d’écoute (toutes par défaut)

Exemple de configuration minimale

# Serveur Zabbix autorisé à interroger l'agent
Server=192.168.1.10

# Désactiver les checks actifs (mode passif uniquement)
# ServerActive=

# Nom de l'hôte tel que déclaré dans Zabbix
Hostname=srv-web-01

# Port d'écoute
ListenPort=10050

4. Ouvrir le port pare-feu

Avec UFW (Ubuntu/Debian)

ufw allow 10050/tcp
ufw reload

Avec firewalld (RHEL/CentOS)

firewall-cmd --permanent --add-port=10050/tcp
firewall-cmd --reload

Avec iptables

iptables -A INPUT -p tcp --dport 10050 -s 192.168.1.10 -j ACCEPT

5. Démarrer et activer le service

systemctl enable zabbix-agent
systemctl start zabbix-agent
systemctl status zabbix-agent

La sortie doit afficher active (running).

6. Vérifier le bon fonctionnement

Tester la connectivité depuis le serveur Zabbix

Sur le serveur Zabbix, utiliser zabbix_get pour interroger l’agent :

# Installation de zabbix-get si absent
apt install zabbix-get

# Test de récupération d'une métrique
zabbix_get -s 192.168.1.50 -p 10050 -k agent.version

Remplacer 192.168.1.50 par l’IP de la machine cible.

Une réponse du type 7.2.x confirme que l’agent répond correctement.

Vérifier les logs de l’agent

tail -f /var/log/zabbix/zabbix_agentd.log

7. Ajouter l’hôte dans l’interface Zabbix

Se connecter à l’interface web Zabbix
Aller dans Monitoring → Hosts → Create host
Renseigner les champs :

Champ	Valeur
Host name	Identique au `Hostname` du fichier de conf
Templates	`Linux by Zabbix agent` (ou équivalent)
Host groups	Groupe approprié
Interfaces	Ajouter une interface Agent avec l’IP de la machine
Port	`10050`

Cliquer sur Add

Dépannage

Symptôme	Cause possible	Solution
Icône rouge dans Zabbix	Agent inaccessible	Vérifier pare-feu et service
`Connection refused`	Service arrêté	`systemctl start zabbix-agent`
`Cannot connect to`	IP serveur incorrecte dans `Server=`	Corriger `zabbix_agentd.conf`
Données manquantes	`Hostname` ne correspond pas	Harmoniser le nom hôte
`zabbix_get` timeout	Port 10050 bloqué	Vérifier les règles firewall