1 常规
概述
管理 → 常规 部分包含多个子部分, 用于设置与前端相关的默认值并自定义 Zabbix。
按下 管理 菜单部分中的 常规 后, 将显示可用子部分的列表。也可以使用左上角标题下拉菜单 在各个子部分之间切换。
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 |
在 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 Super Admins和所属用户组启用了调试模式的用户可见。 |
| Max history display period | 在 Monitoring > Latest data 中显示历史数据、在 Monitoring > Hosts 中显示主机 web scenario 信息,以及在 Top items 仪表板小部件中显示数据时允许的最大时间段。 允许范围: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 |
|---|---|
| Encryption level | 选择一种或两种加密级别选项: No encryption - 允许未加密连接 PSK - 允许使用预共享密钥的 TLS 加密连接 |
| PSK identity | 输入预共享密钥标识字符串。 仅当 Encryption level 选择了“PSK”时,此字段才可用。 请勿在 PSK 标识中填写敏感信息,因为它会通过网络以未加密方式传输,用于告知接收方应使用哪个 PSK。 |
| PSK | 输入预共享密钥(十六进制字符数必须为偶数)。 最大长度:如果 Zabbix 使用 GnuTLS 或 OpenSSL 库,则为 512 个十六进制数字(256 字节 PSK);如果 Zabbix 使用 mbed TLS (PolarSSL) 库,则为 64 个十六进制数字(32 字节 PSK)。 示例:1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 仅当 Encryption level 选择了“PSK”时,此字段才可用。 |
另请参见:安全自动注册
超时
在本节中,可以设置全局监控项类型超时和网络超时。 此表单中的所有字段均为必填项。

| 参数 | 描述 | |
|---|---|---|
| 监控项类型超时 | Zabbix 在中止检查前应等待多少秒(取决于其类型)。 更多详细信息和限制,请参见监控项超时。 允许范围:1 - 600s(默认:3s;browser 监控项的默认值:60s)。 支持时间后缀(例如 30s、1m)和用户宏。 请注意,如果已配置 proxy 级别的超时,则会覆盖这些全局设置。此外,如果已为特定监控项 配置超时,则会同时覆盖全局和 proxy 设置。 |
|
| UI 的网络超时 | ||
| 通信 | 在关闭空闲套接字前等待多少秒(如果此前已建立到 Zabbix 服务器的连接,但前端在此时间内无法完成数据读取/发送操作,则该连接将被断开)。允许范围:1 - 300s(默认:3s)。 | |
| 连接 | 在停止尝试连接到 Zabbix 服务器前等待多少秒。允许范围:1 - 30s(默认:3s)。 | |
| 媒体类型测试 | 测试媒体类型时,等待响应的秒数。允许范围:1 - 300s(默认:65s)。 | |
| 脚本执行 | 执行脚本时,等待响应的秒数。允许范围:1 - 300s(默认:60s)。 此超时适用于整个脚本执行链,而该链路的长度可能各不相同。例如,如果脚本在 agent 上执行,则需要经过服务器(也可能还包括 proxy)到 agent 再返回的往返过程。 对于在 agent 上执行的脚本,适用server 或 proxy 超时。 对于仅在主动 agent 上执行的脚本,很可能需要提高默认的 server/proxy 超时。server/proxy 超时必须高于主动检查刷新频率,否则 server/proxy 超时可能会在主动 agent 甚至尚未收到脚本之前就已超出。 另请参见:脚本超时 |
|
| 监控项测试 | 测试监控项时,等待返回数据的秒数。允许范围:1 - 600s(默认:60s)。 | |
| 计划报表测试 | 测试计划报表时,等待返回数据的秒数。允许范围:1 - 300s(默认:60s)。 | |
图片
“图片”部分显示 Zabbix 中所有可用的图片。图片存储在数据库中。

类型 下拉菜单允许您在图标和背景图片之间切换:
- 图标用于显示网络拓扑图元素
- 背景用于作为网络拓扑图的背景图片
添加图片
您可以点击右上角的 创建图标 或 创建背景 按钮来添加自己的图片。

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

| 参数 | 描述 |
|---|---|
| 使用自定义事件状态颜色 | 勾选此参数将启用对已确认/未确认问题颜色的自定义。 |
| 未确认的 PROBLEM 事件, 已确认的 PROBLEM 事件, 未确认的 RESOLVED 事件, 已确认的 RESOLVED 事件 |
输入新的颜色代码,或点击颜色从提供的调色板中选择新颜色。 如果勾选了 blinking 复选框,触发器将在状态变更后闪烁一段时间,以便更醒目。 |
| 显示 OK 触发器的时长 | 显示 OK 触发器的时间段。允许范围:0 - 24 小时。支持 时间后缀,例如 5m、2h、1d。 |
| 状态变更后触发器闪烁时长 | 触发器闪烁的持续时间。允许范围:0 - 24 小时。支持 时间后缀,例如 5m、2h、1d。 |
| 未分类, 信息, 警告, 一般严重, 高严重, 灾难 |
自定义严重性名称和/或颜色,以替代系统默认值显示。 输入新的颜色代码,或点击颜色从提供的调色板中选择新颜色。 请注意,此处输入的自定义严重性名称将在所有语言环境中使用。如果您需要为某些用户将其翻译为其他语言,请参见 自定义触发器严重性 页面。 |
地理地图
本节允许选择地理地图瓦片服务提供商,并为 Geomap 仪表板 部件配置服务提供商设置。 为了使用地理地图提供可视化,Zabbix 使用开源的 JavaScript 交互式地图库 Leaflet。请注意, Zabbix 无法控制第三方瓦片提供商(包括预定义瓦片提供商)所提供图像的质量。

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

