Docs

Parameter	Description
AlertScriptsPath	自定义告警脚本的位置。
AllowRoot	允许服务器以“root”身份运行。
AllowSoftwareUpdateCheck	允许 Zabbix UI 从 zabbix.com 接收软件更新信息。
AllowUnsupportedDBVersions	允许服务器使用不受支持的数据库版本。
CacheSize	配置缓存的大小。
CacheUpdateFrequency	此参数决定 Zabbix 以多少秒为间隔执行配置缓存更新。
DBHost	数据库主机名。
DBName	数据库名称。
DBPassword	数据库密码。
DBPort	未使用本地 socket 时的数据库端口。
DBSchema	数据库 schema 名称。用于 PostgreSQL。
DBSocket	MySQL socket 文件的路径。
DBUser	数据库用户。
DBTLSConnect	将此选项设置为指定值会强制使用到数据库的 TLS 连接。
DBTLSCAFile	包含用于数据库证书验证的顶级 CA 证书的文件完整路径名。
DBTLSCertFile	包含用于向数据库进行身份验证的 Zabbix 服务器证书的文件完整路径名。
DBTLSKeyFile	包含用于向数据库进行身份验证的私钥的文件完整路径名。
DBTLSCipher	Zabbix 服务器允许用于 TLS v1.2 及以下 TLS 协议的加密密码列表。仅支持 MySQL。
DBTLSCipher13	Zabbix 服务器允许用于 TLS v1.3 协议的加密密码套件列表。仅支持 MySQL，且从 8.0.16 版本开始支持。
DebugLevel	指定调试级别。
EnableGlobalScripts	在 Zabbix 服务器上启用全局脚本。
ExportDir	以换行分隔 JSON 格式实时导出事件、历史数据和趋势数据的目录。设置后将启用实时导出。
ExportFileSize	每个导出文件的最大大小（字节）。
ExportType	用于实时导出的以逗号分隔的实体类型列表（events、history、trends，默认全部类型）。
ExternalScripts	外部脚本的位置。
Fping6Location	fping6 的位置。
FpingLocation	fping 的位置。
FrontendAllowedIP	允许从前端连接的 IP 地址或 CIDR 范围的逗号分隔列表。
HANodeName	高可用集群节点名称。
HistoryCacheSize	历史缓存的大小。
HistoryIndexCacheSize	历史索引缓存的大小。
HistoryStorageDateIndex	启用对历史存储中历史值的预处理，以便根据日期将值存储到不同索引中。
HistoryStorageURL	历史存储 HTTP[S] URL。
HistoryStorageTypes	要发送到历史存储的值类型逗号分隔列表。
HousekeepingFrequency	此参数决定 Zabbix 以多少小时为间隔执行 housekeeping 过程。
Include	您可以在配置文件中包含单个文件或目录中的所有文件。
JavaGateway	Zabbix Java 网关的 IP 地址（或主机名）。
JavaGatewayPort	Zabbix Java 网关监听的端口。
ListenBacklog	TCP 队列中待处理连接的最大数量。
ListenIP	trapper 应监听的以逗号分隔的 IP 地址列表。
ListenPort	trapper 的监听端口。
LoadModule	服务器启动时要加载的模块。
LoadModulePath	服务器模块所在位置的完整路径。
LogFile	日志文件名称。
LogFileSize	日志文件的最大大小。
LogSlowQueries	决定数据库查询耗时达到多少毫秒后将被记录。
LogType	日志输出类型。
MaxConcurrentChecksPerPoller	每个 HTTP agent poller、agent poller 或 SNMP poller 一次可执行的最大异步检查数。
MaxHousekeeperDelete	在一个 housekeeping 周期中的单个任务内，删除的行数不会超过“MaxHousekeeperDelete”（对应 [tablename]、[field]、[value]）。
NodeAddress	用于覆盖前端连接服务器方式的 IP 或主机名，可选带端口。
PidFile	PID 文件名称。
ProblemHousekeepingFrequency	决定 Zabbix 多久删除已删除触发器对应的问题。
ProxyConfigFrequency	决定 Zabbix 服务器多久向 Zabbix proxy 发送一次配置数据。
ProxyDataFrequency	决定 Zabbix 服务器多久向 Zabbix proxy 请求一次历史数据。
ServiceManagerSyncFrequency	决定 Zabbix 多久同步一次服务管理器的配置。
SMSDevices	允许 Zabbix 服务器使用的 modem 文件逗号分隔列表。
SNMPTrapperFile	用于将数据从 SNMP trap 守护进程传递到服务器的临时文件。
SocketDir	用于存储内部 Zabbix 服务所使用 IPC socket 的目录。
SourceIP	源 IP 地址。
SSHKeyLocation	用于 SSH 检查和动作的公钥与私钥位置。
SSLCertLocation	用于客户端认证的 SSL 客户端证书文件位置。
SSLKeyLocation	用于客户端认证的 SSL 私钥文件位置。
SSLCALocation	覆盖用于 SSL 服务器证书验证的证书颁发机构（CA）文件位置。
StartAgentPollers	预派生的异步 Zabbix agent poller 实例数量。
StartAlerters	预派生的 alerter 实例数量。
StartBrowserPollers	预派生的浏览器监控项 poller 实例数量。
StartConnectors	预派生的 connector worker 实例数量。
StartDBSyncers	预派生的历史同步器实例数量。
StartDiscoverers	预派生的发现 worker 实例数量。
StartEscalators	预派生的 escalator 实例数量。
StartHistoryPollers	预派生的历史 poller 实例数量。
StartHTTPAgentPollers	预派生的异步 HTTP agent poller 实例数量。
StartHTTPPollers	预派生的 HTTP poller 实例数量。
StartIPMIPollers	预派生的 IPMI poller 实例数量。
StartJavaPollers	预派生的 Java poller 实例数量。
StartLLDProcessors	预派生的低级发现（LLD）worker 实例数量。
StartODBCPollers	预派生的 ODBC poller 实例数量。
StartPingers	预派生的 ICMP pinger 实例数量。
StartPollersUnreachable	用于不可达主机（包括 IPMI 和 Java）的预派生 poller 实例数量。
StartPollers	预派生的 poller 实例数量。
StartPreprocessors	预启动的预处理 worker 实例数量。
StartProxyPollers	用于被动 proxy 的预派生 poller 实例数量。
StartReportWriters	预派生的报表写入器实例数量。
StartSNMPPollers	预派生的异步 SNMP poller 实例数量。
StartSNMPTrapper	如果设置为 1，将启动一个 SNMP trapper 进程。
StartTimers	预派生的 timer 实例数量。
StartTrappers	预派生的 trapper 实例数量。
StartVMwareCollectors	预派生的 VMware collector 实例数量。
StatsAllowedIP	外部 Zabbix 实例的 IP 地址列表（以逗号分隔，可选 CIDR 表示法）或 DNS 名称。仅接受来自此处列出地址的统计请求。
Timeout	指定与 Zabbix proxy、agent、web service 建立连接和交换数据，以及执行 SNMP 检查（SNMP `walk[OID]` 和 `get[OID]` 监控项除外）时的等待时长（秒）。
TLSCAFile	包含用于对等端证书验证的顶级 CA 证书的文件完整路径名，用于 Zabbix 组件之间的加密通信。
TLSCertFile	包含服务器证书或证书链的文件完整路径名，用于 Zabbix 组件之间的加密通信。
TLSCipherAll	GnuTLS 优先级字符串或 OpenSSL（TLS 1.2）密码字符串。覆盖基于证书和基于 PSK 加密的默认密码套件选择条件。
TLSCipherAll13	用于 OpenSSL 1.1.1 或更新版本在 TLS 1.3 中的密码字符串。覆盖基于证书和基于 PSK 加密的默认密码套件选择条件。
TLSCipherCert	GnuTLS 优先级字符串或 OpenSSL（TLS 1.2）密码字符串。覆盖基于证书加密的默认密码套件选择条件。
TLSCipherCert13	用于 OpenSSL 1.1.1 或更新版本在 TLS 1.3 中的密码字符串。覆盖基于证书加密的默认密码套件选择条件。
TLSCipherPSK	GnuTLS 优先级字符串或 OpenSSL（TLS 1.2）密码字符串。覆盖基于 PSK 加密的默认密码套件选择条件。
TLSCipherPSK13	用于 OpenSSL 1.1.1 或更新版本在 TLS 1.3 中的密码字符串。覆盖基于 PSK 加密的默认密码套件选择条件。
TLSCRLFile	包含已吊销证书的文件完整路径名。此参数用于 Zabbix 组件之间的加密通信。
TLSFrontendAccept	接受来自前端的哪些传入连接。
TLSFrontendCertIssuer	允许的前端证书签发者。
TLSFrontendCertSubject	允许的前端证书主题。
TLSKeyFile	包含服务器私钥的文件完整路径名，用于 Zabbix 组件之间的加密通信。
TLSListen	控制 trapper socket 上的 TLS。
TmpDir	临时目录。
TrapperTimeout	指定以下操作的超时时间（秒）： - 从 Zabbix proxy 获取历史数据； - 向 Zabbix proxy 发送配置数据； - 在 Zabbix 服务器上执行全局脚本或远程命令。
TrendCacheSize	趋势缓存的大小。
TrendFunctionCacheSize	趋势函数缓存的大小。
UnavailableDelay	决定在不可用期间多久检查一次主机可用性。
UnreachableDelay	决定在不可达期间多久检查一次主机可用性。
UnreachablePeriod	决定主机不可达多少秒后将其视为不可用。
User	将权限降至系统中指定且已存在的用户。
ValueCacheSize	历史值缓存的大小。
Vault	指定 vault 提供程序。
VaultDBPath	指定应通过键获取数据库凭据的位置。
VaultPrefix	vault 路径或查询的自定义前缀。
VaultTLSCertFile	用于客户端认证的 SSL 证书文件名称。
VaultTLSKeyFile	用于客户端认证的 SSL 私钥文件名称。
VaultToken	HashiCorp vault 认证令牌。
VaultURL	vault 服务器 HTTP[S] URL。
VMwareCacheSize	用于存储 VMware 数据的共享内存大小。
VMwareFrequency	从单个 VMware 服务收集数据之间的延迟时间（秒）。
VMwarePerfFrequency	从单个 VMware 服务获取性能计数器统计信息之间的延迟时间（秒）。
VMwareTimeout	vmware collector 等待 VMware 服务响应的最长秒数。
WebDriverURL	WebDriver 接口 HTTP[S] URL。
WebServiceURL	Zabbix web service 的 HTTP[S] URL，格式为 <host:port>/report。

