Instalación de la interfaz web

Esta sección proporciona instrucciones paso a paso para instalar la interfaz web de Zabbix. Siga estos pasos después de haber instalado el backend de Zabbix: Zabbix server, agent y base de datos.

El frontend de Zabbix está escrito en PHP, por lo que para ejecutarlo se necesita un servidor web compatible con PHP.

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>

Pantalla de bienvenida

Abra la URL del frontend de Zabbix en el navegador:

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

Debería ver la primera pantalla del asistente de instalación del frontend.

Use el menú desplegable Default language para cambiar el idioma predeterminado del sistema y continuar el proceso de instalación en el idioma seleccionado (opcional). Para obtener más información, consulte Instalación de idiomas adicionales del frontend.

Tenga en cuenta que establecer el idioma en English (en_US) también habilitará el formato de fecha y hora de EE. UU. en el frontend.

Comprobación de prerrequisitos

Asegúrese de que se cumplan todos los prerrequisitos obligatorios del frontend de Zabbix.

Prerrequisito Valor mínimo Descripción
Versión de PHP 8.2.0
Opción de PHP memory_limit 128MB En php.ini: memory_limit = 128M
Opción de PHP post_max_size 16MB En php.ini: post_max_size = 16M
Opción de PHP upload_max_filesize 2MB En php.ini: upload_max_filesize = 2M
Opción de PHP max_execution_time 300 segundos En php.ini: max_execution_time = 300 (también se permiten los valores 0 y -1)
Opción de PHP max_input_time 300 segundos En php.ini: max_input_time = 300 (también se permiten los valores 0 y -1)
Compatibilidad de bases de datos de PHP Una de: MySQL, PostgreSQL Consulte Requirements para ver la lista de todas las extensiones de PHP obligatorias y opcionales. Tenga en cuenta que los prerrequisitos opcionales fallidos se muestran con un estado rojo de Warning, y el proceso de instalación puede continuar aunque no se cumplan.
PHP bcmath debe estar habilitado
PHP mbstring debe estar habilitado
Opción de PHP session.auto_start debe estar deshabilitada En php.ini: session.auto_start = 0
Opción de PHP arg_separator.output & En php.ini: arg_separator.output = "&" (también se permite el valor "&amp;")

Si es necesario cambiar el usuario o el grupo de usuarios de Apache, verifique los permisos de la carpeta de sesiones; de lo contrario, la instalación de Zabbix podría no poder continuar.

Configurar la conexión a la base de datos

Introduzca los detalles para conectarse a la base de datos. La base de datos de Zabbix debe haberse creado previamente.

Para MySQL, al introducir localhost o dejar vacío el campo Database host se establece la conexión mediante el socket Unix predeterminado. El formulario de configuración no proporciona un campo independiente Database socket, por lo que, para usar un socket personalizado, configúrelo en los ajustes del server de Zabbix (por ejemplo, con DBSocket= en zabbix_server.conf). Esto mantiene el frontend alineado con los ajustes de conexión entre el server y la base de datos.

Para PostgreSQL, el campo Database host puede contener varias entradas host:port separadas por comas. La cadena se divide en partes y cada puerto se valida de la misma manera que el campo Database port. Tras una validación correcta, la cadena se analiza en hosts y puertos para formar la cadena de conexión. Si no se define un puerto para un host en la lista separada por comas, se usa como puerto predeterminado el valor de Database port. Si el campo Database host se deja vacío, se usa el socket de dominio Unix predeterminado. Si se introduce una ruta de socket (por ejemplo, /var/run/pgbouncer), se usará ese socket de dominio Unix en su lugar.

Si la opción Database TLS encryption está marcada, aparecerán en el formulario campos adicionales para configurar la conexión TLS a la base de datos (solo MySQL o PostgreSQL).

Si Store credentials in está configurado en HashiCorp Vault o CyberArk Vault, estarán disponibles parámetros adicionales:

  • para HashiCorp Vault: endpoint de la API de Vault, prefijo de Vault, ruta del secreto y token de autenticación o AppRole;

  • para CyberArk Vault: endpoint de la API de Vault, prefijo de Vault, cadena de consulta del secreto y certificados. Al marcar la casilla Vault certificates, aparecerán dos nuevos campos para especificar las rutas del archivo de certificado SSL y del archivo de clave SSL.

Configuración

Introducir un nombre para Zabbix server es opcional; sin embargo, si se proporciona, se mostrará en la barra de menú y en los títulos de las páginas.

Establezca la zona horaria y el tema predeterminados para el frontend.

Si la opción Encrypt connections from Web interface está marcada, aparecerán en el formulario campos adicionales para configurar la conexión TLS entre Zabbix server y frontend.

Resumen de preinstalación

Revise un resumen de la configuración.

La subpágina mostrará los datos si se ha añadido la configuración TLS.

Instalar

Si instala Zabbix desde el código fuente, descargue el archivo de configuración y colóquelo en conf/ dentro del subdirectorio de documentos HTML del servidor web donde copió los archivos PHP de Zabbix.

Siempre que el usuario del servidor web tenga permisos de escritura en el directorio conf/, el archivo de configuración se guardará automáticamente y será posible continuar de inmediato con el siguiente paso.

Finalice la instalación.

Iniciar sesión

¡El frontend de Zabbix está listo! El nombre de usuario predeterminado es Admin, la contraseña es zabbix.

Continúe con la guía de supervisión de 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.