[comment]: # attributes: notoc

[comment]: # ({dbb2a1f5-dbb2a1f5})
# 1 Zabbix server

[comment]: # ({/dbb2a1f5-dbb2a1f5})

[comment]: # ({cb0b77f4-16f1be5f})
### 概述

本节列出了 Zabbix 服务器配置文件（zabbix\_server.conf）支持的参数。

这些参数仅列出名称，不包含额外信息。
单击参数可查看完整详情。

|Parameter|Description|
|--|--------|
|[AlertScriptsPath](#alertscriptspath)|自定义告警脚本的位置。|
|[AllowRoot](#allowroot)|允许服务器以 'root' 身份运行。|
|[AllowSoftwareUpdateCheck](#allowsoftwareupdatecheck)|允许 Zabbix 前端从 zabbix.com 接收有关软件更新的信息。|
|[AllowUnsupportedDBVersions](#allowunsupporteddbversions)|允许服务器与不受支持的数据库版本配合工作。|
|[CacheSize](#cachesize)|配置缓存的大小。|
|[CacheUpdateFrequency](#cacheupdatefrequency)|此参数决定 Zabbix 更新配置缓存的频率，单位为秒。|
|[DBHost](#dbhost)|Zabbix 数据库的主机（或套接字目录）。|
|[DBName](#dbname)|数据库名称。|
|[DBPassword](#dbpassword)|数据库密码。|
|[DBPort](#dbport)|Zabbix 数据库主机的端口。|
|[DBSchema](#dbschema)|数据库模式名称。用于 PostgreSQL。|
|[DBSocket](#dbsocket)|MySQL 套接字文件的路径。|
|[DBUser](#dbuser)|数据库用户。|
|[DBTLSConnect](#dbtlsconnect)|将此选项设置为指定值后，将强制使用 TLS 连接数据库。|
|[DBTLSCAFile](#dbtlscafile)|包含用于数据库证书验证的顶级 CA 证书的文件完整路径。|
|[DBTLSCertFile](#dbtlscertfile)|包含用于向数据库进行身份验证的 Zabbix 服务器证书的文件完整路径。|
|[DBTLSKeyFile](#dbtlskeyfile)|包含用于向数据库进行身份验证的私钥的文件完整路径。|
|[DBTLSCipher](#dbtlscipher)|Zabbix 服务器允许用于 TLS v1.2 及以下 TLS 协议的加密密码套件列表。仅支持 MySQL。|
|[DBTLSCipher13](#dbtlscipher13)|Zabbix 服务器允许用于 TLS v1.3 协议的加密密码套件列表。仅支持 MySQL，自 8.0.16 版本起支持。|
|[DebugLevel](#debuglevel)|指定调试级别。|
|[EnableGlobalScripts](#enableglobalscripts)|启用 Zabbix 服务器上的全局脚本。|
|[ExportDir](#exportdir)|用于以换行分隔 JSON 格式实时导出事件、历史数据和趋势数据的目录。如果设置此项，将启用实时导出。|
|[ExportFileSize](#exportfilesize)|每个导出文件的最大大小，单位为字节。|
|[ExportType](#exporttype)|用于实时导出的实体类型列表，以逗号分隔（events、history、trends，默认导出所有类型）。|
|[ExternalScripts](#externalscripts)|外部脚本的位置。|
|[Fping6Location](#fping6location)|fping6 的位置。|
|[FpingLocation](#fpinglocation)|fping 的位置。|
|[FrontendAllowedIP](#frontendallowedip)|允许从前端连接的 IP 地址或 CIDR 范围列表，以逗号分隔。|
|[HANodeName](#hanodename)|高可用集群节点名称。|
|[HistoryCacheSize](#historycachesize)|历史缓存的大小。|
|[HistoryIndexCacheSize](#historyindexcachesize)|历史索引缓存的大小。|
|[HistoryStorageDateIndex](#historystoragedateindex)|启用对历史存储中的历史值进行预处理，以便根据日期将值存储到不同索引中。|
|[HistoryStorageURL](#historystorageurl)|历史存储的 HTTP\[S\] URL。|
|[HistoryStorageTypes](#historystoragetypes)|要发送到历史存储的值类型列表，以逗号分隔。|
|[HousekeepingFrequency](#housekeepingfrequency)|此参数决定 Zabbix 执行清理程序的频率，单位为小时。|
|[Include](#include)|您可以在配置文件中包含单个文件或目录中的所有文件。|
|[JavaGateway](#javagateway)|Zabbix Java 网关的 IP 地址（或主机名）。|
|[JavaGatewayPort](#javagatewayport)|Zabbix Java 网关监听的端口。|
|[ListenBacklog](#listenbacklog)|TCP 队列中待处理连接的最大数量。|
|[ListenIP](#listenip)|trapper 应监听的 IP 地址列表，以逗号分隔。|
|[ListenPort](#listenport)|trapper 的监听端口。|
|[LoadModule](#loadmodule)|服务器启动时要加载的模块。|
|[LoadModulePath](#loadmodulepath)|服务器模块所在位置的完整路径。|
|[LogFile](#logfile)|日志文件名。|
|[LogFileSize](#logfilesize)|日志文件的最大大小。|
|[LogSlowQueries](#logslowqueries)|决定数据库查询在被记录到日志之前允许耗时多久，单位为毫秒。|
|[LogType](#logtype)|日志输出类型。|
|[MaxConcurrentChecksPerPoller](#maxconcurrentchecksperpoller)|每个 HTTP agent poller、agent poller 或 SNMP poller 一次可执行的异步检查最大数量。|
|[MaxHousekeeperDelete](#maxhousekeeperdelete)|在一个 housekeeping 周期中的一个任务里，删除的行数不会超过 'MaxHousekeeperDelete' 行（对应 [tablename]、[field]、[value]）。|
|[NodeAddress](#nodeaddress)|用于覆盖前端应如何连接到服务器的 IP 或主机名，可选带端口。|
|[PidFile](#pidfile)|PID 文件名。|
|[ProblemHousekeepingFrequency](#problemhousekeepingfrequency)|决定 Zabbix 删除已删除触发器对应问题的频率。|
|[ProxyConfigFrequency](#proxyconfigfrequency)|决定 Zabbix 服务器向 Zabbix proxy 发送配置数据的频率。|
|[ProxyDataFrequency](#proxydatafrequency)|决定 Zabbix 服务器向 Zabbix proxy 请求历史数据的频率。|
|[ServiceManagerSyncFrequency](#servicemanagersyncfrequency)|决定 Zabbix 同步服务管理器配置的频率。|
|[SMSDevices](#smsdevices)|允许 Zabbix 服务器使用的调制解调器文件列表，以逗号分隔。|
|[SNMPTrapperFile](#snmptrapperfile)|用于将数据从 SNMP trapper 守护进程传递到服务器的临时文件。|
|[SocketDir](#socketdir)|用于存储内部 Zabbix 服务所使用的 IPC 套接字的目录。|
|[SourceIP](#sourceip)|源 IP 地址。|
|[SSHKeyLocation](#sshkeylocation)|用于 SSH 检查和操作的公钥和私钥位置。|
|[SSLCertLocation](#sslcertlocation)|用于客户端身份验证的 SSL 客户端证书文件位置。|
|[SSLKeyLocation](#sslkeylocation)|用于客户端身份验证的 SSL 私钥文件位置。|
|[SSLCALocation](#sslcalocation)|覆盖用于 SSL 服务器证书验证的证书颁发机构（CA）文件位置。|
|[StartAgentPollers](#startagentpollers)|预先 fork 的异步 Zabbix agent poller 实例数量。|
|[StartAlerters](#startalerters)|预先 fork 的 alerter 实例数量。|
|[StartBrowserPollers](#startbrowserpollers)|预先 fork 的浏览器监控项 poller 实例数量。|
|[StartConnectors](#startconnectors)|预先 fork 的 connector worker 实例数量。|
|[StartDBSyncers](#startdbsyncers)|预先 fork 的历史同步器实例数量。|
|[StartDiscoverers](#startdiscoverers)|预先 fork 的发现 worker 实例数量。|
|[StartEscalators](#startescalators)|预先 fork 的 escalator 实例数量。|
|[StartHistoryPollers](#starthistorypollers)|预先 fork 的历史 poller 实例数量。|
|[StartHTTPAgentPollers](#starthttpagentpollers)|预先 fork 的异步 HTTP agent poller 实例数量。|
|[StartHTTPPollers](#starthttppollers)|预先 fork 的 HTTP poller 实例数量。|
|[StartIPMIPollers](#startipmipollers)|预先 fork 的 IPMI poller 实例数量。|
|[StartJavaPollers](#startjavapollers)|预先 fork 的 Java poller 实例数量。|
|[StartLLDProcessors](#startlldprocessors)|预先 fork 的低级发现（LLD）worker 实例数量。|
|[StartODBCPollers](#startodbcpollers)|预先 fork 的 ODBC poller 实例数量。|
|[StartPingers](#startpingers)|预先 fork 的 ICMP pinger 实例数量。|
|[StartPollersUnreachable](#startpollersunreachable)|用于不可达主机的 poller 预先 fork 的实例数量（包括 IPMI 和 Java）。|
|[StartPollers](#startpollers)|预先 fork 的 poller 实例数量。|
|[StartPreprocessors](#startpreprocessors)|预先启动的预处理 worker 实例数量。|
|[StartProxyPollers](#startproxypollers)|用于被动 proxy 的 poller 预先 fork 的实例数量。|
|[StartReportWriters](#startreportwriters)|预先 fork 的报告写入器实例数量。|
|[StartSNMPPollers](#startsnmppollers)|预先 fork 的异步 SNMP poller 实例数量。|
|[StartSNMPTrapper](#startsnmptrapper)|如果设置为 1，将启动 SNMP trapper 进程。|
|[StartTimers](#starttimers)|预先 fork 的定时器实例数量。|
|[StartTrappers](#starttrappers)|预先 fork 的 trapper 实例数量。|
|[StartVMwareCollectors](#startvmwarecollectors)|预先 fork 的 VMware 收集器实例数量。|
|[StatsAllowedIP](#statsallowedip)|外部 Zabbix 实例的 IP 地址列表，以逗号分隔，可选使用 CIDR 表示法，或 DNS 名称。统计请求仅会接受来自此处列出的地址。|
|[Timeout](#timeout)|指定与 Zabbix proxy、agent、web 服务建立连接并交换数据，以及执行 SNMP 检查时的等待时间（秒）（SNMP `walk[OID]` 和 `get[OID]` 监控项除外）。|
|[TLSCAFile](#tlscafile)|包含用于对等证书验证的顶级 CA 证书的文件完整路径，用于 Zabbix 组件之间的加密通信。|
|[TLSCertFile](#tlscertfile)|包含服务器证书或证书链的文件完整路径，用于 Zabbix 组件之间的加密通信。|
|[TLSCipherAll](#tlscipherall)|GnuTLS 优先级字符串或 OpenSSL（TLS 1.2）密码字符串。覆盖基于证书和 PSK 加密的默认密码套件选择条件。|
|[TLSCipherAll13](#tlscipherall13)|用于 TLS 1.3 的 OpenSSL 1.1.1 或更新版本的密码字符串。覆盖基于证书和 PSK 加密的默认密码套件选择条件。|
|[TLSCipherCert](#tlsciphercert)|GnuTLS 优先级字符串或 OpenSSL（TLS 1.2）密码字符串。覆盖基于证书加密的默认密码套件选择条件。|
|[TLSCipherCert13](#tlsciphercert13)|用于 TLS 1.3 的 OpenSSL 1.1.1 或更新版本的密码字符串。覆盖基于证书加密的默认密码套件选择条件。|
|[TLSCipherPSK](#tlscipherpsk)|GnuTLS 优先级字符串或 OpenSSL（TLS 1.2）密码字符串。覆盖基于 PSK 加密的默认密码套件选择条件。|
|[TLSCipherPSK13](#tlscipherpsk13)|用于 TLS 1.3 的 OpenSSL 1.1.1 或更新版本的密码字符串。覆盖基于 PSK 加密的默认密码套件选择条件。|
|[TLSCRLFile](#tlscrlfile)|包含已吊销证书的文件完整路径。此参数用于 Zabbix 组件之间的加密通信。|
|[TLSFrontendAccept](#tlsfrontendaccept)|接受来自前端的哪些入站连接。|
|[TLSFrontendCertIssuer](#tlsfrontendcertissuer)|允许的前端证书颁发者。|
|[TLSFrontendCertSubject](#tlsfrontendcertsubject)|允许的前端证书主题。|
|[TLSKeyFile](#tlskeyfile)|包含服务器私钥的文件完整路径，用于 Zabbix 组件之间的加密通信。|
|[TLSListen](#tlslisten)|控制 trapper 套接字上的 TLS。|
|[TmpDir](#tmpdir)|临时目录。|
|[TrapperTimeout](#trappertimeout)|指定以下操作的超时时间（秒）：<br>- 从 Zabbix proxy 检索历史数据；<br>- 向 Zabbix proxy 发送配置数据；<br>- 在 Zabbix 服务器上执行全局脚本或远程命令。|
|[TrendCacheSize](#trendcachesize)|趋势缓存的大小。|
|[TrendFunctionCacheSize](#trendfunctioncachesize)|趋势函数缓存的大小。|
|[UnavailableDelay](#unavailabledelay)|决定在不可用期间检查主机可用性的频率。|
|[UnreachableDelay](#unreachabledelay)|决定在不可达期间检查主机可用性的频率。|
|[UnreachablePeriod](#unreachableperiod)|决定在不可达状态持续多少秒后将主机视为不可用。|
|[User](#user)|将权限降级为系统中某个已存在的特定用户。|
|[ValueCacheSize](#valuecachesize)|历史值缓存的大小。|
|[Vault](#vault)|指定 vault 提供程序。|
|[VaultDBPath](#vaultdbpath)|指定从何处通过密钥检索数据库凭据的位置。|
|[VaultPrefix](#vaultprefix)|vault 路径或查询的自定义前缀。|
|[VaultTLSCertFile](#vaulttlscertfile)|用于客户端身份验证的 SSL 证书文件名。|
|[VaultTLSKeyFile](#vaulttlskeyfile)|用于客户端身份验证的 SSL 私钥文件名。|
|[VaultToken](#vaulttoken)|HashiCorp vault 身份验证令牌。|
|[VaultURL](#vaulturl)|vault 服务器的 HTTP\[S\] URL。|
|[VMwareCacheSize](#vmwarecachesize)|用于存储 VMware 数据的共享内存大小。|
|[VMwareFrequency](#vmwarefrequency)|从单个 VMware 服务收集数据之间的延迟，单位为秒。|
|[VMwarePerfFrequency](#vmwareperffrequency)|从单个 VMware 服务检索性能计数器统计信息之间的延迟，单位为秒。|
|[VMwareTimeout](#vmwaretimeout)|vmware collector 等待 VMware 服务响应的最长时间，单位为秒。|
|[WebDriverURL](#webdriverurl)|WebDriver 接口的 HTTP\[S\] URL。|
|[WebServiceURL](#webserviceurl)|Zabbix web 服务的 HTTP\[S\] URL，格式为 \<host:port\>/report。|

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

请注意：

- 默认值反映的是守护进程默认值，而不是随软件提供的配置文件中的值。
- 值支持 [环境变量](/manual/appendix/config/environment_variables)。
- Zabbix 仅支持 UTF-8 编码且不含 [BOM](https://en.wikipedia.org/wiki/Byte_order_mark) 的配置文件。
- 以 "\#" 开头的注释仅支持出现在行首。

[comment]: # ({/cb0b77f4-16f1be5f})

[comment]: # ({8085875f-6428a44e})
### 参数详情

[comment]: # ({/8085875f-6428a44e})

[comment]: # ({1b65bc0f-e273f2ed})
##### AlertScriptsPath

[自定义告警脚本](/manual/config/notifications/media/script)的位置（取决于编译时安装变量 *datadir*）。

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

[comment]: # ({/1b65bc0f-e273f2ed})

[comment]: # ({64bce851-1edb700a})
##### AllowRoot

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

默认值：`0`<br>
取值：0 - 不允许；1 - 允许

[comment]: # ({/64bce851-1edb700a})

[comment]: # ({8275632c-11bebeca})
##### AllowSoftwareUpdateCheck
允许 Zabbix UI 从 zabbix.com 接收有关软件更新的信息。

默认值：`1`<br>
值：0 - 不允许；1 - 允许

[comment]: # ({/8275632c-11bebeca})

[comment]: # ({8d9264f2-37f8828a})
##### AllowUnsupportedDBVersions
允许server 使用不受支持的数据库版本。

默认值：`0`<br>
值：0 - 不允许；1 - 允许

[comment]: # ({/8d9264f2-37f8828a})

[comment]: # ({87d14cf3-6c704994})
##### CacheSize

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

默认值：`32M`<br>
范围：128K-64G

[comment]: # ({/87d14cf3-6c704994})

[comment]: # ({772ebdc0-2c956137})
##### CacheUpdateFrequency

此参数决定了 Zabbix 以秒为单位执行配置缓存更新的频率。
另请参见[runtime control](/manual/concepts/server#runtime-control)选项。

默认值：`10`<br>
范围：1-3600

[comment]: # ({/772ebdc0-2c956137})

[comment]: # ({8fad9fba-d92a7b2b})
##### DBHost

Zabbix 数据库的主机（或套接字目录）。

对于 MySQL：

-   `localhost` 或空字符串将使用默认的 UNIX 域套接字。

对于 PostgreSQL：

-   `localhost` 通过 DNS 解析（通常为 127.0.0.1）。
-   空字符串将使用默认的 UNIX 域套接字。
-   路径（例如 `/var/run/pgbouncer`）将使用该路径上的 UNIX 套接字。
-   以逗号分隔的列表可包含多个 `host:port` 值。将按顺序尝试每个主机，直到建立读写连接。
示例：`DBHost=localhost:5431,127.0.0.1:20051,zabbix.domain,[::1]:30051,[12fc::1]`

默认值：`localhost`

[comment]: # ({/8fad9fba-d92a7b2b})

[comment]: # ({13681597-1058c650})
##### DBName

数据库名称。

必填：是

[comment]: # ({/13681597-1058c650})

[comment]: # ({830b4e54-479ee610})
##### DBPassword

数据库密码。

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

[comment]: # ({/830b4e54-479ee610})

[comment]: # ({16044efb-1b941880})
##### DBPort

Zabbix 数据库主机的端口（参见 [`DBHost`](#dbhost)）。**^[3](zabbix_server#footnotes)^**

MySQL 的默认值：`3306`

PostgreSQL 的默认值：`5432`

范围：1024-65535

[comment]: # ({/16044efb-1b941880})

[comment]: # ({63b5abd1-abcff68d})
##### DBSchema

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

[comment]: # ({/63b5abd1-abcff68d})

[comment]: # ({e8698dc4-3a14461c})
##### DBSocket

MySQL socket 文件的路径。**^[3](zabbix_server#footnotes)^**

[comment]: # ({/e8698dc4-3a14461c})

[comment]: # ({d143a7f3-94782f63})
##### DBUser
数据库用户。

[comment]: # ({/d143a7f3-94782f63})

[comment]: # ({a08d4bce-500737d5})
##### DBTLSConnect
将此选项设置为以下值将强制使用 TLS 连接数据库：<br>*required* - 使用 TLS 连接<br>*verify\_ca* - 使用 TLS 连接并验证证书<br>*verify\_full* - 使用 TLS 连接，验证证书并验证 DBHost 指定的数据库身份是否与其证书匹配<br><br>对于 MySQL（从 5.7.11 开始）和 PostgreSQL，支持以下值：`required`、`verify_ca`、`verify_full`。<br>对于 MariaDB，从版本 10.2.6 开始，支持 `required` 和 `verify_full` 值。<br>默认情况下不设置为任何选项，行为取决于数据库配置。

[comment]: # ({/a08d4bce-500737d5})

[comment]: # ({cbc09c0c-fc356178})
##### DBTLSCAFile
包含用于数据库证书验证的顶级 CA 证书的文件的完整路径名。

必需：否（是，如果 DBTLSConnect 设置为 *verify\_ca* 或 *verify\_full*）

[comment]: # ({/cbc09c0c-fc356178})

[comment]: # ({888a6d90-5f286da4})
##### DBTLSCertFile
包含用于对数据库进行身份验证的 Zabbix server 证书的文件的完整路径名。

[comment]: # ({/888a6d90-5f286da4})

[comment]: # ({7e76481a-dd8b56f5})
##### DBTLSKeyFile
包含用于对数据库进行身份验证的私钥的文件的完整路径名。

[comment]: # ({/7e76481a-dd8b56f5})

[comment]: # ({eb72c86c-d8056d7a})
##### DBTLSCipher

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

[comment]: # ({/eb72c86c-d8056d7a})

[comment]: # ({0a7409b7-a327c2f2})
##### DBTLSCipher13

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

[comment]: # ({/0a7409b7-a327c2f2})

[comment]: # ({bf5620c1-d82f69fb})
##### DebugLevel

指定调试级别：<br>*0* - 关于 Zabbix 进程启动和停止的基本信息<br>*1* - 关键信息；<br>*2* - 错误信息；<br>*3* - 警告；<br>*4* - 用于调试（会产生大量信息）；<br>*5* - 扩展调试（会产生更多信息）。<br>另请参见 [运行时控制](/manual/concepts/server#runtime-control) 选项。

默认值：`3`<br>
范围：0-5

[comment]: # ({/bf5620c1-d82f69fb})

[comment]: # ({b5209659-662e1c94})
##### EnableGlobalScripts

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

默认值：`1`<br>
取值：0 - 禁用；1 - 启用

[comment]: # ({/b5209659-662e1c94})

[comment]: # ({36e83c4a-99815de4})
##### ExportDir

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

[comment]: # ({/36e83c4a-99815de4})

[comment]: # ({bf6063bf-965e757e})
##### ExportFileSize

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

默认值：`1G`<br>
范围：1M-1G

[comment]: # ({/bf6063bf-965e757e})

[comment]: # ({2d373ad2-5447304d})
##### ExportType

用于[实时导出](/manual/config/export/files)的以逗号分隔的实体类型列表（events、history、trends）（默认包含所有类型）。

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

history 和 trends 导出的示例：

```default
ExportType=history,trends
```

仅导出 events 的示例：

```default
ExportType=events
```

[comment]: # ({/2d373ad2-5447304d})

[comment]: # ({79e29f6f-d0a46edf})
##### ExternalScripts
外部脚本的位置（取决于“datadir”编译时安装变量）。

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

[comment]: # ({/79e29f6f-d0a46edf})

[comment]: # ({da063303-bdd6796f})
##### Fping6Location

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

默认值：`/usr/sbin/fping6`

[comment]: # ({/da063303-bdd6796f})

[comment]: # ({7c42a8ee-025648b5})
##### FpingLocation

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

默认值：`/usr/sbin/fping`

[comment]: # ({/7c42a8ee-025648b5})

[comment]: # ({ffadc67a-624a96b0})
##### 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 地址。

示例：

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

[comment]: # ({/ffadc67a-624a96b0})

[comment]: # ({171ecfd1-8bb05e99})
##### HANodeName

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

[comment]: # ({/171ecfd1-8bb05e99})

[comment]: # ({0322af3b-c802a26c})
##### HistoryCacheSize

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

默认值：`16M`<br>
范围：128K-16G

[comment]: # ({/0322af3b-c802a26c})

[comment]: # ({8eaa25b6-2753befa})
##### HistoryIndexCacheSize

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

默认值：`4M`<br>
范围：128K-16G

[comment]: # ({/8eaa25b6-2753befa})

[comment]: # ({9ba97300-b5dc4ecc})
##### HistoryStorageDateIndex
启用历史存储中历史值的预处理，以根据日期将值存储在不同的索引中。

默认值：`0`<br>
值：0 - 禁用；1 - 启用

[comment]: # ({/9ba97300-b5dc4ecc})

[comment]: # ({f75df5e5-08949761})
##### HistoryStorageURL

历史存储 HTTP\[S\] URL。
此参数用于 [Elasticsearch](/manual/appendix/install/elastic_search_setup) 设置。

[comment]: # ({/f75df5e5-08949761})

[comment]: # ({0954f270-131c3d46})
##### HistoryStorageTypes

要发送到历史存储的值类型列表，以逗号分隔。
此参数用于 [Elasticsearch](/manual/appendix/install/elastic_search_setup) 配置。

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

[comment]: # ({/0954f270-131c3d46})

[comment]: # ({3000d7fe-42928b03})
##### HousekeepingFrequency

此参数决定 Zabbix 执行 housekeeping 过程的频率，单位为小时。
housekeeping 是从数据库中删除过期信息。<br>*注意*：为防止 housekeeper 负载过高（例如，当历史和趋势保留周期大幅缩短时），在每个 housekeeping 周期中，每个监控项删除的过期信息不会超过 HousekeepingFrequency 小时的 4 倍。
因此，如果 HousekeepingFrequency 为 1，则每个周期最多删除 4 小时的过期信息（从最旧的记录开始）。<br>*注意*：为降低服务器启动时的负载，housekeeping 会在服务器启动后延迟 30 分钟执行。
因此，如果 HousekeepingFrequency 为 1，服务器启动后的第一次 housekeeping 过程将在 30 分钟后运行，之后每隔 1 小时重复执行。<br>可以通过将 HousekeepingFrequency 设置为 0 来禁用自动 housekeeping。
在这种情况下，housekeeping 过程只能通过 *housekeeper\_execute* 运行时控制选项启动，并且在一个 housekeeping 周期中删除的过期信息时长为自上次 housekeeping 周期以来时长的 4 倍，但不少于 4 小时且不超过 4 天。<br>另请参见 [运行时控制](/manual/concepts/server#runtime-control) 选项。

默认值：`1`<br>
范围：0-24

[comment]: # ({/3000d7fe-42928b03})

[comment]: # ({e98b9bb0-5836e8ba})
##### Include

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

示例：

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

[comment]: # ({/e98b9bb0-5836e8ba})

[comment]: # ({14ee47f5-97c00865})
##### JavaGateway

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

[comment]: # ({/14ee47f5-97c00865})

[comment]: # ({9e49dbe0-fc4d246a})
##### JavaGatewayPort
Zabbix Java 网关监听的端口。

默认值：`10052`<br>
范围：1024-32767

[comment]: # ({/9e49dbe0-fc4d246a})

[comment]: # ({fcd70e26-22241946})
##### ListenBacklog

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

默认值：`SOMAXCONN`<br>
范围：0 - INT\_MAX

[comment]: # ({/fcd70e26-22241946})

[comment]: # ({7a6f92ef-33f1aea9})
##### ListenIP

trapper 应监听的、以逗号分隔的 IP 地址列表。<br>如果未指定此参数，trapper 将监听所有网络接口。

默认值：`0.0.0.0`

[comment]: # ({/7a6f92ef-33f1aea9})

[comment]: # ({e2d7152a-98e0be1b})
##### ListenPort
trapper 的监听端口。

默认值：`10051`<br>
范围：1024-32767

[comment]: # ({/e2d7152a-98e0be1b})

[comment]: # ({0b5d26df-55309e9c})
##### LoadModule

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

[comment]: # ({/0b5d26df-55309e9c})

[comment]: # ({530865a5-0c0c0723})
##### LoadModulePath

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

[comment]: # ({/530865a5-0c0c0723})

[comment]: # ({ce9b40ca-c650f3c9})
##### LogFile
日志文件的名称。

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

[comment]: # ({/ce9b40ca-c650f3c9})

[comment]: # ({21f561eb-9c05648a})
##### LogFileSize
日志文件的最大大小（以 MB 为单位）。<br>0 - 禁用自动日志轮换。<br>*注意*：如果达到日志文件大小限制并且文件轮换失败，无论出于何种原因，现有日志文件都会被截断并重新启动。

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

[comment]: # ({/21f561eb-9c05648a})

[comment]: # ({a42094ee-2f20d22f})
##### LogSlowQueries
确定数据库查询在被记录之前需要多长时间（以毫秒为单位）。<br>0 - 不记录慢速查询。<br>此选项从 DebugLevel=3 开始启用。

默认值：`0`<br>
范围：0-3600000

[comment]: # ({/a42094ee-2f20d22f})

[comment]: # ({5d1bf62c-926c45e2})
##### LogType
日志输出的类型：<br>*file* - 将日志写入 LogFile 参数指定的文件；<br>*system* - 将日志写入 syslog；<br>*console* - 将日志写入标准输出。

默认值：`file`

[comment]: # ({/5d1bf62c-926c45e2})

[comment]: # ({08cad744-809662b4})
##### MaxConcurrentChecksPerPoller

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

默认值：`1000`<br>
范围：1-1000

[comment]: # ({/08cad744-809662b4})

[comment]: # ({e1df1a38-124ae689})
##### MaxHousekeeperDelete

在一个 housekeeping 周期中，每个任务删除的行数不会超过 `MaxHousekeeperDelete` 行（对应于 \[tablename\]、\[field\]、\[value\]）。<br>如果设置为 0，则完全不使用任何限制。
在这种情况下，你必须清楚自己在做什么，以免使数据库过载。**^[2](zabbix_server#footnotes)^**<br>此参数仅适用于删除已被删除的监控项遗留的数据。

默认值：`5000`<br>
范围：0-1000000

[comment]: # ({/e1df1a38-124ae689})

[comment]: # ({ed910468-9cfb79d4})
##### NodeAddress

带可选端口的 IP 或主机名，用于覆盖前端连接到服务器的方式。<br>格式：\<address>\[:\<port>\]<br><br>如果未设置 IP 或主机名，将使用 ListenIP 的值。
如果未设置 ListenIP，将使用值 `localhost`。<br>如果未设置端口，将使用 ListenPort 的值。
如果未设置 ListenPort，将使用值 `10051`。<br><br>此前端配置中指定的地址可以覆盖此选项。<br><br>另请参见：[HANodeName](#hanodename) 参数；[启用高可用性](/manual/concepts/server/ha#enabling-high-availability)。

默认值：`localhost:10051`

[comment]: # ({/ed910468-9cfb79d4})

[comment]: # ({70607c45-8153735c})
##### PidFile
PID 文件的名称。

默认值：`/tmp/zabbix_server.pid`

[comment]: # ({/70607c45-8153735c})

[comment]: # ({c64dc750-b0d337ac})
##### ProblemHousekeepingFrequency

用于确定 Zabbix 删除已删除触发器对应问题的频率，单位为秒。

默认值：`60`<br>
范围：1-3600

[comment]: # ({/c64dc750-b0d337ac})

[comment]: # ({5f2750c1-b3642a43})
##### ProxyConfigFrequency

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

默认值：`10`<br>
范围：1-604800

[comment]: # ({/5f2750c1-b3642a43})

[comment]: # ({08d1c4dc-3bb5827f})
##### ProxyDataFrequency

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

默认值：`1`<br>
范围：1-3600

[comment]: # ({/08d1c4dc-3bb5827f})

[comment]: # ({dc7c58ce-7df5a0e9})
##### ServiceManagerSyncFrequency
确定 Zabbix 以秒为单位同步服务管理器配置的频率。

默认值：`60`<br>
范围：1-3600

[comment]: # ({/dc7c58ce-7df5a0e9})

[comment]: # ({7c0b3900-f2dfc72b})
##### SMSDevices

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

示例：

```default
SMSDevices=/dev/ttyUSB0,/dev/ttyUSB1
```

[comment]: # ({/7c0b3900-f2dfc72b})

[comment]: # ({45fb51c5-9c385986})
##### SNMPTrapperFile
用于将数据从 SNMP 陷阱守护程序传递到Zabbix server的临时文件。<br>必须与 zabbix\_trap\_receiver.pl 或 SNMPTT 配置文件中的内容相同。

默认值：`/tmp/zabbix_traps.tmp`

[comment]: # ({/45fb51c5-9c385986})

[comment]: # ({d3999f18-cd750f09})
##### SocketDir
用于存储内部 Zabbix 服务使用的 IPC 套接字的目录。

默认值：`/tmp`

[comment]: # ({/d3999f18-cd750f09})

[comment]: # ({b21ff1aa-bf3120f2})
##### SourceIP

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

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

[comment]: # ({/b21ff1aa-bf3120f2})

[comment]: # ({4beb1f20-8edbdae2})
##### SSHKeyLocation
SSH 检查和操作的公钥和私钥的位置。

[comment]: # ({/4beb1f20-8edbdae2})

[comment]: # ({b465011c-f14a0fc6})
##### SSLCertLocation
用于客户端身份验证的 SSL 客户端证书文件的位置。<br>此参数仅用于 Web 监控。

[comment]: # ({/b465011c-f14a0fc6})

[comment]: # ({156e51d2-d38d629d})
##### SSLKeyLocation
用于客户端身份验证的 SSL 私钥文件的位置。<br>此参数仅用于 Web 监控。

[comment]: # ({/156e51d2-d38d629d})

[comment]: # ({6caec47b-d4ecaa9a})
##### SSLCALocation

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

[comment]: # ({/6caec47b-d4ecaa9a})

[comment]: # ({0d8458ce-206670d7})
##### StartAgentPollers

预先派生的 Zabbix agent [poller](/manual/concepts/server#server-process-types-and-threads) 实例数量。
另请参见 [MaxConcurrentChecksPerPoller](#maxconcurrentchecksperpoller)。

默认值：`1`<br>
范围：0-1000

[comment]: # ({/0d8458ce-206670d7})

[comment]: # ({59f5b0a8-49587d38})
##### StartAlerters

预先派生的 [alerters](/manual/concepts/server#server-process-types-and-threads) 实例数量。

默认值：`3`<br>
范围：1-100

[comment]: # ({/59f5b0a8-49587d38})

[comment]: # ({a8c90681-3a5cd4ee})
##### StartBrowserPollers

预先派生的浏览器监控项 [pollers](/manual/concepts/server#server-process-types-and-threads) 实例数量。

默认值：`1`<br>
范围：0-1000

[comment]: # ({/a8c90681-3a5cd4ee})

[comment]: # ({3aed608c-4404a76d})
##### StartConnectors

预先 fork 的[连接器工作进程](/manual/concepts/server#server-process-types-and-threads)实例数量。
当连接器工作进程启动时，连接器管理器进程会自动启动。

默认值：`0`<br>
范围：0-1000

[comment]: # ({/3aed608c-4404a76d})

[comment]: # ({80327425-25c85aff})
##### StartDBSyncers

预先派生的 [历史记录同步器](/manual/concepts/server#server-process-types-and-threads) 实例数量。<br>*注意*：修改此值时请谨慎，增大该值可能弊大于利。  
大致来说，默认值应足以处理最多 4000 NVPS。

默认值：`4`<br>
范围：1-100

[comment]: # ({/80327425-25c85aff})

[comment]: # ({7e6c9d40-40a86c5a})
##### StartDiscoverers

预先派生的 [发现工作进程](/manual/concepts/server#server-process-types-and-threads)**^[1](zabbix_server#footnotes)^** 实例数量。

默认值：`5`<br>
范围：0-1000

[comment]: # ({/7e6c9d40-40a86c5a})

[comment]: # ({57b95a68-5a8be3fd})
##### StartEscalators

预先派生的 [escalators](/manual/concepts/server#server-process-types-and-threads) 实例数量。

默认值：`1`<br>
范围：1-100

[comment]: # ({/57b95a68-5a8be3fd})

[comment]: # ({5514dd29-97ad4fb5})
##### StartHistoryPollers

预先派生的 [历史轮询器](/manual/concepts/server#server-process-types-and-threads) 实例数量。<br>仅计算型检查需要此参数。

默认值：`5`<br>
范围：0-1000

[comment]: # ({/5514dd29-97ad4fb5})

[comment]: # ({83c7893c-bef8767a})
##### StartHTTPAgentPollers

预先派生的 HTTP agent [poller](/manual/concepts/server#server-process-types-and-threads) 实例数量。  
另请参见 [MaxConcurrentChecksPerPoller](#maxconcurrentchecksperpoller)。

默认值：`1`<br>
范围：0-1000

[comment]: # ({/83c7893c-bef8767a})

[comment]: # ({86e6ed68-565030c6})
##### StartHTTPPollers

预先派生的 [HTTP 轮询器](/manual/concepts/server#server-process-types-and-threads)**^[1](zabbix_server#footnotes)^** 实例数量。

默认值：`1`<br>
范围：0-1000

[comment]: # ({/86e6ed68-565030c6})

[comment]: # ({eb6af4dd-70082588})
##### StartIPMIPollers

预先派生的 [IPMI 轮询器](/manual/concepts/server#server-process-types-and-threads) 实例数量。

默认值：`0`<br>
范围：0-1000

[comment]: # ({/eb6af4dd-70082588})

[comment]: # ({c6172b42-5dbd1f62})
##### StartJavaPollers

预先派生的 [Java 轮询器](/manual/concepts/server#server-process-types-and-threads)**^[1](zabbix_server#footnotes)^** 实例数量。

默认值：`0`<br>
范围：0-1000

[comment]: # ({/c6172b42-5dbd1f62})

[comment]: # ({14aedb99-d9d80e3e})
##### StartLLDProcessors

预先派生的低级发现（LLD）[worker](/manual/concepts/server#server-process-types-and-threads)**^[1](zabbix_server#footnotes)^**实例数量。<br>当 LLD worker 启动时，LLD manager 进程会自动启动。

默认值：`2`<br>
范围：1-100

[comment]: # ({/14aedb99-d9d80e3e})

[comment]: # ({04aa179e-79d5cf2e})
##### StartODBCPollers

预先派生的 [ODBC 轮询器](/manual/concepts/server#server-process-types-and-threads)**^[1](zabbix_server#footnotes)^** 实例数量。

默认值：`1`<br>
范围：0-1000

[comment]: # ({/04aa179e-79d5cf2e})

[comment]: # ({4ba0032f-e788444b})
##### StartPingers

预先派生的 [ICMP pinger](/manual/concepts/server#server-process-types-and-threads)**^[1](zabbix_server#footnotes)^** 实例数量。

默认值：`1`<br>
范围：0-1000

[comment]: # ({/4ba0032f-e788444b})

[comment]: # ({340a99d1-a12742d5})
##### StartPollersUnreachable

[不可达主机轮询器](/manual/concepts/server#server-process-types-and-threads)（包括 IPMI 和 Java）**^[1](zabbix_server#footnotes)^**的预派生实例数量。<br>如果已启动常规、IPMI 或 Java 轮询器，则必须至少运行一个不可达主机轮询器。

默认值：`1`<br>
范围：0-1000

[comment]: # ({/340a99d1-a12742d5})

[comment]: # ({abcb31a2-5a731224})
##### StartPollers

预先派生的 [pollers](/manual/concepts/server#server-process-types-and-threads)**^[1](zabbix_server#footnotes)^** 实例数量。

默认值：`5`<br>
范围：0-1000

[comment]: # ({/abcb31a2-5a731224})

[comment]: # ({bd1af7c9-bdcb0d21})
##### StartPreprocessors

预启动的预处理 [worker](/manual/concepts/server#server-process-types-and-threads)**^[1](zabbix_server#footnotes)^** 线程数量应设置为不小于可用 CPU 核心数。
如果预处理不是受 CPU 限制且包含大量网络请求，则应设置更多的 worker。

默认值：`16`<br>
范围：1-1000

[comment]: # ({/bd1af7c9-bdcb0d21})

[comment]: # ({9705b5bc-d6d62537})
##### StartProxyPollers

[被动 proxy 轮询器](/manual/concepts/server#server-process-types-and-threads)**^[1](zabbix_server#footnotes)^**的预创建实例数。

默认值：`1`<br>
范围：0-250

[comment]: # ({/9705b5bc-d6d62537})

[comment]: # ({10803f63-469b0927})
##### StartReportWriters

预先派生的 [报告写入器](/manual/concepts/server#server-process-types-and-threads) 实例数量。<br>如果设置为 0，则计划报表生成功能将被禁用。<br>当报告写入器启动时，报表管理器进程也会自动启动。

默认值：`0`<br>
范围：0-100

[comment]: # ({/10803f63-469b0927})

[comment]: # ({9f0c154e-95051e96})
##### StartSNMPPollers

预先派生的 SNMP [poller](/manual/concepts/server#server-process-types-and-threads) 实例数量。  
另请参见 [MaxConcurrentChecksPerPoller](#maxconcurrentchecksperpoller)。

默认值：`1`<br>
范围：0-1000

[comment]: # ({/9f0c154e-95051e96})

[comment]: # ({6e99698e-9cccc249})
##### StartSNMPTrapper

如果设置为 1，将启动一个 [SNMP trapper](/manual/concepts/server#server-process-types-and-threads) 进程。

默认值：`0`<br>
范围：0-1

[comment]: # ({/6e99698e-9cccc249})

[comment]: # ({43f0ca73-f1f30b44})
##### StartTimers

预先派生的 [timers](/manual/concepts/server#server-process-types-and-threads) 实例数量。<br>Timers 进程处理维护期。

默认值：`1`<br>
范围：1-1000

[comment]: # ({/43f0ca73-f1f30b44})

[comment]: # ({d7088282-368a443a})
##### StartTrappers

预先派生的 [trapper](/manual/concepts/server#server-process-types-and-threads)**^[1](zabbix_server#footnotes)^** 实例数量。<br>trapper 接受来自 Zabbix sender、主动 agent 和主动 proxy 的传入连接。

默认值：`5`<br>
范围：0-1000

[comment]: # ({/d7088282-368a443a})

[comment]: # ({8ecc8441-16e17139})
##### StartVMwareCollectors

预先派生的 [VMware collector](/manual/concepts/server#server-process-types-and-threads) 实例数量。

默认值：`0`<br>
范围：0-250

[comment]: # ({/8ecc8441-16e17139})

[comment]: # ({ef3014a4-0da7c397})
##### StatsAllowedIP

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

示例：

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

[comment]: # ({/ef3014a4-0da7c397})

[comment]: # ({bb3932c0-db780aaa})
##### 超时

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

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

-   在 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 发送主动检查列表

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

默认值：`3`<br>
范围：1-30

[comment]: # ({/bb3932c0-db780aaa})

[comment]: # ({ab7b9064-68df390b})
##### TLSCAFile
包含用于对等证书验证的顶级 CA 证书的文件的完整路径名，用于 Zabbix 组件之间的加密通信。

[comment]: # ({/ab7b9064-68df390b})

[comment]: # ({17bd8bac-24534d6d})
##### TLSCertFile
包含服务器证书或证书链的文件的完整路径名，用于 Zabbix 组件之间的加密通信。

[comment]: # ({/17bd8bac-24534d6d})

[comment]: # ({84033417-0c9251b8})
##### TLSCipherAll

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

示例：

```default
TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
```

[comment]: # ({/84033417-0c9251b8})

[comment]: # ({f7176746-74bef172})
##### TLSCipherAll13

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

GnuTLS 示例： 

```default
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 示例： 

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

[comment]: # ({/f7176746-74bef172})

[comment]: # ({00c9e2e3-a0eeb337})
##### TLSCipherCert

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

GnuTLS 示例： 

```default
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 示例： 

```default
EECDH+aRSA+AES128:RSA+aRSA+AES128
```

[comment]: # ({/00c9e2e3-a0eeb337})

[comment]: # ({fdf185a8-07722feb})
##### TLSCipherCert13

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

[comment]: # ({/fdf185a8-07722feb})

[comment]: # ({c201c168-b3e6744e})
##### TLSCipherPSK

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

GnuTLS 示例： 

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

OpenSSL 示例： 

```default
kECDHEPSK+AES128:kPSK+AES128
```

[comment]: # ({/c201c168-b3e6744e})

[comment]: # ({c74deda4-a67b06d2})
##### TLSCipherPSK13

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

示例：

```default
TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
```

[comment]: # ({/c74deda4-a67b06d2})

[comment]: # ({86c3fae2-7b53bee4})
##### TLSCRLFile

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

[comment]: # ({/86c3fae2-7b53bee4})

[comment]: # ({25897b30-60062be9})
##### TLSFrontendAccept
接受来自前端的哪些入站连接。

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

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

默认值：`unencrypted`

[comment]: # ({/25897b30-60062be9})

[comment]: # ({24bbc4ee-efc6faf7})
##### TLSFrontendCertIssuer

允许的前端证书颁发者。

[comment]: # ({/24bbc4ee-efc6faf7})

[comment]: # ({f0346667-fa8236e6})
##### TLSFrontendCertSubject

允许的前端证书主题。

[comment]: # ({/f0346667-fa8236e6})

[comment]: # ({8267f910-e236df69})
##### TLSKeyFile
包含服务器私钥的文件的完整路径名，用于 Zabbix 组件之间的加密通信。

[comment]: # ({/8267f910-e236df69})

[comment]: # ({73383e62-2c803715})
##### TLSListen

控制 trapper 套接字上的 TLS。

支持的值：

-   required - 仅接受 TLS 连接

[comment]: # ({/73383e62-2c803715})

[comment]: # ({ddb80460-0b008346})
##### TmpDir
临时目录。

默认值：`/tmp`

[comment]: # ({/ddb80460-0b008346})

[comment]: # ({4251440b-621f6e9f})
##### TrapperTimeout

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

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

默认值：`300`<br>
范围：1-300

[comment]: # ({/4251440b-621f6e9f})

[comment]: # ({5a507f6f-02c73c1a})
##### TrendCacheSize

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

默认值：`4M`<br>
范围：128K-16G

[comment]: # ({/5a507f6f-02c73c1a})

[comment]: # ({9ce42d11-5eeafa8d})
##### TrendFunctionCacheSize
趋势函数缓存的大小（以字节为单位）。<br>用于缓存计算的趋势函数数据的共享内存大小。

默认值：`4M`<br>
范围：128K-2G

[comment]: # ({/9ce42d11-5eeafa8d})

[comment]: # ({bc096e2b-f61cf9e1})
##### UnavailableDelay

确定在[不可用](/manual/appendix/items/unreachability#unavailable-interface)期间以多少秒的间隔检查主机可用性。

默认值：`60`<br>
范围：1-3600

[comment]: # ({/bc096e2b-f61cf9e1})

[comment]: # ({d01b541d-98b994ea})
##### UnreachableDelay

确定在[不可达](/manual/appendix/items/unreachability#unreachable-interface)期间，以秒为单位检查主机可用性的频率。

默认值：`15`<br>
范围：1-3600

[comment]: # ({/d01b541d-98b994ea})

[comment]: # ({b96c5244-df350752})
##### UnreachablePeriod

确定在[不可达](/manual/appendix/items/unreachability#unreachable-interface)状态持续多少秒后，将主机视为不可用。

默认值：`45`<br>
范围：1-3600

[comment]: # ({/b96c5244-df350752})

[comment]: # ({ee4ad0a4-a9a2ec9d})
##### 用户
将权限授予系统上特定的现有用户。<br>仅当以“root”身份运行且 AllowRoot 被禁用时才有效。

默认值：`zabbix`

[comment]: # ({/ee4ad0a4-a9a2ec9d})

[comment]: # ({e75cbec4-20ddb562})
##### ValueCacheSize
历史值缓存的大小（以字节为单位）。<br>用于缓存监控项历史数据请求的共享内存大小。<br>设置为 0 会禁用值缓存（不推荐）。<br>当值缓存用尽共享内存时，每 5 分钟会向服务器日志写入一条警告消息。

默认值：`8M`<br>
范围：0,128K-64G

[comment]: # ({/e75cbec4-20ddb562})

[comment]: # ({7c856e0c-35521bcc})
##### Vault
指定Vault提供商：<br>*HashiCorp* - HashiCorp KV Secrets Engine 版本 2<br>*CyberArk* - CyberArk Central Credential Provider<br>必须与前端设置的Vault提供商匹配。

默认值：`HashiCorp`

[comment]: # ({/7c856e0c-35521bcc})

[comment]: # ({2d9608b6-664924ee})
##### VaultDBPath

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

[HashiCorp](/manual/config/secrets/hashicorp#retrieving-database-credentials) 使用的键为“password”和“username”。

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

```default
database
```

不使用 VaultPrefix 的路径示例：

```default
secret/zabbix/database
```

[CyberArk](/manual/config/secrets/cyberark#database-credentials) 使用的键为“Content”和“UserName”。

示例：

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

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

[comment]: # ({/2d9608b6-664924ee})

[comment]: # ({c5f9e38e-2f778b45})
##### VaultPrefix

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

Hashicorp 的前缀示例：

```default
v1/secret/data/zabbix/
```

Cyberark 的前缀示例：

```default
/AIMWebService/api/Accounts?
```

[comment]: # ({/c5f9e38e-2f778b45})

[comment]: # ({2162f35c-778803e5})
##### VaultTLSCertFile

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

[comment]: # ({/2162f35c-778803e5})

[comment]: # ({5a50dd2b-755d874e})
##### VaultTLSKeyFile

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

[comment]: # ({/5a50dd2b-755d874e})

[comment]: # ({30558bb7-cc25a6c8})
##### VaultToken
应专门为 Zabbix 服务器生成的 HashiCorp Vault 身份验证令牌，对 [Vault macros](/manual/config/macros/user_macros#configuration) 中指定的路径具有只读权限，对可选 VaultDBPath 配置参数中指定的路径具有只读权限。<br>如果同时定义 VaultToken 和 VAULT\_TOKEN 环境变量，则会出现错误。

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

[comment]: # ({/30558bb7-cc25a6c8})

[comment]: # ({b24241d5-f46a0763})
##### VaultURL

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

默认值：`https://127.0.0.1:8200`

[comment]: # ({/b24241d5-f46a0763})

[comment]: # ({141b81e3-854dfe73})
##### VMwareCacheSize
用于存储 VMware 数据的共享内存大小。<br>VMware 内部检查 zabbix\[vmware,buffer,...\] 可用于监控 VMware 缓存使用情况（请参阅 [内部检查](/manual/config/items/itemtypes/internal)）。<br>请注意，如果没有配置要启动的 vmware 收集器实例，则不会分配共享内存。

默认值：`8M`<br>
范围：256K-2G

[comment]: # ({/141b81e3-854dfe73})

[comment]: # ({fefd3f8c-2a646d43})
##### VMwareFrequency
从单个 VMware 服务收集数据之间的延迟（以秒为单位）。<br>此延迟应设置为任何 VMware 监控监控项的最小更新间隔。

默认值：`60`<br>
范围：10-86400

[comment]: # ({/fefd3f8c-2a646d43})

[comment]: # ({a5ec3359-cf5957ec})
##### VMwarePerfFrequency

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

默认值：`60`<br>
范围：10-86400

[comment]: # ({/a5ec3359-cf5957ec})

[comment]: # ({80852117-eefd2428})
##### VMwareTimeout
vmware 收集器等待 VMware 服务（vCenter 或 ESX 虚拟机管理程序）响应的最大秒数。

默认值：`10`<br>
范围：1-300

[comment]: # ({/80852117-eefd2428})

[comment]: # ({14cfbe93-738954e5})
##### WebServiceURL

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

示例：

```default
WebServiceURL=http://localhost:10053/report
```

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

[comment]: # ({/14cfbe93-738954e5})

[comment]: # ({3695d80b-56fee0e5})
##### WebDriverURL

WebDriver 接口 HTTP\[S\] URL。

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

```default
WebDriverURL=http://localhost:4444
```

[comment]: # ({/3695d80b-56fee0e5})

[comment]: # ({9e165b65-2ab44494})
#### 脚注

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

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

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

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

[comment]: # ({/9e165b65-2ab44494})