除非明确说明某参数为必填，否则所有参数均为非必填。

请注意：

默认值反映的是守护进程默认值，而不是随附配置文件中的值。
值支持环境变量。
Zabbix 仅支持 UTF-8 编码且不带 BOM 的配置文件。
仅支持以“#”开头且位于行首的注释。

参数详情

AlertScriptsPath

自定义告警脚本的位置（取决于编译时安装变量 datadir）。

默认值：/usr/local/share/zabbix/alertscripts

AllowRoot

允许服务器以“root”身份运行。
如果禁用此参数，且服务器由“root”启动，则服务器将尝试切换为“zabbix”用户。
如果由普通用户启动，则此参数无效。

默认值：0
取值：0 - 不允许；1 - 允许

AllowSoftwareUpdateCheck

允许 Zabbix UI 从 zabbix.com 接收有关软件更新的信息。

默认值：1
值：0 - 不允许；1 - 允许

AllowUnsupportedDBVersions

允许server 使用不受支持的数据库版本。

默认值：0
值：0 - 不允许；1 - 允许

CacheSize

配置缓存的大小，以字节为单位。
用于存储主机、监控项和触发器数据的共享内存大小。

默认值：32M
范围：128K-64G

CacheUpdateFrequency

此参数决定了 Zabbix 以秒为单位执行配置缓存更新的频率。另请参见runtime control选项。

