Installer Zabbix 7.0 LTS sur Debian 13

Installer Zabbix, c'est installer quatre choses sur une même machine : la base de données (MariaDB), le serveur Zabbix, son interface web (PHP avec Apache) et un agent pour que le serveur se supervise lui-même. Ce chapitre suit l'installation de Zabbix 7.0 LTS sur Debian 13 depuis le dépôt officiel, du choix de la VM à la première connexion, puis les réglages de sécurité et les pannes d'installation les plus courantes.

Préparer la machine

Chez Sorbier, srv-journaux est une VM du cluster Proxmox VE. Pour une infrastructure de quelques dizaines d'hôtes :

Donne-lui une adresse fixe (192.168.10.180/28, passerelle 192.168.10.190, DNS 192.168.10.177 et 192.168.10.181) et un nom résolu par le DNS de l'annuaire (srv-journaux.ad.sorbier.example). Règle surtout l'heure : les déclencheurs, les journaux et les rapports de disponibilité n'ont de sens que si toutes les horloges sont justes.

sudo timedatectl set-timezone Europe/Paris
# chrony, synchronisé sur les contrôleurs de domaine
sudo apt install chrony
echo "server 192.168.10.177 iburst" | sudo tee /etc/chrony/sources.d/sorbier.sources
echo "server 192.168.10.181 iburst" | sudo tee -a /etc/chrony/sources.d/sorbier.sources
# on n'utilise que les contrôleurs de domaine : désactive le pool Internet de Debian
sudo sed -i 's/^pool /#pool /' /etc/chrony/chrony.conf
sudo systemctl restart chrony
chronyc sources          # les deux serveurs doivent apparaître, l'un marqué ^*

Ajouter le dépôt officiel de Zabbix

Debian fournit un paquet Zabbix, mais dans une version qui suit le rythme de Debian, pas celui de l'éditeur. On utilise le dépôt officiel, qui livre chaque version corrective de la 7.0 LTS. Le paquet zabbix-release installe la clé de signature et la ligne du dépôt :

wget https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest_7.0+debian13_all.deb
sudo dpkg -i zabbix-release_latest_7.0+debian13_all.deb
sudo apt update

Puis les paquets :

sudo apt install zabbix-server-mysql zabbix-frontend-php zabbix-apache-conf zabbix-sql-scripts zabbix-agent2
sudo apt install mariadb-server

Créer la base de données

Sous Debian, le compte root de MariaDB s'authentifie par le système (unix_socket) : sudo mariadb ouvre une session sans mot de passe. Crée la base et un compte dédié, avec un mot de passe long :

-- sudo mariadb
CREATE DATABASE zabbix CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
CREATE USER 'zabbix'@'localhost' IDENTIFIED BY 'Zbx-Sorbier-Base-2026!';
GRANT ALL PRIVILEGES ON zabbix.* TO 'zabbix'@'localhost';
SET GLOBAL log_bin_trust_function_creators = 1;
QUIT;

• utf8mb4 et utf8mb4_bin sont les seuls réglages pris en charge : avec une collation insensible à la casse, SRV-WEB et srv-web seraient confondus, et Zabbix signale l'erreur dans son journal et dans l'interface ;
• le compte n'a de droits que sur la base zabbix, et seulement en local (droits et moindre privilège) ;
• log_bin_trust_function_creators autorise temporairement l'import des déclencheurs SQL du schéma ; on le remet à 0 juste après.

Importe le schéma et les données initiales (quelques minutes : la base contient déjà les modèles officiels) :

zcat /usr/share/zabbix-sql-scripts/mysql/server.sql.gz | mariadb --default-character-set=utf8mb4 -uzabbix -p zabbix
sudo mariadb -e "SET GLOBAL log_bin_trust_function_creators = 0;"

Configurer et démarrer le serveur

Dans /etc/zabbix/zabbix_server.conf, les lignes DBName=zabbix et DBUser=zabbix sont déjà bonnes. Renseigne le mot de passe :

# /etc/zabbix/zabbix_server.conf
DBPassword=Zbx-Sorbier-Base-2026!

