Web 前端安装

本节提供安装 Zabbix Web 前端的分步说明。 在您已安装 Zabbix 后端 - Zabbix 服务器、agent 和数据库之后,请按照以下步骤进行。

Zabbix 前端使用 PHP 编写,因此需要一个支持 PHP 的 web 服务器来运行它。

您可以通过参考这些最佳实践了解有关为 Zabbix 前端设置 SSL 的更多信息。

欢迎界面

在浏览器中打开 Zabbix 前端 URL:

  • 对于 Apache:http://<server_ip_or_name>/zabbix
  • 对于 Nginx:http://<server_ip_or_name>

您应该会看到前端安装向导的第一个界面。

使用 Default language 下拉菜单更改系统默认语言,并以所选语言继续安装过程(可选)。 有关更多信息,请参见 安装其他前端语言

请注意,将语言设置为 English (en_US) 也会在前端中启用美国日期/时间格式。

先决条件检查

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

先决条件 最小值 说明
PHP 版本 8.2.0
PHP 选项 memory_limit 128MB php.ini 中:memory_limit = 128M
PHP 选项 post_max_size 16MB php.ini 中:post_max_size = 16M
PHP 选项 upload_max_filesize 2MB php.ini 中:upload_max_filesize = 2M
PHP 选项 max_execution_time 300 php.ini 中:max_execution_time = 300(也允许值 0-1
PHP 选项 max_input_time 300 php.ini 中:max_input_time = 300(也允许值 0-1
PHP 数据库支持 以下之一:MySQL、PostgreSQL 有关所有必需和可选 PHP 扩展的列表,请参见 Requirements。请注意,未满足的可选先决条件会以红色 Warning 状态显示,即使它们未满足,安装过程仍可继续。
PHP BCMath 必须启用
PHP mbstring 必须启用
PHP 选项 mbstring.func_overload 必须禁用 php.ini 中:mbstring.func_overload = 0
PHP 选项 session.auto_start 必须禁用 php.ini 中:session.auto_start = 0
PHP 选项 arg_separator.output & php.ini 中:arg_separator.output = "&"(也允许值 "&amp;"

如果需要更改 Apache 用户或用户组,请检查会话文件夹的权限;否则,Zabbix 安装程序可能无法继续。

配置数据库连接

输入用于连接数据库的详细信息。
Zabbix 数据库必须已创建。

对于 MySQL,输入 localhost 或将 Database host 字段留空时,将通过默认的 Unix socket 进行连接。
安装表单不提供单独的 Database socket 字段,因此如需使用自定义 socket,请在 Zabbix 服务器设置中进行配置(例如,在 zabbix_server.conf 中使用 DBSocket=)。
这样可以使前端与服务器到数据库的连接设置保持一致。

对于 PostgreSQL,Database host 字段可以包含多个以逗号分隔的 host:port 条目。
该字符串会被拆分为多个部分,并且每个端口都会以与 Database port 字段相同的方式进行验证。
验证成功后,该字符串会被解析为主机和端口,以生成连接字符串。
如果逗号分隔列表中的某个主机未定义端口,则使用 Database port 的值作为默认端口。
如果 Database host 字段留空,则使用默认的 Unix 域 socket。
如果输入了 socket 路径(例如,/var/run/pgbouncer),则会改用该 Unix 域 socket。

如果勾选了 Database TLS encryption 选项,表单中将出现用于配置到数据库的 TLS 连接的附加字段(仅适用于 MySQL 或 PostgreSQL)。

如果 Store credentials in 设置为 HashiCorp Vault 或 CyberArk Vault,则会提供以下附加参数:

  • 对于 HashiCorp Vault:Vault API endpoint、vault prefix、secret path,以及 authentication token 或 AppRole;

  • 对于 CyberArk Vault:Vault API endpoint、vault prefix、secret query string 和 certificates。
    勾选 Vault certificates 复选框后,将出现两个新字段,用于指定 SSL certificate file 和 SSL key file 的路径。

设置

为 Zabbix server 输入名称是可选的,不过如果填写,该名称将显示在菜单栏和页面标题中。

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

如果勾选了 加密来自 Web 界面的连接 选项,则表单中会出现用于配置 TLS 连接的附加字段,用于 Zabbix server 和前端之间的连接。

安装前摘要

查看设置摘要。

如果已添加 TLS 配置,该子页面将显示相关数据。

安装

如果从源代码安装 Zabbix,请下载配置文件,并将其放置到你复制 Zabbix PHP 文件所在的 webserver HTML 文档子目录中的 conf/ 下。

如果 webserver 用户对 conf/ 目录具有写入权限,配置文件将自动保存,并且可以立即继续下一步。

完成安装。

登录

Zabbix 前端已准备就绪!默认用户名是 Admin,密码是 zabbix

继续查看 Linux 监控指南