1 概述
概述
Administration > General 部分包含多个子部分,用于设置前端相关的默认值并自定义 Zabbix。
可用子部分列表会在 Administration 菜单部分中点击 General 后显示。 也可以通过使用左上角的标题下拉菜单在各子部分之间切换。
GUI
本节介绍若干与前端相关的默认设置的自定义。

配置参数:
| Parameter | Description |
|---|---|
| Default language | 未在个人资料中指定语言的用户和访客用户的默认语言。 有关更多信息,请参见安装附加前端语言。 |
| Default time zone | 未在个人资料中指定时区的用户和访客用户的默认时区。 |
| Default theme | 未在个人资料中指定主题的用户和访客用户的默认主题。 |
| Limit for search and filter results | 将在 web 前端列表中显示的元素(行)最大数量,例如在 Data collection > Hosts 中。 注意:如果设置为例如“50”,则在所有受影响的前端列表中只会显示前 50 个元素。如果某个列表包含超过 50 个元素,则会在 "Displaying 1 to 50 of 50+ found" 中以“+”号提示。此外,如果使用了过滤且匹配项仍然超过 50 个,则也只会显示前 50 个。 请注意,提高此参数的值可能会导致性能下降,并增加 web 服务器端的内存消耗。 |
| Max number of columns and rows in overview tables |
在 Data overview 和 Trigger overview 仪表板小部件中显示的最大列数和行数。列和行都适用相同的限制。如果存在的行数和/或列数多于显示数量,系统会在表格底部显示警告:“Not all results are displayed. Please provide more specific search criteria.” |
| Max count of elements to show inside table cell |
对于显示在单个表格单元格中的条目,这里配置的显示数量不会超过上限。 |
| Show warning if Zabbix server is down | 启用此参数后,如果无法连接到 Zabbix 服务器(可能已停止运行),浏览器窗口中将显示警告消息。即使用户向下滚动页面,该消息也会保持可见。将鼠标悬停其上时,该消息会临时隐藏,以显示其下方内容。 |
| Working time | 此全局参数定义工作时间。在图形中,工作时间显示为白色背景,非工作时间显示为灰色。 有关时间格式的说明,请参见时间段规范页面。 支持用户宏。 |
| Show technical errors | 勾选后,所有已注册用户都可以看到技术错误(PHP/SQL)。未勾选时,这些信息仅对Zabbix 超级管理员以及所属用户组启用了调试模式的用户可见。 |
| Max history display period | 在 Monitoring > Latest data、主机web 场景信息(位于 Monitoring > Hosts)以及 Data overview 仪表板小部件中显示历史数据的最长时间范围。 允许范围:24 小时(默认)- 1 周。支持时间后缀,例如 1w(1 周)、36h(36 小时)。 |
| Time filter default period | 图形和仪表板默认使用的时间范围。允许范围:1 分钟 - 10 年(默认:1 小时)。 支持时间后缀,例如 10m(10 分钟)、5w(5 周)。 注意:当用户在查看图形时更改时间范围后,该时间范围会作为用户偏好保存,并替换全局默认值或用户之前的选择。 |
| Max period for time selector | 图形和仪表板可用的最大时间范围。用户将无法查看更早的数据。允许范围:1 年 - 10 年(默认:2 年)。 支持时间后缀,例如 1y(1 年)、365w(365 周)。 |
自动注册
在本节中,您可以为主动 agent 自动注册配置加密级别。

带星号的参数为必填项。
配置参数:
| Parameter | Description |
|---|---|
| 加密级别 | 选择一个或两个加密级别选项: 无加密 - 允许未加密连接 PSK - 允许使用预共享密钥的 TLS 加密连接 |
| PSK 标识 | 输入预共享密钥标识字符串。 仅当将 'PSK' 选为 加密级别 时,此字段才可用。 请勿在 PSK 标识中放入敏感信息,因为它会通过网络以未加密方式传输,用于告知接收方应使用哪个 PSK。 |
| PSK | 输入预共享密钥(偶数个十六进制字符)。 最大长度:如果 Zabbix 使用 GnuTLS 或 OpenSSL 库,则为 512 个十六进制数字(256 字节 PSK);如果 Zabbix 使用 mbed TLS(PolarSSL)库,则为 64 个十六进制数字(32 字节 PSK)。 示例:1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 仅当将 'PSK' 选为 加密级别 时,此字段才可用。 |
另请参见:安全自动注册
超时
在本节中,可以设置全局监控项类型超时和网络超时。 此表单中的所有字段均为必填。