默认值：10
范围：1-3600

DBHost

数据库主机名。
对于 MySQL，localhost 或空字符串将导致使用 socket。对于 PostgreSQL，如果设置为空字符串，则使用默认的 Unix-domain socket；如果设置为路径（例如 /var/run/pgbouncer），则使用指定的 Unix-domain socket。

默认值：localhost

DBName

数据库名称。

必填：是

DBPassword

数据库密码。

如果未使用密码，请将此行注释掉。

DBPort

未使用默认 Unix 域套接字时的数据库端口。³

MySQL 的默认值：3306

PostgreSQL 的默认值：5432

范围：1024-65535

DBSchema

数据库模式名称。用于 PostgreSQL。

DBSocket

MySQL socket 文件的路径。³

DBUser

数据库用户。

DBTLSConnect

将此选项设置为以下值将强制使用 TLS 连接数据库：
required - 使用 TLS 连接
verify_ca - 使用 TLS 连接并验证证书
verify_full - 使用 TLS 连接，验证证书并验证 DBHost 指定的数据库身份是否与其证书匹配

对于 MySQL（从 5.7.11 开始）和 PostgreSQL，支持以下值：required、verify_ca、verify_full。
对于 MariaDB，从版本 10.2.6 开始，支持 required 和 verify_full 值。
默认情况下不设置为任何选项，行为取决于数据库配置。

DBTLSCAFile

包含用于数据库证书验证的顶级 CA 证书的文件的完整路径名。

必需：否（是，如果 DBTLSConnect 设置为 verify_ca 或 verify_full）

DBTLSCertFile

包含用于对数据库进行身份验证的 Zabbix server 证书的文件的完整路径名。

DBTLSKeyFile

包含用于对数据库进行身份验证的私钥的文件的完整路径名。

DBTLSCipher

Zabbix 服务器允许用于 TLS 协议（最高到 TLS v1.2）的加密密码套件列表。
仅支持 MySQL。

DBTLSCipher13

Zabbix 服务器允许用于 TLS v1.3 协议的加密密码套件列表。
仅 MySQL 支持，从 8.0.16 版本开始。

DebugLevel

指定调试级别：
0 - 关于 Zabbix 进程启动和停止的基本信息
1 - 关键信息；
2 - 错误信息；
3 - 警告；
4 - 用于调试（会产生大量信息）；
5 - 扩展调试（会产生更多信息）。
另请参见运行时控制选项。

默认值：3
范围：0-5

EnableGlobalScripts

在 Zabbix 服务器上启用全局脚本。
注意：默认情况下启用全局脚本执行。但是，对于从 Zabbix 7.0 开始的全新安装，EnableGlobalScripts 会被显式设置为 0（禁用）。

默认值：1
取值：0 - 禁用；1 - 启用

ExportDir

用于以换行分隔的 JSON 格式对事件、历史数据和趋势数据进行实时导出的目录。
如果设置了该参数，则启用实时导出。

ExportFileSize

