Web 前端安装

本节介绍如何安装 Zabbix 前端。 请在安装 Zabbix 后端后执行以下步骤。

Zabbix 前端使用 PHP 编写，需要使用已配置 PHP 的受支持 Web 服务器，例如 Apache 或 NGINX。 有关所需软件和库的信息，请参阅前端的要求。

如需在 Zabbix Web 前端中使用英语以外的语言，必须在 Web 服务器上安装相应的区域设置，以及 PHP gettext 扩展。 请注意，更改语言可能会改变时间/日期格式。

如需为 Zabbix 前端设置 SSL，请参阅为 Zabbix 前端设置 SSL。

安装向导

要安装前端，请在浏览器中打开 Zabbix 前端 URL：

  • 对于 Apache：http://<server_ip_or_name>/zabbix
  • 对于 NGINX：http://<server_ip_or_name>
欢迎界面

前端安装向导会打开欢迎界面。

系统范围的默认语言为英语（en_US），并使用美国的时间/日期格式。 要更改系统范围的默认语言，请从默认语言下拉菜单中选择所需的语言。

单击下一步按钮继续。

先决条件检查

确保满足所有必需的 Zabbix 前端先决条件。

有关所需和可选 PHP 扩展、所需 PHP 版本以及支持的数据库列表，请参阅要求。

请注意，未满足的可选先决条件会显示为警告状态，即使这些条件未满足，安装过程仍可继续。

Web 服务器所使用的 php.ini 文件中，PHP 配置指令的必需值：

memory_limit = 128M ; 最小值
post_max_size = 16M ; 最小值
upload_max_filesize = 2M ; 最小值
max_execution_time = 300 ; 最小值，也允许使用 0 和 -1
max_input_time = 300 ; 最小值，也允许使用 0 和 -1
session.auto_start = 0 ; 必须禁用
arg_separator.output = "&" ; 也允许使用 "&amp;"

如果需要更改 Web 服务器用户或组，请确认新用户或组对 PHP 会话目录具有所需的权限；否则，Zabbix 安装程序可能无法继续。

如果所有必需的先决条件均已满足，请继续下一步。

配置数据库连接

输入连接数据库的详细信息。

如果 Database host 字段留空，则使用默认的 Unix 域套接字。

对于 MySQL，在 Database host 字段中输入 localhost 也会通过默认的 Unix 域套接字建立连接。 向导不提供配置数据库套接字的选项。要使用自定义套接字，请在 Zabbix 服务器设置中进行配置（例如，在 Zabbix 服务器配置文件（zabbix_server.conf）中使用 DBSocket= 参数）。 这样可以确保前端与服务器到数据库的连接设置保持一致。

对于 PostgreSQL，Database host 字段可以包含多个以逗号分隔的 host:port 条目。 该字符串会被拆分为多个部分，并按照与 Database port 字段相同的方式验证每个端口。 验证成功后，系统会将该字符串解析为主机和端口，以构造连接字符串。 如果逗号分隔的列表中某个主机未定义端口，则使用 Database port 的值作为默认端口。 如果指定了套接字路径（例如 /var/run/pgbouncer），则改用该 Unix 域套接字。

要配置与数据库的安全连接，请选中 Database TLS encryption 复选框，然后转到前端到数据库配置相关字段。 在以下情况下，Database TLS encryption 复选框处于禁用状态：

  • 对于 MySQL，Database host 设置为 localhost。
  • 对于 PostgreSQL，Database host 字段的值以斜杠开头，或该字段为空。

要配置 Zabbix 从 HashiCorp Vault 获取机密，请在 Store credentials in 中选择 HashiCorp Vault，然后转到HashiCorp 配置填写展开的字段。 要配置 Zabbix 从 CyberArk Vault 获取机密，请在 Store credentials in 中选择 CyberArk Vault，然后转到CyberArk 配置填写展开的字段。

设置

输入 Zabbix 服务器名称是可选的；但是，如果提交了名称，该名称将显示在菜单栏和页面标题中。

为前端设置默认时区和主题。

要配置 Zabbix 前端与 Zabbix 服务器之间的 TLS 连接，请选中加密来自 Web 界面的连接复选框，然后继续配置 TLS 连接，填写展开的字段。

安装前摘要

查看设置摘要。

如果已配置 TLS，向导将显示其详细信息。

安装

如果 Web 服务器用户对 conf/ 目录具有写入权限，配置文件将自动保存，您可以立即继续下一步。

如果 Web 服务器用户对 conf/ 目录没有写入权限，您必须下载配置文件，并将其放置在 Web 服务器 HTML 文档目录下的 conf/ 目录中，即您复制 Zabbix PHP 文件的位置。

完成安装。

登录

使用默认凭据登录：

  • 用户名：Admin
  • 密码：zabbix

前端配置文件

安装后，您可以通过更新 zabbix.conf.php 前端配置文件中的参数来重新配置 Zabbix 前端。

配置文件的默认路径取决于操作系统和 Zabbix 的安装方式：

  • 从软件包安装：/usr/share/zabbix/ui/conf/zabbix.conf.php
  • 从源代码安装：/var/www/html/zabbix/conf/zabbix.conf.php
  • 使用 appliance：/etc/zabbix/web/zabbix.conf.php

有关配置 Zabbix 前端的详细信息，请参阅配置文件选项。