| 参数 | 说明 | |
|---|---|---|
| 监控项类型超时 | 等待受监控监控项响应的秒数(基于其类型)。 允许范围:1 - 600 秒(默认值:3 秒;Browser 监控项类型的默认值:60 秒)。 支持时间后缀,例如 30s、1m,以及用户宏。 支持的监控项类型: - Zabbix agent(被动和主动检查均支持) - Simple check( icmpping*、vmware.* 监控项除外)- SNMP agent(仅适用于 SNMP walk[OID] 和 get[OID] 监控项)- External check - Database monitor - HTTP agent - SSH agent - TELNET agent - Script - Browser 请注意,如果使用了 proxy 且已配置超时,则 proxy 的超时设置将覆盖全局设置。如果为特定监控项设置了超时,则它们将覆盖 proxy 和全局设置。 |
|
| UI 的网络超时 | ||
| 通信 | 在关闭空闲 socket 之前等待的秒数(如果此前已建立与 Zabbix 服务器的连接,但前端在此时间内无法完成数据读取/发送操作,则连接将被断开)。允许范围:1 - 300 秒(默认值:3 秒)。 | |
| 连接 | 停止尝试连接到 Zabbix 服务器之前等待的秒数。允许范围:1 - 30 秒(默认值:3 秒)。 | |
| 媒体类型测试 | 测试媒体类型时等待响应的秒数。允许范围:1 - 300 秒(默认值:65 秒)。 | |
| 脚本执行 | 执行脚本时等待响应的秒数。允许范围:1 - 300 秒(默认值:60 秒)。 此超时适用于整个脚本执行链,其长度可能各不相同。例如,如果脚本在 agent 上执行,则它是经由服务器(可能还包括 proxy)到 agent 再返回的往返过程。 对于在 agent 上执行的脚本,将适用服务器或proxy超时。 对于仅在主动 agent 上执行的脚本,通常需要提高默认的服务器/proxy 超时。服务器/proxy 超时必须高于主动检查刷新频率,否则在主动 agent 甚至收到脚本之前,服务器/proxy 超时就可能已被超过。 另请参见:脚本超时 |
|
| 监控项测试 | 测试监控项时等待返回数据的秒数。允许范围:1 - 600 秒(默认值:60 秒)。 | |
| 计划报告测试 | 测试计划报告时等待返回数据的秒数。允许范围:1 - 300 秒(默认值:60 秒)。 | |
图像
图像部分显示 Zabbix 中可用的所有图像。 图像存储在数据库中。

Type 下拉列表允许您在图标和背景图像之间切换:
- 图标用于显示 network map 元素。
- 背景用于作为 network map 的背景图像。
添加图像
您可以通过单击右上角的 Create icon 或 Create background 按钮来添加自己的图像。

图像属性:
| Parameter | Description |
|---|---|
| Name | 图像的唯一名称。 |
| Upload | 从本地系统中选择要上传到 Zabbix 的文件(PNG、JPEG、GIF 或 WebP)。 Note:也可能可以上传其他格式,这些格式会在上传过程中转换为 PNG。图像处理使用 GD 库,因此支持的格式取决于所使用的库版本(Zabbix 需要 2.0.28 或更高版本)。 |
上传文件的最大大小受 ZBX_MAX_IMAGE_SIZE 的值限制,该值为 1024x1024 字节或 1 MB。
如果图像大小接近 1 MB,并且 max_allowed_packet MySQL 配置参数为默认的 1MB,则图像上传可能会失败。
在这种情况下,请增大 max_allowed_packet 参数。
图标映射
本节允许创建某些主机与某些图标之间的映射。 使用主机清单字段信息来创建该映射。
随后,这些映射可在网络地图配置中使用,以便自动为匹配的主机分配合适的图标。
要创建新的图标映射,请点击右上角的 Create icon map。
![]()
配置参数:
| Parameter | Description |
|---|---|
| Name | 图标映射的唯一名称。 |
| Mappings | 映射列表。映射的顺序决定其优先级。您可以通过拖放在列表中上下移动映射。 |
| Inventory field | 用于查找匹配项的主机清单字段。 |
| Expression | 描述匹配条件的正则表达式。 |
| Icon | 如果找到与表达式匹配的项,则使用该图标。 |
| Default | 要使用的默认图标。 |
正则表达式
本节允许创建自定义正则表达式,这些表达式可在前端的多个位置使用。 有关详细信息,请参见 正则表达式 部分。
触发器显示选项
本节允许自定义触发器状态在前端中的显示方式,以及 触发器严重性 的名称和颜色。

