Installation de l'interface web

Cette section fournit des instructions étape par étape pour installer l'interface web Zabbix. Suivez ces étapes après avoir installé le backend Zabbix - le serveur Zabbix, l'agent et la base de données.

L'interface Zabbix est écrite en PHP, donc pour l'exécuter, un serveur web prenant en charge PHP est nécessaire.

Installation wizard

To install the web interface, open the Zabbix frontend URL in a browser:

  • For Apache: http://<server_ip_or_name>/zabbix
  • For NGINX: http://<server_ip_or_name>

Écran de bienvenue

Ouvrez l'URL de l'interface Zabbix dans le navigateur :

  • Pour Apache : http://<server_ip_or_name>/zabbix
  • Pour Nginx : http://<server_ip_or_name>

Vous devriez voir le premier écran de l'assistant d'installation de l'interface.

Utilisez la liste déroulante Default language pour modifier la langue par défaut du système et poursuivre le processus d'installation dans la langue sélectionnée (facultatif). Pour plus d'informations, consultez Installation de langues supplémentaires pour l'interface.

Notez que le fait de définir la langue sur English (en_US) activera également le format de date et d'heure américain dans l'interface.

Vérification des prérequis

Assurez-vous que tous les prérequis obligatoires de l'interface Zabbix sont satisfaits.

Pré-requis Valeur minimale Description
Version de PHP 8.2.0
Option PHP memory_limit 128MB Dans php.ini : memory_limit = 128M
Option PHP post_max_size 16MB Dans php.ini : post_max_size = 16M
Option PHP upload_max_filesize 2MB Dans php.ini : upload_max_filesize = 2M
Option PHP max_execution_time 300 secondes Dans php.ini : max_execution_time = 300 (les valeurs 0 et -1 sont également autorisées)
Option PHP max_input_time 300 secondes Dans php.ini : max_input_time = 300 (les valeurs 0 et -1 sont également autorisées)
Prise en charge des bases de données PHP L'une des suivantes : MySQL, PostgreSQL Voir Requirements pour la liste de toutes les extensions PHP obligatoires et facultatives. Notez que les prérequis facultatifs non satisfaits sont affichés avec un statut Warning en rouge, et que le processus d'installation peut continuer même s'ils ne sont pas remplis.
PHP bcmath doit être activé
PHP mbstring doit être activé
Option PHP session.auto_start doit être désactivée Dans php.ini : session.auto_start = 0
Option PHP arg_separator.output & Dans php.ini : arg_separator.output = "&" (la valeur "&amp;" est également autorisée)

Si l'utilisateur Apache ou le groupe d'utilisateurs doit être modifié, vérifiez les permissions du dossier de session ; sinon, l'installation de Zabbix peut ne pas pouvoir continuer.

Configurer la connexion à la base de données

Saisissez les détails de connexion à la base de données. La base de données Zabbix doit déjà être créée.

Pour MySQL, saisir localhost ou laisser le champ Hôte de la base de données vide entraîne une connexion via le socket Unix par défaut. Le formulaire d'installation ne fournit pas de champ distinct Socket de la base de données ; pour utiliser un socket personnalisé, configurez-le dans les paramètres du serveur Zabbix (par exemple, avec DBSocket= dans zabbix_server.conf). Cela permet de conserver l'interface alignée sur les paramètres de connexion serveur-base de données.

Pour PostgreSQL, le champ Hôte de la base de données peut contenir plusieurs entrées hôte:port séparées par des virgules. La chaîne est découpée en parties et chaque port est validé de la même manière que le champ Port de la base de données. Après validation réussie, la chaîne est analysée en hôtes et ports afin de construire la chaîne de connexion. Si aucun port n'est défini pour un hôte dans la liste séparée par des virgules, la valeur de Port de la base de données est utilisée comme port par défaut. Si le champ Hôte de la base de données est laissé vide, le socket de domaine Unix par défaut est utilisé. Si un chemin de socket est saisi (par exemple, /var/run/pgbouncer), ce socket de domaine Unix sera utilisé à la place.

Si l'option Chiffrement TLS de la base de données est cochée, des champs supplémentaires pour configurer la connexion TLS à la base de données apparaissent dans le formulaire (MySQL ou PostgreSQL uniquement).

Si Stocker les identifiants dans est défini sur HashiCorp Vault ou CyberArk Vault, des paramètres supplémentaires seront disponibles :

  • pour HashiCorp Vault : point de terminaison de l'API Vault, préfixe du coffre-fort, chemin du secret, et jeton d'authentification ou AppRole ;

  • pour CyberArk Vault : point de terminaison de l'API Vault, préfixe du coffre-fort, chaîne de requête du secret et certificats. Lorsque la case Certificats Vault est cochée, deux nouveaux champs permettant de spécifier les chemins du fichier de certificat SSL et du fichier de clé SSL apparaissent.

Paramètres

La saisie d'un nom pour le serveur Zabbix est facultative, toutefois, s'il est renseigné, il sera affiché dans la barre de menu et dans les titres des pages.

Définissez le fuseau horaire et le thème par défaut pour l'interface.

Si l'option Encrypt connections from Web interface est cochée, des champs supplémentaires pour configurer la connexion TLS entre le serveur Zabbix et l'interface apparaissent dans le formulaire.

Résumé de la préinstallation

Consultez un résumé des paramètres.

La sous-page affichera les données si une configuration TLS a été ajoutée.

Installation

Si vous installez Zabbix à partir des sources, téléchargez le fichier de configuration et placez-le dans conf/ du sous-répertoire des documents HTML du serveur web où vous avez copié les fichiers PHP de Zabbix.

À condition que l'utilisateur du serveur web dispose des droits d'écriture sur le répertoire conf/, le fichier de configuration sera enregistré automatiquement et il sera possible de passer immédiatement à l'étape suivante.

Terminez l'installation.

Connexion

L'interface Zabbix est prête ! Le nom d'utilisateur par défaut est Admin, le mot de passe est zabbix.

Passez au guide de surveillance Linux.

Frontend configuration file

After installation, you can reconfigure the Zabbix frontend by updating parameters in the zabbix.conf.php frontend configuration file.

The default path to the configuration file depends on the operating system and Zabbix installation method:

  • For installation from packages: /usr/share/zabbix/ui/conf/zabbix.conf.php
  • For installation from sources: /var/www/html/zabbix/conf/zabbix.conf.php
  • For appliance: /etc/zabbix/web/zabbix.conf.php

See the configuration file options for details on configuring the Zabbix frontend.