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>
您应该会看到前端安装向导的第一个界面。
使用 默认语言 下拉菜单更改系统默认语言,并以所选语言继续安装过程(可选)。 有关更多信息,请参见安装其他前端语言。
请注意,将语言设置为 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 = "&"(也允许使用值 "&") |
如果需要更改 Apache 用户或用户组,请验证会话文件夹的权限;否则,Zabbix 安装程序可能无法继续。
配置 DB 连接
输入用于连接数据库的详细信息。 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 端点、vault 前缀、secret 路径和认证令牌;
-
对于 CyberArk Vault:Vault API 端点、vault 前缀、secret 查询字符串和证书。 勾选 Vault certificates 复选框后,将出现两个新字段,用于指定 SSL 证书文件和 SSL 密钥文件的路径。

设置
为 Zabbix server 输入名称是可选的,不过如果填写,该名称将显示在菜单栏和页面标题中。
为前端设置默认时区和主题。
如果勾选了 加密来自 Web 界面的连接 选项,则表单中会出现用于配置 TLS 连接的附加字段,用于 Zabbix server 和前端之间的连接。

安装前摘要
查看设置摘要。

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

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


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

登录
Zabbix 前端已准备就绪!默认用户名为 Admin,密码为 zabbix。

继续阅读 Linux 监控指南。