| Parameter | Description |
|---|---|
| Use custom event status colors | 勾选此参数可启用已确认/未确认问题的颜色自定义。 |
| Unacknowledged PROBLEM events, Acknowledged PROBLEM events, Unacknowledged RESOLVED events, Acknowledged RESOLVED events |
输入新的颜色代码,或单击颜色,从提供的调色板中选择新的颜色。 如果勾选了 blinking 复选框,触发器在状态变更后会闪烁一段时间,以便更醒目。 |
| Display OK triggers for | 显示 OK 触发器的时间段。允许范围:0 - 24 小时。支持 时间后缀,例如 5m、2h、1d。 |
| On status change triggers blink for | 触发器闪烁的持续时间。允许范围:0 - 24 小时。支持 时间后缀,例如 5m、2h、1d。 |
| Not classified, Information, Warning, Average, High, Disaster |
用于替代系统默认值显示的自定义严重性名称和/或颜色。 输入新的颜色代码,或单击颜色,从提供的调色板中选择新的颜色。 请注意,此处输入的自定义严重性名称将用于所有语言环境。如果需要为某些用户将其翻译为其他语言,请参见 自定义触发器严重性 页面。 |
地理地图
本节允许选择地理地图瓦片服务提供商,并为 Geomap 仪表板小部件 配置服务提供商设置。
为了通过地理地图提供可视化,Zabbix 使用开源的 JavaScript 交互式地图库 Leaflet。
请注意,Zabbix 无法控制第三方瓦片提供商提供的图像质量,包括预定义的瓦片提供商。

| Parameter | Description |
|---|---|
| Tile provider | 从可用的瓦片服务提供商中选择一个,或选择 Other 以添加其他瓦片提供商或自托管瓦片(参见 使用自定义瓦片服务提供商)。 |
| Tile URL | 用于在地理地图上加载并显示瓦片图层的 URL 模板(最多 2048 个字符)。 仅当 Tile provider 设置为 Other 时,此字段才可编辑。 支持以下占位符: {s} 表示可用子域名之一; {z} 表示 URL 中的缩放级别参数; {x} 和 {y} 表示瓦片坐标; {r} 可用于在 URL 中添加 "\@2x",以加载 retina 瓦片。 示例: https://{s}.example.com/{z}/{x}/{y}{r}.png |
| Attribution text | 要显示在地图上小文本框中的瓦片提供商署名文本。仅当 Tile provider 设置为 Other 时,此字段可见。 |
| Max zoom level | 地图的最大缩放级别。仅当 Tile provider 设置为 Other 时,此字段才可编辑。 |
使用自定义瓦片服务提供商
Geomap 小组件能够从自定义的自托管或第三方瓦片提供商服务加载栅格瓦片图像。 要使用自定义的第三方瓦片提供商服务,或自托管的瓦片文件夹或服务器,请在 Tile provider 字段中选择 Other,并在 Tile URL 字段中使用正确的占位符指定自定义 URL。
模块
本节允许管理自定义的以及内置的 frontend modules。

点击 扫描目录 以注册/取消注册任何自定义模块。
已注册的模块将出现在列表中;未注册的模块将从列表中移除。
点击列表中的模块状态以启用/禁用模块。
您还可以通过在列表中选择多个模块,然后点击列表下方的 启用/禁用 按钮来批量启用/禁用模块。
点击列表中的模块名称可在弹出窗口中查看其 details。