每个导出文件的最大大小，以字节为单位。
如果设置了 ExportDir，则用于轮转。

默认值：1G
范围：1M-1G

ExportType

用于实时导出的以逗号分隔的实体类型列表（events、history、trends）（默认包含所有类型）。

仅在设置了 ExportDir 时有效。
请注意，如果指定了 ExportType，但未设置 ExportDir，则这属于配置错误，服务器将无法启动。

history 和 trends 导出的示例：

ExportType=history,trends

仅导出 events 的示例：

ExportType=events

ExternalScripts

外部脚本的位置（取决于“datadir”编译时安装变量）。

默认值：/usr/local/share/zabbix/externalscripts

Fping6Location

fping6 的位置。请确保 fping6 二进制文件归 root 所有，并设置了 SUID 标志。如果您的 fping 工具能够处理 IPv6 地址，请将其留空（“Fping6Location=”）。

默认值：/usr/sbin/fping6

FpingLocation

fping 的位置。请确保 fping 二进制文件归 root 所有，并设置了 SUID 标志。

默认值：/usr/sbin/fping

FrontendAllowedIP

允许从前端连接的 IP 地址或 CIDR 范围的逗号分隔列表。如果设置了此参数，则仅接受来自此处列出地址的前端连接。默认情况下，前端请求接受所有连接。如果启用了 IPv6 支持，则 '127.0.0.1'、'::127.0.0.1'、'::ffff:127.0.0.1' 被视为等同，且 '::/0' 将允许任何 IPv4 或 IPv6 地址。 '0.0.0.0/0' 可用于允许任何 IPv4 地址。

示例：

FrontendAllowedIP=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

HANodeName

高可用性集群节点名称。
当该值为空时，服务器以独立模式运行，并会创建一个名称为空的节点。

HistoryCacheSize

历史记录缓存的大小，以字节为单位。
用于存储历史数据的共享内存大小。

默认值：16M
范围：128K-16G

HistoryIndexCacheSize

历史索引缓存的大小，以字节为单位。用于为存储在历史缓存中的历史数据建立索引的共享内存大小。索引缓存大约需要 100 字节来缓存一个监控项。

默认值：4M
范围：128K-16G

HistoryStorageDateIndex

启用历史存储中历史值的预处理，以根据日期将值存储在不同的索引中。

默认值：0
值：0 - 禁用；1 - 启用

HistoryStorageURL

历史存储 HTTP[S] URL。此参数用于 Elasticsearch 设置。

HistoryStorageTypes

发送到历史数据存储的值类型列表，以逗号分隔。此参数用于 Elasticsearch 设置。

默认值：uint,dbl,str,log,text,json

HousekeepingFrequency

此参数用于确定 Zabbix 以多少小时为间隔执行 housekeeping 过程。 Housekeeping 是指从数据库中删除过期信息。
注意：为防止 housekeeper 负载过高（例如，当历史数据和趋势数据保留期大幅缩短时），在每个 housekeeping 周期中，对每个监控项删除的过期信息不会超过 4 个 HousekeepingFrequency 小时。因此，如果 HousekeepingFrequency 为 1，则每个周期最多只会删除 4 小时的过期信息（从最旧的条目开始）。
注意：为降低服务器启动时的负载，housekeeping 会在服务器启动 30 分钟后再执行。因此，如果 HousekeepingFrequency 为 1，则服务器启动后的第一次 housekeeping 将在 30 分钟后运行，此后每隔 1 小时重复执行一次。
可通过将 HousekeepingFrequency 设置为 0 来禁用自动 housekeeping。在这种情况下，housekeeping 过程只能通过 housekeeper_execute 运行时控制选项启动，并且在一个 housekeeping 周期中删除的过期信息时间范围为自上一个 housekeeping 周期以来时间段的 4 倍，但不得少于 4 小时，也不得超过 4 天。
另请参见runtime control 选项以及有关 housekeeping procedure 的详细信息。

默认值：1
范围：0-24

Include

您可以在配置文件中包含单个文件，或包含目录中的所有文件。
为了仅包含指定目录中的相关文件，支持使用星号通配符进行模式匹配。
有关限制，请参见特别说明。

示例：