Ce fichier est lisible par le groupe zabbix seulement : ne le copie pas dans un ticket ou une capture d'écran. Démarre les services et active-les au démarrage :

sudo systemctl restart zabbix-server zabbix-agent2 apache2
sudo systemctl enable zabbix-server zabbix-agent2 apache2
systemctl status zabbix-server --no-pager
sudo ss -lntp | grep -E ':10050|:10051'

Le serveur doit écouter sur 10051, l'agent sur 10050. Le journal du serveur, /var/log/zabbix/zabbix_server.log, doit se terminer par des lignes de démarrage de ses processus, sans cannot connect to the database.

L'assistant de l'interface web

Ouvre http://192.168.10.180/zabbix depuis le poste d'administration. L'assistant compte six étapes.

1. Welcome : choisis la langue. Le français n'apparaît que si la locale fr_FR.UTF-8 existe sur le serveur. Sinon, lance sudo dpkg-reconfigure locales, coche fr_FR.UTF-8 UTF-8, puis sudo systemctl restart apache2 et recharge la page.
2. Check of pre-requisites : tout doit être OK. Une ligne en rouge désigne un module PHP manquant ou un réglage, que le paquet zabbix-apache-conf règle normalement.
3. Configure DB connection : Database type MySQL, Database host localhost, Database port 0 (le port par défaut), Database name zabbix, User zabbix, le mot de passe. Laisse Database TLS encryption décoché : la connexion est locale, par socket.
4. Settings : Zabbix server name « Sorbier — supervision » (affiché en haut de chaque page), Default time zone Europe/Paris, le thème.
5. Pre-installation summary : relis.
6. Install : l'assistant écrit /etc/zabbix/web/zabbix.conf.php.

Connecte-toi avec le compte Admin, mot de passe zabbix.

Sécuriser l'installation

• HTTPS. L'interface transporte des mots de passe : publie-la en HTTPS avec un certificat de l'autorité interne (AD CS dans le cours Windows Server). Avec Apache : sudo a2enmod ssl, sudo a2ensite default-ssl, puis dans /etc/apache2/sites-available/default-ssl.conf les lignes SSLCertificateFile et SSLCertificateKeyFile vers ton certificat et sa clé, et sudo systemctl reload apache2. Redirige ensuite le port 80 vers 443.
• Les flux. Seul le VLAN ADMIN joint l'interface web (TCP 443). Le port 10051 n'est ouvert qu'aux agents actifs et aux proxys qui en ont besoin, le port 162 qu'aux équipements qui envoient des traps.
• L'authentification. Zabbix 7.0 sait authentifier par LDAP (l'annuaire de Sorbier), par SAML et propose l'authentification à deux facteurs (Users > Authentication, onglet MFA settings). Active-la au moins pour les comptes Super admin.
• Les sauvegardes. La configuration est dans la base : sauvegarde-la (mariadb-dump --single-transaction zabbix), avec /etc/zabbix/, et teste la restauration (cours Sauvegarde et PRA).
• Les mises à jour. sudo apt update && sudo apt upgrade installe les versions correctives de la 7.0. Lis les notes de version avant, et prends un instantané.

Dépanner une installation

Et avec Docker ?

Zabbix publie des images officielles pour chaque composant (zabbix/zabbix-server-mysql, zabbix/zabbix-web-nginx-mysql, zabbix/zabbix-agent2, zabbix/zabbix-proxy-sqlite3…), avec des étiquettes par version, par exemple 7.0-alpine-latest. Le dépôt zabbix-docker de l'éditeur fournit des fichiers Compose prêts à l'emploi. C'est rapide pour une maquette, mais pour ton épreuve l'installation par paquets se justifie et s'explique plus facilement : chaque fichier de configuration est à sa place habituelle. Le cours Docker présente Compose.

Exercices

2481:20261103:101512.402 Starting Zabbix Server. Zabbix 7.0.32.
2481:20261103:101512.409 [Z3001] connection to database 'zabbix' failed: [1045] Access denied for user 'zabbix'@'localhost' (using password: NO)
2481:20261103:101512.409 database is down: reconnecting in 10 seconds