模块状态也可以在模块详情弹出窗口中更新;为此,请勾选/取消勾选 已启用 复选框,然后点击 更新。
您可以按名称或状态(已启用/已禁用)筛选模块。
连接器
此部分允许配置用于通过 HTTP 将 Zabbix 数据流式传输到外部系统的连接器。

点击 Create connector 以配置新的连接器。
您可以按名称或状态(启用/禁用)筛选连接器。 在列表中点击连接器状态即可启用/禁用该连接器。 您还可以在列表中选择多个连接器,然后点击列表下方的 Enable/Disable 按钮来批量启用/禁用连接器。
其他
本节用于配置其他杂项前端参数。

| Parameter | Description |
|---|---|
| 前端 URL | Zabbix web interface 的 URL(最长 2048 个字符)。 此参数供 Zabbix web service 用于与前端通信,应进行设置以启用计划报告。 |
| 发现的主机所属组 | 通过网络发现和agent 自动注册发现的主机将自动放入此处选择的主机组中。 |
| 默认主机清单模式 | 主机清单的默认模式。当 server 或前端创建新的主机或主机原型时,都会使用该模式,除非在主机发现/自动注册期间通过设置主机清单模式操作进行了覆盖。 |
| 数据库宕机消息的用户组 | 用于发送数据库宕机告警消息的用户组。 Zabbix server 依赖后端数据库的可用性。没有数据库,它无法工作。如果数据库宕机,Zabbix 可以通知所选用户。通知将使用已启用的用户媒介发送到此处设置的用户组。通知通过以下媒介类型传输(启用时):电子邮件;SMS;自定义告警脚本。即使配置并启用了 webhook 媒介项,也不会触发通知。 Zabbix server 不会停止;它会等待数据库恢复后继续处理。 通知内容如下: [MySQL|PostgreSQL|Oracle] database <DB Name> [on <DB Host>: <DB Port>] is not available: <error message depending on the type of DBMS (database)>如果 <DB Host> 定义为空值,则不会将其添加到消息中;如果 <DB Port> 为默认值("0"),则也不会添加。告警管理器(Zabbix server 的一个特殊进程)会每 10 秒尝试与数据库建立新的连接。如果数据库仍然宕机,告警管理器会重复发送告警,但频率不会高于每 15 分钟一次。 |
| 记录不匹配的 SNMP trap | 如果未找到对应的 SNMP 接口,则记录 SNMP trap。 |
授权
| Parameter | Description |
|---|---|
| 登录尝试次数 | 在登录可能被阻止之前,登录失败的次数。 |
| 登录阻止间隔 | 当超过 登录尝试次数 限制时,禁止登录的时间段。允许范围:30 - 3600 秒。支持 时间后缀,例如 90s、5m、1h。 |
密钥存储
Vault provider 参数允许选择用于存储 user macro 值的密钥管理软件。 支持的选项:
- HashiCorp Vault(默认)
- CyberArk Vault
另请参见:密钥存储。
安全
| 参数 | 描述 |
|---|---|
| Validate URI schemes | 取消勾选此复选框将禁用URI方案验证(默认启用)。 如果勾选,您可以指定允许的URI方案的逗号分隔列表(默认:http,https,ftp,file,mailto,tel,ssh)。适用于前端中使用URI的所有字段(例如,地图元素URL)。 |
| Use X-Frame-Options HTTP header | 取消勾选此复选框将禁用HTTP X-Frame-options头(不推荐)。 如果勾选,您可以指定HTTP X-Frame-options头的值。支持的值: SAMEORIGIN(默认)或'self'(必须用单引号括起)- 页面只能在与其自身来源相同的框架中显示; DENY或'none'(必须用单引号括起)- 页面无法在框架中显示,无论尝试显示的站点是什么; 空格分隔的主机名string;在列表中添加'self'(必须用单引号括起)允许页面在其自身来源的框架中显示。 请注意,使用没有单引号的'self'或'none'将被视为主机名。 |
| Use iframe sandboxing | 取消勾选此复选框将禁用将检索到的URL内容放入沙箱(不推荐)。 如果勾选,您可以指定iframe沙箱例外情况;未指定的限制仍将适用。如果此字段为空,则应用所有沙箱属性限制。 有关更多信息,请参见 sandbox属性的描述。 |