Include=/absolute/path/to/config/files/*.conf

JavaGateway

Zabbix Java 网关的 IP 地址（或主机名）。仅在启动 Java 轮询器时需要。

JavaGatewayPort

Zabbix Java 网关监听的端口。

默认值：10052
范围：1024-32767

ListenBacklog

TCP 队列中待处理连接的最大数量。
默认值是硬编码常量，取决于系统。
支持的最大值取决于系统，过高的值可能会被默默截断为“实现指定的最大值”。

默认值：SOMAXCONN
范围：0 - INT_MAX

ListenIP

Trapper 应监听的逗号分隔 IP 地址列表。
如果缺少此参数，Trapper 将监听所有网络接口。

默认值：0.0.0.0

ListenPort

trapper 的监听端口。

默认值：10051
范围：1024-32767

LoadModule

在服务器启动时要加载的模块。
模块用于扩展服务器的功能。
模块必须位于 LoadModulePath 指定的目录中，或者在模块名称前提供路径。
如果前置路径为绝对路径（以 '/' 开头），则会忽略 LoadModulePath。
格式：
LoadModule=<module.so>
LoadModule=<path/module.so>
LoadModule=</abs_path/module.so>
允许包含多个 LoadModule 参数。

LoadModulePath

服务器模块所在位置的完整路径。默认值取决于编译选项。

LogFile

日志文件的名称。

必填：是，如果 LogType 设置为 file；否则否

LogFileSize

日志文件的最大大小（以 MB 为单位）。
0 - 禁用自动日志轮换。
注意：如果达到日志文件大小限制并且文件轮换失败，无论出于何种原因，现有日志文件都会被截断并重新启动。

默认值：1
范围：0-1024
必填：是，如果 LogType 设置为 file；否则否

LogSlowQueries

确定数据库查询在被记录之前需要多长时间（以毫秒为单位）。
0 - 不记录慢速查询。
此选项从 DebugLevel=3 开始启用。

默认值：0
范围：0-3600000

LogType

日志输出的类型：
file - 将日志写入 LogFile 参数指定的文件；
system - 将日志写入 syslog；
console - 将日志写入标准输出。

默认值：file

MaxConcurrentChecksPerPoller

每个 HTTP agent 轮询器、agent 轮询器或 SNMP 轮询器可同时执行的异步检查的最大数量。
另请参见 StartHTTPAgentPollers、StartAgentPollers 和 StartSNMPPollers。

默认值：1000
范围：1-1000

MaxHousekeeperDelete

表 housekeeper 包含用于 housekeeping 过程的“任务”，格式为：[housekeeperid]、[object]、[objectid]。
在一次 housekeeping 周期中，每个任务从 history、history_str、history_log、history_uint、history_text、history_bin、history_json、trends、trends_uint 和 problem 表中删除的行数不会超过 MaxHousekeeperDelete。
如果设置为 0，则完全不使用限制。在这种情况下，您必须清楚自己在做什么，以免数据库过载。²
此参数仅适用于删除已删除监控项遗留的数据。
另请参见 housekeeping 过程的详细说明。

默认值：5000
范围：0-1000000

NodeAddress

带可选端口的 IP 或主机名，用于覆盖前端连接到服务器的方式。
格式：<address>[:<port>]

如果未设置 IP 或主机名，将使用 ListenIP 的值。如果未设置 ListenIP，将使用值 localhost。
如果未设置端口，将使用 ListenPort 的值。如果未设置 ListenPort，将使用值 10051。

此前端配置中指定的地址可以覆盖此选项。

另请参见：HANodeName 参数；启用高可用性。

默认值：localhost:10051

PidFile

PID 文件的名称。

默认值：/tmp/zabbix_server.pid

ProblemHousekeepingFrequency

确定 Zabbix 将以多长时间间隔（秒）删除已删除触发器的问题。
另请参见清理过程的详细信息。

默认值：60
范围：1-3600

ProxyConfigFrequency

决定 Zabbix 服务器以秒为单位向 Zabbix proxy 发送配置数据的频率。仅用于被动模式的 proxy。

默认值：10
范围：1-604800

ProxyDataFrequency

确定 Zabbix 服务器以秒为单位从 Zabbix proxy 请求历史数据的频率。仅用于被动模式下的 proxy。

默认值：1
范围：1-3600

ServiceManagerSyncFrequency

确定 Zabbix 以秒为单位同步服务管理器配置的频率。

默认值：60
范围：1-3600

SMSDevices

允许 Zabbix 服务器使用的、以逗号分隔的 modem 文件列表。
如果未设置此参数，则无法发送短信。

示例：

SMSDevices=/dev/ttyUSB0,/dev/ttyUSB1

SNMPTrapperFile

用于将数据从 SNMP 陷阱守护程序传递到Zabbix server的临时文件。
必须与 zabbix_trap_receiver.pl 或 SNMPTT 配置文件中的内容相同。

默认值：/tmp/zabbix_traps.tmp

SocketDir

用于存储内部 Zabbix 服务使用的 IPC 套接字的目录。

默认值：/tmp

SourceIP

用于以下连接的源 IP 地址：

到 Zabbix proxy 和 Zabbix agent 的出站连接
无 agent 连接（VMware、SSH、JMX、SNMP、Telnet 和简单检查）
HTTP agent 连接
脚本监控项 JavaScript HTTP 请求
预处理 JavaScript HTTP 请求
发送通知邮件（连接到 SMTP 服务器）
webhook 通知（JavaScript HTTP 连接）
到 Vault 的连接

SSHKeyLocation

SSH 检查和操作的公钥和私钥的位置。

SSLCertLocation

用于客户端身份验证的 SSL 客户端证书文件的位置。
此参数仅用于 Web 监控。

SSLKeyLocation

用于客户端身份验证的 SSL 私钥文件的位置。
此参数仅用于 Web 监控。

SSLCALocation

覆盖用于 SSL 服务器证书验证的证书颁发机构（CA）文件位置。如果未设置，将使用系统范围的目录。
请注意，此参数的值将被设置为 libcurl 选项 CURLOPT_CAPATH。对于 7.42.0 之前的 libcurl 版本，只有在 libcurl 编译为使用 OpenSSL 时，此参数才会生效。更多信息请参见 cURL web page。
此参数用于 web 监控和 SMTP 身份验证。

StartAgentPollers

预先派生的 Zabbix agent poller 实例数量。
另请参见 MaxConcurrentChecksPerPoller。

默认值：1
范围：0-1000

StartAlerters

alerters 的预分配实例数。

默认值：3
范围：1-100

StartBrowserPollers

浏览器监控项 pollers 的预分配实例数。

默认值：1
范围：0-1000

StartConnectors

预先派生的连接器工作进程实例数量。
当连接器工作进程启动时，连接器管理器进程会自动启动。

默认值：0
范围：0-1000

StartDBSyncers

预先 fork 的历史同步器实例数量。
注意：更改此值时请务必小心，增加它可能弊大于利。粗略地说，默认值应足以处理最多 4000 NVPS。

默认值：4
范围：1-100

StartDiscoverers

发现工作线程¹的预派生实例数量。

默认值：5 范围：0 - 1000

StartEscalators

escalators 的预分配实例数。

默认值：1
范围：1-100

StartHistoryPollers

历史轮询器的预分配实例数。
仅计算检查时需要。

默认值：5
范围：0-1000

StartHTTPAgentPollers

预先派生的 HTTP agent poller 实例数量。另请参见 MaxConcurrentChecksPerPoller。

默认值：1
范围：0-1000

StartHTTPPollers

HTTP 轮询器¹ 的预分配实例数。

默认值：1
范围：0-1000

StartIPMIPollers

IPMI 轮询器的预分配实例数。

默认值：0
范围：0-1000

StartJavaPollers

Java 轮询器¹ 的预分配实例数。

默认值：0
范围：0-1000

StartLLDProcessors

预先派生的低级发现（LLD）工作进程¹的数量。
启动 LLD 工作进程时，会自动启动 LLD 管理器进程。

默认值：2
范围：1-100

StartODBCPollers

ODBC 轮询器¹ 的预分配实例数。

默认值：1
范围：0-1000

StartPingers

ICMP pingers¹ 的预分配实例数。

默认值：1
范围：0-1000

StartPollersUnreachable

无法访问主机的轮询器（包括 IPMI 和 Java）¹ 的预分配实例数。
如果启动常规、IPMI 或 Java 轮询器，则必须至少运行一个无法访问主机的轮询器。

默认值：1
范围：0-1000

StartPollers

pollers¹ 的预分配实例数。

默认值：5
范围：0-1000

StartPreprocessors

预启动的预处理 worker¹ 线程数量应设置为不小于可用 CPU 核心数。如果预处理不受 CPU 限制且包含大量网络请求，则应设置更多的 worker。

默认值：16
范围：1-1000

StartProxyPollers

被动代理轮询器¹的预分配实例数。

默认值：1
范围：0-250

StartReportWriters

报告编写器的预分配实例数。
如果设置为 0，则禁用计划报告生成。
启动报告编写器时，报告管理器进程会自动启动。

默认值：0
范围：0-100

StartSNMPPollers

预先派生的 SNMP pollers 实例数量。另请参见 MaxConcurrentChecksPerPoller。

默认值：1
范围：0-1000

StartSNMPTrapper

如果设置为 1，将启动 SNMP trapper 进程。

默认值：0
范围：0-1

StartTimers

timers
Timers 进程维护期的预分配实例数。

默认值：1
范围：1-1000

StartTrappers

预先派生的 trapper¹ 实例数量。
trapper 接受来自 Zabbix sender、主动 agent 和主动 proxy 的传入连接。

默认值：5
范围：0-1000

StartVMwareCollectors

预分配的 VMware 收集器实例数。

默认值：0
范围：0-250

StatsAllowedIP

外部 Zabbix 实例的 IP 地址列表（以逗号分隔），可选用 CIDR 表示法，也可以是 DNS 名称。仅接受来自此处列出地址的统计请求。如果未设置此参数，则不接受任何统计请求。
如果启用了 IPv6 支持，则 '127.0.0.1'、'::127.0.0.1'、'::ffff:127.0.0.1' 被视为等效，而 '::/0' 将允许任何 IPv4 或 IPv6 地址。可使用 '0.0.0.0/0' 允许任何 IPv4 地址。

示例：

StatsAllowedIP=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

超时

指定与 Zabbix proxy、agent、Web 服务以及旧版 SNMP 检查（单个 OID 编号或字符串）建立连接和交换数据时的等待时长（以秒为单位）。

此参数定义了各种通信操作的持续时间：

在 Zabbix agent 上执行远程命令
执行 SSH/Telnet 命令
向 Zabbix Web 服务发起请求
mediatype 测试请求和 history.push 方法的通信超时
当 IPMI 接口不可用时重新调度监控项
当因权限或加密问题导致数据交换失败时，向 Zabbix proxy 发送响应
IPC 异步套接字和运行时控制选项的截止时间
JMX 连接
从远程 Zabbix proxy 或服务器获取统计信息
向 Zabbix 前端发送响应
异步轮询器 DNS 请求
主动检查心跳的响应
从主动 agent 获取 Zabbix agent 数据（值）
从 Zabbix sender 获取数据
trapper 无法处理请求时的响应
向 Zabbix agent 发送主动检查列表

对于那些在前端中配置了灵活超时设置的检查（全局、proxy 或单个监控项级别），将不会使用此超时值。
例如，SNMP walk[OID] 和 get[OID] 监控项使用前端中配置的超时值；旧版 SNMP 检查仍使用服务器超时值。

默认值：3
范围：1-30

TLSCAFile

包含用于对等证书验证的顶级 CA 证书的文件的完整路径名，用于 Zabbix 组件之间的加密通信。

TLSCertFile

包含服务器证书或证书链的文件的完整路径名，用于 Zabbix 组件之间的加密通信。

TLSCipherAll

GnuTLS 优先级字符串或 OpenSSL（TLS 1.2）密码套件字符串。覆盖基于证书和 PSK 加密的默认密码套件选择条件。

示例：

TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

TLSCipherAll13

适用于 OpenSSL 1.1.1 或更新版本在 TLS 1.3 中的密码字符串。
用于覆盖基于证书和基于 PSK 的加密的默认密码套件选择条件。

GnuTLS 示例：

NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509

OpenSSL 示例：

EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128

TLSCipherCert

GnuTLS 优先级字符串或 OpenSSL（TLS 1.2）密码套件字符串。覆盖基于证书加密的默认密码套件选择条件。

GnuTLS 示例：

NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509

OpenSSL 示例：

EECDH+aRSA+AES128:RSA+aRSA+AES128

TLSCipherCert13

适用于 OpenSSL 1.1.1 或更高版本在 TLS 1.3 中的密码字符串。
覆盖基于证书加密的默认密码套件选择条件。

TLSCipherPSK

GnuTLS 优先级字符串或 OpenSSL（TLS 1.2）密码套件字符串。
覆盖基于 PSK 加密的默认密码套件选择条件。

GnuTLS 示例：

NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL

OpenSSL 示例：

kECDHEPSK+AES128:kPSK+AES128

TLSCipherPSK13

适用于 OpenSSL 1.1.1 或更高版本在 TLS 1.3 中的密码字符串。
覆盖基于 PSK 加密的默认密码套件选择条件。

示例：

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

TLSCRLFile

包含已吊销证书的文件的完整路径名。
此参数用于 Zabbix 组件之间的加密通信。

TLSFrontendAccept

接受来自前端的哪些入站连接。

可以指定多个值，用逗号分隔：

unencrypted - 接受未加密的连接。
cert - 接受使用 TLS 和证书保护的连接。

默认值：unencrypted

TLSFrontendCertIssuer

允许的前端证书颁发者。

TLSFrontendCertSubject

允许的前端证书主题。

TLSKeyFile

包含服务器私钥的文件的完整路径名，用于 Zabbix 组件之间的加密通信。

TLSListen

控制 trapper 套接字上的 TLS。

支持的值：

required - 仅接受 TLS 连接

TmpDir

临时目录。

默认值：/tmp

TrapperTimeout

指定以下操作的超时时间（秒）：

从 Zabbix proxy 检索历史数据
向 Zabbix proxy 发送配置数据
在 Zabbix 服务器上执行全局脚本或远程命令

默认值：300
范围：1-300

TrendCacheSize

趋势缓存的大小，以字节为单位。
用于存储趋势数据的共享内存大小。

默认值：4M
范围：128K-16G

TrendFunctionCacheSize

趋势函数缓存的大小（以字节为单位）。
用于缓存计算的趋势函数数据的共享内存大小。

默认值：4M
范围：128K-2G

UnavailableDelay

确定在不可用期间以多少秒的间隔检查主机可用性。

默认值：60
范围：1-3600

UnreachableDelay

确定在不可达期间，以秒为单位检查主机可用性的频率。

默认值：15
范围：1-3600

UnreachablePeriod

确定在不可达状态持续多少秒后，将主机视为不可用。

默认值：45
范围：1-3600

用户

将权限授予系统上特定的现有用户。
仅当以“root”身份运行且 AllowRoot 被禁用时才有效。

默认值：zabbix

ValueCacheSize

历史值缓存的大小（以字节为单位）。
用于缓存监控项历史数据请求的共享内存大小。
设置为 0 会禁用值缓存（不推荐）。
当值缓存用尽共享内存时，每 5 分钟会向服务器日志写入一条警告消息。

默认值：8M
范围：0,128K-64G

Vault

指定Vault提供商：
HashiCorp - HashiCorp KV Secrets Engine 版本 2
CyberArk - CyberArk Central Credential Provider
必须与前端设置的Vault提供商匹配。

默认值：HashiCorp

VaultDBPath

Vault 路径或查询，具体取决于 Vault，用于通过键检索数据库凭据。

HashiCorp 使用的键为“password”和“username”。

使用 VaultPrefix=/v1/secret/data/zabbix/ 的路径示例：

database

不使用 VaultPrefix 的路径示例：

secret/zabbix/database

CyberArk 使用的键为“Content”和“UserName”。

示例：

AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix_server_database

仅当未指定 DBUser 和 DBPassword 时，才能使用此选项。

VaultPrefix

Vault 路径或查询的自定义前缀，具体取决于所使用的 Vault。如果未指定，将使用最合适的默认值。
请注意，对于 HashiCorp，如果未指定 VaultPrefix，则会在挂载点后自动附加 data。

Hashicorp 的前缀示例：

v1/secret/data/zabbix/

Cyberark 的前缀示例：

/AIMWebService/api/Accounts?

VaultTLSCertFile

用于客户端身份验证的 SSL 证书文件的名称
证书文件必须为 PEM1 格式。
如果证书文件还包含私钥，请将 SSL 密钥文件字段留空。
包含此文件的目录由配置参数 SSLCertLocation 指定。
可以省略此选项，但建议用于 CyberArkCCP Vault。

VaultTLSKeyFile

用于客户端身份验证的 SSL 私钥文件的名称。
私钥文件必须为 PEM1 格式。
包含此文件的目录由配置参数 SSLKeyLocation 指定。
此选项可以省略，但建议用于 CyberArkCCP Vault。

VaultToken

应专门为 Zabbix 服务器生成的 HashiCorp Vault 身份验证令牌，对 Vault macros 中指定的路径具有只读权限，对可选 VaultDBPath 配置参数中指定的路径具有只读权限。
如果同时定义 VaultToken 和 VAULT_TOKEN 环境变量，则会出现错误。

必填：是，如果 Vault 设置为 HashiCorp；否则否

VaultURL

vault 服务器的 HTTP[S] URL。
如果未指定 SSLCALocation，将使用系统范围的 CA 证书目录。

默认值：https://127.0.0.1:8200

VMwareCacheSize

用于存储 VMware 数据的共享内存大小。
VMware 内部检查 zabbix[vmware,buffer,...] 可用于监控 VMware 缓存使用情况（请参阅内部检查）。
请注意，如果没有配置要启动的 vmware 收集器实例，则不会分配共享内存。

默认值：8M
范围：256K-2G

VMwareFrequency

从单个 VMware 服务收集数据之间的延迟（以秒为单位）。
此延迟应设置为任何 VMware 监控监控项的最小更新间隔。

默认值：60
范围：10-86400

VMwarePerfFrequency

从单个 VMware 服务获取性能计数器统计信息之间的延迟时间（秒）。此延迟应设置为使用 VMware 性能计数器的任意 VMware 监控监控项的最小更新间隔。

默认值：60
范围：10-86400

VMwareTimeout

vmware 收集器等待 VMware 服务（vCenter 或 ESX 虚拟机管理程序）响应的最大秒数。

默认值：10
范围：1-300

WebServiceURL

以 http[s]://host:port/report 格式指定指向 Zabbix Web 服务的 HTTP[S] URL。

示例：

WebServiceURL=http://localhost:10053/report

注意：仅对于非 TLS（HTTP）连接，可以省略协议（http://）；如果配置了 TLS，则必须使用 https://。

WebDriverURL

WebDriver 接口 HTTP[S] URL。

示例（与 Selenium WebDriver 独立服务器一起使用）：

WebDriverURL=http://localhost:4444

脚注

¹ 请注意，过多的数据采集进程（poller、unreachable poller、ODBC poller、HTTP poller、Java poller、pinger、trapper、proxypoller）以及 IPMI manager、SNMP trapper、preprocessing worker 和 discovery worker，可能会耗尽 preprocessing manager 的每进程文件描述符限制。

耗尽文件描述符限制将导致 Zabbix 服务器停止运行，通常是在启动后不久，但有时也可能需要更长时间才会发生。为避免此类问题，请检查 Zabbix 服务器配置文件，以优化并发检查数和进程数。此外，如有必要，请通过检查并调整系统限制，确保文件描述符限制设置得足够高。

² 当删除大量监控项时，会增加数据库负载，因为 housekeeper 需要删除这些监控项所拥有的全部历史数据。例如，如果我们只需要从模板中删除 1 个监控项原型，但该模板已链接到 50 台主机，并且对于每台主机，该原型都会扩展为 100 个实际监控项，那么总共就需要删除 5000 个监控项（1*50*100）。如果 MaxHousekeeperDelete 设置为 500（MaxHousekeeperDelete=500），则 housekeeper 进程在一个周期内将需要从 history 和 trends 表中为已删除的监控项最多删除 2500000 个值（5000*500）。

³ DBSocket 和 DBPort 在服务器配置中互斥。只能指定其中一个，或者两个都不定义。

What’s next?

2 Zabbix proxy