1 Web 界面安装
本节提供了安装 Zabbix Web 界面的分步说明。
在您安装完 Zabbix 后端——Zabbix 服务器、agent 和数据库之后,请按照以下步骤操作。
Zabbix 前端使用 PHP 编写,因此运行它需要一个支持 PHP 的 Web 服务器。
您可以参考这些最佳实践,了解有关为 Zabbix 前端 设置 SSL 的更多信息。
欢迎界面
在浏览器中打开 Zabbix 前端 URL。 如果您是通过软件包安装 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 = "&"(也允许使用值 "&") |
如果需要更改 Apache 用户或用户组,请验证会话文件夹的权限;否则,Zabbix 安装程序可能无法继续。
配置数据库连接
输入连接数据库所需的详细信息。
Zabbix 数据库必须已事先创建。
对于 MySQL,输入 localhost 或将数据库主机字段留空,将通过默认的 Unix socket 进行连接。
安装表单不提供单独的数据库 socket字段,因此如需使用自定义 socket,请在 Zabbix 服务器设置中进行配置(例如,在 zabbix_server.conf 中使用 DBSocket=)。这样可使前端与服务器到数据库的连接设置保持一致。
对于 PostgreSQL,如果将数据库主机字段留空,则使用默认的 Unix-domain socket。
如果输入了 socket 路径(例如 /var/run/pgbouncer),则将改为使用该 Unix-domain socket。

如果选中数据库 TLS 加密选项,则表单中会显示用于配置到数据库的 TLS 连接的附加字段(仅适用于 MySQL 或 PostgreSQL)。
如果将凭据存储于设置为 HashiCorp Vault 或 CyberArk Vault,则会显示附加参数:
-
对于 HashiCorp Vault:Vault API 端点、vault 前缀、secret 路径和认证令牌;
-
对于 CyberArk Vault:Vault API 端点、vault 前缀、secret 查询字符串和证书。
选中Vault 证书复选框后,将显示两个新字段,用于指定 SSL 证书文件和 SSL 密钥文件的路径。

设置
输入 Zabbix 服务器名称是可选的,不过如果已提交,它将显示在菜单栏和页面标题中。
为前端设置默认的时区和主题。
如果选中 Encrypt connections from Web interface 选项,则表单中会显示用于配置 Zabbix 服务器与前端之间 TLS 连接的附加字段。

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

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

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


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

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

继续阅读 Linux 监控指南。