// travaux pratiques · Administration système
TP01 - Installer le serveur et l’interface web Zabbix
- TP 1 / 7
- 8 étapes
- ≈ 60 min
- Accès libre
Objectif : installer un serveur Zabbix 8.0 LTS complet (serveur, base MariaDB, interface web sous Nginx et PHP-FPM) sur une machine Debian 12, puis se connecter à l’interface et sécuriser le compte administrateur.
Contexte
Dans une PME, la supervision est souvent installée « quand il y a eu une panne ». La bonne démarche est inverse : on monte le serveur de supervision avant d’en avoir besoin, sur une machine dédiée, avec une version à support long (LTS) pour ne pas devoir migrer tous les six mois. Zabbix 8.0 LTS, sortie le 5 novembre 2026, bénéficie d’un support complet jusqu’au 30 novembre 2029 et d’un support limité jusqu’au 30 novembre 2031, ce qui en fait le bon choix pour une nouvelle installation.
À la fin de ce TP, vous saurez ajouter le dépôt officiel Zabbix, créer la base de données avec le bon jeu de caractères, importer le schéma, configurer le serveur et le site web, puis valider l’installation depuis l’assistant de l’interface. Ce serveur servira de socle à tous les TP suivants.
Prérequis : une machine virtuelle zbx-srv sous Debian 12 (2 vCPU, 4 Go de RAM, 20 Go de disque suffisent pour le laboratoire), une adresse IP fixe sur le réseau du lab (dans ce cours : 192.168.56.10 sur un réseau privé 192.168.56.0/24), un accès root ou sudo et un accès Internet sortant vers repo.zabbix.com.
Durée estimée : 60 minutes.
Actions à réaliser
1. Mettre le système à jour et installer MariaDB
Zabbix stocke sa configuration, son historique et ses événements dans une base relationnelle. Debian 12 fournit MariaDB 10.11, une version comprise dans la plage supportée par Zabbix 8.0 (MariaDB 10.11 à 13.0). On installe le serveur de base de données avant Zabbix, car la documentation demande qu’il soit « up and running » avant la création du schéma.
apt update && apt full-upgrade -y
apt install -y mariadb-server wget
systemctl enable --now mariadb
Résultat attendu : systemctl status mariadb indique l’état active (running).
2. Ajouter le dépôt officiel Zabbix 8.0
Les paquets fournis par Debian sont souvent en retard de plusieurs versions. Le paquet zabbix-release installe la définition du dépôt officiel et sa clé de signature, ce qui garantit des mises à jour authentifiées.
wget https://repo.zabbix.com/zabbix/8.0/release/debian/pool/main/z/zabbix-release/zabbix-release_latest_8.0+debian12_all.deb
dpkg -i zabbix-release_latest_8.0+debian12_all.deb
apt update
Résultat attendu : la sortie d’apt update mentionne désormais repo.zabbix.com sans erreur de signature. Sur Debian 13, le nom du fichier se termine par +debian13_all.deb.
3. Installer le serveur, l’interface et l’agent 2
On installe le serveur compilé pour MySQL/MariaDB, l’interface PHP, la configuration Nginx prête à l’emploi, les scripts SQL du schéma et l’agent 2, qui supervisera le serveur Zabbix lui-même.
apt install -y zabbix-server-mysql zabbix-frontend-php zabbix-nginx-conf zabbix-sql-scripts zabbix-agent2
Le paquet zabbix-nginx-conf installe aussi Nginx et PHP-FPM comme dépendances. Résultat attendu : les fichiers /etc/zabbix/zabbix_server.conf et /etc/zabbix/nginx.conf existent.
4. Créer la base de données et l’utilisateur
Le jeu de caractères utf8mb4 avec la collation utf8mb4_bin est exigé : une autre collation provoque des erreurs ou des comparaisons de chaînes incorrectes. Remplacez password par un mot de passe robuste que vous noterez dans votre coffre-fort.
mysql -uroot -p
create database zabbix character set utf8mb4 collate utf8mb4_bin;
create user zabbix@localhost identified by 'password';
grant all privileges on zabbix.* to zabbix@localhost;
set global log_bin_trust_function_creators = 1;
quit;
L’option log_bin_trust_function_creators autorise temporairement la création des fonctions et déclencheurs SQL contenus dans le schéma. L’utilisateur zabbix n’a de droits que sur la base zabbix et ne peut se connecter qu’en local.
5. Importer le schéma initial
Le schéma, les données de base et les modèles fournis sont livrés compressés par le paquet zabbix-sql-scripts.
zcat /usr/share/zabbix/sql-scripts/mysql/server.sql.gz | mysql --default-character-set=utf8mb4 -uzabbix -p zabbix
L’import prend une à quelques minutes et ne doit afficher aucune erreur. Désactivez ensuite l’option temporaire :
mysql -uroot -p -e "set global log_bin_trust_function_creators = 0;"
6. Configurer le serveur et le site web
Le serveur doit connaître le mot de passe de la base. Dans /etc/zabbix/zabbix_server.conf, renseignez la directive :
DBPassword=password
Dans /etc/zabbix/nginx.conf, décommentez et adaptez les directives listen et server_name :
listen 8080;
server_name zbx-srv.lab.local;
Le port 8080 évite tout conflit avec le site Nginx par défaut. Résultat attendu : nginx -t répond que la syntaxe est correcte.
7. Démarrer les services et terminer l’assistant web
systemctl restart zabbix-server zabbix-agent2 nginx php8.2-fpm
systemctl enable zabbix-server zabbix-agent2 nginx php8.2-fpm
Ouvrez http://192.168.56.10:8080 dans un navigateur. L’assistant vérifie les prérequis PHP, demande les paramètres de connexion à la base (hôte localhost, base zabbix, utilisateur zabbix et son mot de passe), puis le nom du serveur et le fuseau horaire (Europe/Paris). Connectez-vous ensuite avec le compte par défaut Admin / zabbix.
Résultat attendu : le tableau de bord Global view s’affiche et le widget d’état du système indique que le serveur Zabbix est en cours d’exécution.
8. Changer immédiatement le mot de passe Admin
Le couple Admin / zabbix est public. Dans User settings > Profile, cliquez sur Change password et définissez un mot de passe long et unique. Créez ensuite votre propre compte nominatif dans Users > Users pour ne plus utiliser le compte générique au quotidien.
Vérification
systemctl is-active zabbix-server zabbix-agent2 nginx php8.2-fpm mariadbrenvoieactivecinq fois.ss -tlnp | grep -E ':10051|:10050|:8080'montre le serveur à l’écoute sur 10051, l’agent sur 10050 et Nginx sur 8080.- Dans Monitoring > Hosts, l’hôte Zabbix server existe ; son icône de disponibilité ZBX passe au vert après quelques minutes.
- La connexion avec l’ancien mot de passe
zabbixest refusée.
Problèmes fréquents
- Le serveur Zabbix ne démarre pas. Symptôme :
systemctl status zabbix-serveraffiche failed. Cause la plus courante :DBPasswordabsent ou erroné. Correction : lisez le fichier indiqué pargrep ^LogFile /etc/zabbix/zabbix_server.conf, corrigez le mot de passe et redémarrez le service. - Erreurs pendant l’import du schéma. Symptôme : message sur la création de fonctions ou de déclencheurs. Cause :
log_bin_trust_function_creatorsnon activé ou base créée sansutf8mb4_bin. Correction : supprimez la base, recréez-la avec la bonne collation, réactivez l’option et relancez l’import. - Page Nginx par défaut au lieu de Zabbix. Cause :
listenouserver_namelaissés en commentaire dans/etc/zabbix/nginx.conf. Correction : décommentez-les, testez avecnginx -tet rechargez Nginx. - Erreur 502 Bad Gateway. Cause : le service PHP-FPM est arrêté. Correction :
systemctl restart php8.2-fpm(php8.4-fpmsur Debian 13). - Interface injoignable depuis le poste du stagiaire. Cause : pare-feu local ou mauvaise IP. Correction : ouvrez le port 8080/tcp vers votre réseau d’administration uniquement et vérifiez l’adresse avec
ip a.
Bonnes pratiques et sécurité
- Exécutez
mariadb-secure-installationpour retirer les comptes anonymes et la base de test. - Limitez l’accès à l’interface web au réseau d’administration et, en production, publiez-la en HTTPS (certificat interne ou reverse proxy).
- Protégez
/etc/zabbix/zabbix_server.conf, qui contient le mot de passe de la base : il ne doit pas être lisible par tous. - Sauvegardez la base
zabbixdès maintenant ; c’est elle qui contient toute votre configuration.
Questions de contrôle
1. Pourquoi la base doit-elle être créée en utf8mb4 avec la collation utf8mb4_bin ?
Voir la réponse
C’est l’exigence de Zabbix : le schéma et les comparaisons de chaînes sensibles à la casse reposent sur ce jeu de caractères et cette collation binaire.
2. À quoi sert le paquet zabbix-release ?
Voir la réponse
Il déclare le dépôt officiel Zabbix 8.0 et sa clé de signature dans APT, ce qui permet d’installer puis de mettre à jour les paquets officiels.
3. Quel port le serveur Zabbix écoute-t-il, et pour quels clients ?
Voir la réponse
Le port TCP 10051, utilisé notamment par les agents actifs, les proxys, zabbix_sender et l’interface web.
Pour aller plus loin
Pour une vue d’ensemble de l’outil et de ses usages, relisez l’article Zabbix : un outil puissant de supervision. Si vous hébergez le lab sur un hyperviseur, le cours Introduction à Proxmox VE explique comment préparer les machines virtuelles et prendre un instantané avant chaque TP. La documentation officielle détaille aussi l’installation avec PostgreSQL et TimescaleDB pour les gros volumes.
Conservez la machine zbx-srv : elle est utilisée dans tous les TP suivants.
// formation sur mesure
Former votre équipe sur ce sujet ?
Azur Secure anime des sessions intra-entreprise, à distance ou dans vos locaux sur la Côte d'Azur, adaptées au niveau de vos équipes.