点击 Scan directory 以注册/取消注册任何自定义模块。
已注册的模块将显示在列表中;未注册的模块将从列表中移除。
点击列表中的模块状态可启用/禁用模块。
您也可以通过在列表中选择模块,然后点击列表下方的 Enable/Disable 按钮,批量启用/禁用模块。
点击列表中的模块名称,可在弹出窗口中查看其详细信息。

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

点击 创建连接器 以配置新的连接器。
您可以按名称或状态(已启用/已禁用)筛选连接器。点击列表中的连接器状态可启用/禁用连接器。
您也可以在列表中选择多个连接器,然后点击列表下方的 启用/禁用 按钮,批量启用/禁用连接器。
其他
本节允许配置其他杂项前端参数。

| 参数 | 描述 |
|---|---|
| 前端 URL | 指向 Zabbix Web 界面的 URL(最长 2048 个字符)。 此参数由 Zabbix Web 服务用于与前端通信,应指定该参数以启用计划报表。 |
| 已发现主机的组 | 通过网络发现和agent 自动注册发现的主机将自动放入此处所选的主机组中。 |
| 默认主机资产记录模式 | 主机资产记录的默认模式。除非在主机发现/自动注册期间通过 设置主机资产记录模式 操作覆盖,否则每当服务器或前端创建新的主机或主机原型时,都会遵循此模式。 |
| 数据库不可用消息的用户组 | 用于发送告警消息的用户组,或选择“None”。 Zabbix 服务器依赖后端数据库的可用性。没有数据库它将无法工作。如果数据库不可用,Zabbix 可以通知所选用户。通知将使用已启用的用户媒介条目发送到此处设置的用户组。通知通过以下媒介类型发送(启用时):电子邮件;短信;自定义告警脚本。即使配置并启用了 webhook 媒介条目,也不会触发通知。 Zabbix 服务器不会停止;它会等待数据库恢复后再继续处理。 通知包含以下内容: [MySQL|PostgreSQL] 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 服务器中的一个特殊进程)每 10 秒尝试重新建立一次到数据库的连接。如果数据库仍然不可用,告警管理器会重复发送告警,但频率不会超过每 15 分钟一次。 |
| 记录不匹配的 SNMP trap | 如果未找到对应的 SNMP 接口,则记录SNMP trap。 |
授权
| 参数 | 说明 |
|---|---|
| 登录尝试 | 锁定用户前,允许登录失败的次数。 |
| 登录阻止间隔 | 超过登录次数限制时禁止登录的时间段。允许的范围:0 - 3600 秒。支持时间单位,例如 90s、5m、1h。 |
密钥的存储
| Parameter | Description |
|---|---|
| Vault provider | 选择用于存储 用户宏 值的密钥管理软件 - HashiCorp Vault(默认)或 CyberArk Vault。 |
| Resolve secret vault macros by | 按以下方式解析密钥 vault 宏: Zabbix 服务器 - 密钥由 Zabbix 服务器获取,并在需要时转发给 proxy(默认); Zabbix 服务器和 proxy - 密钥由 Zabbix 服务器和 proxy 共同获取,使它们能够独立解析宏。 |
另请参见:密钥的存储。
安全
| 参数 | 说明 |
|---|---|
| 验证 URI 方案 | 取消选中此复选框以禁用 URI 方案验证(默认启用)。 如果选中,则可以指定允许的 URI 方案的逗号分隔列表(默认值:http、https、ftp、file、mailto、tel、ssh)。适用于前端中使用 URI 的所有字段(例如,地图元素 URL)。 |
| 使用 X-Frame-Options HTTP 标头 | 取消选中此复选框以禁用 HTTP X-Frame-options 标头(不推荐)。 如果已标记,则可以指定 HTTP X-Frame-options 标头的值。支持的值: SAMEORIGIN (默认) 或 'self' (必须使用单引号) - 页面只能显示在与页面本身同源(same origin)的框架中; DENY 或 'none' (必须使用单引号) - 无论哪个网站试图这样做,页面都不能在框架中显示; 一串以空格分隔的主机名字符串; 将 'self' (必须使用单引号) 添加到列表中,可以将页面显示在与页面自身同源的框架中。 请注意,使用不带单引号的 'self' 或 'none' 将导致它们被视为主机名。 |
| 使用 iframe 沙盒 | 取消选中此复选框以禁止将检索到的 URL 内容放入沙盒(不推荐)。 如果已选中,则可以指定 iframe 沙盒例外;未指定的限制仍将应用。如果此字段为空,则所有沙盒属性限制均适用。 详情请参阅 sandbox 属性说明. |