[comment]: # translation:outdated
[comment]: # ({452d5bc5-452d5bc5})
# 2 Zabbix proxy
[comment]: # ({/452d5bc5-452d5bc5})
[comment]: # ({7cc4b644-221978cc})
#### 概述
本节列出了Zabbix proxy配置文件（zabbix\_proxy.conf）中支持的参数,请注意:
- The default values reflect daemon defaults, not the values in the
shipped configuration files;
- 默认值反映了守护程序启动的默认值，而不是配置文件中的值;
- Zabbix只支持不带[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)的UTF-8编码的配置文件
- 在配置文件中行首使用 "\#"可以注释此行配置。
[comment]: # ({/7cc4b644-221978cc})
[comment]: # ({0e27a1f6-01eb45e4})
#### 参数
|参数名称 必须配|范围|默认值|描述信息|<|<|
|---------------------------------------|------|---------|------------|-|-|
|AllowRoot|no|<|0|允许服务以 'root'身份运行。 如果该参数配置为禁止，并且服务仍以root身份启动，服务会切换到使用 'zabbix'用户启动 。 对于以普通用户启动的，该参数没有影响。
0 - 禁止
1 - 允许
Zabbix 2.2.0。以后的版本都支持这个参数。|<|
|CacheSize|no|128K-64G|8M|缓存大小, 单位为字节。
用于存储主机、监控项数据的共享内存大小。
在Zabbix 5.0.1版本这参数的最大值可以从8G增加到64G。|<|
|ConfigFrequency|no|1-604800|3600|每隔多少秒proxy从Zabbix server获取配置数据。
该参数只有主动proxy才会使用，proxy工作模式由参数ProxyMode决定。|<|
|DataSenderFrequency|no|1-3600|1|Proxy将采集到的数据以一定的时间间隔（单位为秒）发送给Zabbix server。
该参数只有主动proxy才会使用，proxy工作模式由参数ProxyMode决定。|<|
|DBHost|no|<|localhost|数据库主机名。
如果是MySQL localhost或空字符串会导致使用套接字。 如果是 PostgreSQL
只有空字符串会使用套接字。|<|
|DBName|yes|<|<|数据库名称。
对于 SQLite3 必须提供数据库文件路径（Zabbix的多进程架构不允许使用[内存数据库](https://www.sqlite.org/inmemorydb.html)，例如 `：memory：`，`file :: memory：？cache = shared`或`file：memdb1？mode = memory＆cache = shared`）。
警告: 不要与Zabbix server使用同一个数据库。|<|
|DBPassword|no|<|<|数据库登录密码。此参数SQLite不使用。
如果数据库没有密码，请注释掉此参数。|<|
|DBSchema|no|<|<|数据库Schema 名字。仅IBM DB2 和 PostgreSQL使用。|<|
|DBSocket|no|<|3306|MySQL套接字文件的路径。
本地套接字链接时不使用数据库端口参数。 此参数SQLite不使用。|<|
|DBUser|<|<|<|数据库用户名。此参数SQLite不使用。|<|
|DBTLSConnect|no|<|<|设置此选项将强制使用到TLS连接数据库。
*required* - 使用TLS连接
*verify\_ca* - 使用TLS并且验证
*verify\_full* - 使用TLS连接加证书，并且验证DBHost指定的数据库标识是否与其证书匹配。
MySQL 5.7.11和PostgreSQL支持下列值: "required", "verify", "verify\_full". MariaDB 10.2.6支持 "required" and "verify\_full"。
默认情况下不设置为任何选项，以数据库配置为准.
从Zabbix 5.0.0开始支持此参数。|<|
|DBTLSCAFile|no
(yes, 如果数据库连接为其中一个: verify\_ca, verify\_full)|<|<从Zabbix 5.0|包含用于数据库证书验证的顶级CA证书的文件的完整路径名。
0开始支持此参数。|<|
|DBTLSCertFile|no|<|<|数据库进行身份验证时对Zabbix服务器证书文件进行完整路径名验证。
从Zabbix 5.0.0开始支持此参数。|<|
|DBTLSKeyFile|no|<|<|数据库进行身份验证时对私钥文件进行完整路径名验证。
从Zabbix 5.0.0开始支持此参数。|<|
|DBTLSCipher|no|<|<|Zabbix服务器允许TLS协议通过TLSv1.2的加密密码列表。
只支持MySQL.
从Zabbix 5.0.0开始支持此参数。|<|
|DBTLSCipher13|no|<|<|Zabbix服务器允许TLS协议通过TLSv1.3的加密密码列表。
只支持MySQL8.0.16之后的版本。
从Zabbix 5.0.0开始支持此参数。|<|
|DebugLevel|no|0-5|3|指定调试等级:
0 - Zabbix进程的起停基本信息
1 - 重要（Critical）信息
2 - 错误（Error）信息
3 - 警告（Warning）信息
4 - 调试（Debug）信息 (产生大量信息)
5 - 扩展调试 (产生更多信息)|<|
|EnableRemoteCommands|no|<|0|是否允许Zabbix server远程执行命令。
0 - 禁止
1 - 允许
从Zabbix 3.4.0开始支持该参数。|<|
|ExternalScripts|no|<|/usr/local/share/zabbix/externalscripts|外部脚本位置 (依赖编译安装时的环境变量*datadir*)。|<|
|Fping6Location|no|<|/usr/sbin/fping6|ping6程序的路径。
确保fping6程序的所有者是root用户，并且设置了SUID标记。
如果需要fping程序处理IPv6地址，就置空("Fping6Location=")参数 。|<|
|FpingLocation|no|<|/usr/sbin/fping|fping程序的路径。
确保fping程序的所有者是root用户，并且设置了SUID标记|<|
|HeartbeatFrequency|no|0-3600|60|心跳信息发送频率，单位为秒。
用于监视proxy的可用性。
0 - 禁止
该参数只有主动proxy才会使用，proxy工作模式由参数ProxyMode决定。|<|
|HistoryCacheSize|no|128K-2G|16M|历史缓存数据大小, 单位为字节。
存储历史数据使用共享内存.|<|
|HistoryIndexCacheSize|no|128K-2G|4M|历史索引缓存大小, 单位为字节。\\\\缓存一个item大概需要大小为100字节的空间。
该参数从Zabbix 3.0.0开始支持。|<|
|Hostname|no|<|由参数HostnameItem设置 唯一的大|写敏感的Proxy名称。确保Server端能正确解析这个proxy名称。
允许的字符: 字母, '.', ' ', '\_' 和 '-'.
最大长度: 128|<|
|HostnameItem|no|<|system.hostname|当参数Hostname没有定义时使用这个参数设置主机名。
该参数不能用于UserParameters, performance counters or aliases, 但能用于system.run\[\]。
如果Hostname设置了，该参数可以忽略。从Zabbix 1.8.6开始支持该参数。|<|
|HousekeepingFrequency|no|0-24|1|Zabbix 执行 housekeeping 的频率 (单位为小时)。
housekeeping负责从数据库中删除过期的信息。
*注意*: 为了防止 housekeeper 负载过大 (例如, 当历史和趋势周期大大减小时), 对于每一个监控项，不会在一个housekeeping周期内删除超过4倍HousekeepingFrequency 的过期数据。 因此, 如果 HousekeepingFrequency 是 1小时, 一个周期内不会删除超过4小时的过期信息 (从最旧的数据开始) 。
*备注*: 为降低 server压力， housekeeping将在server启动以后，延迟30分钟执行。 因此, 如果 HousekeepingFrequency 是1小时,serverg启动30分后执行第一次 housekeeping , 然后按1小时为周期重复执行。从Zabbix 2.4.0以后有了这种延迟行为。
从Zabbix 3.0.0开始，可以设置HousekeepingFrequency为0来禁止自动housekeeping。 此时 housekeeping 只能通过 *housekeeper\_execute* 启动， 在一个housuekeeping周期内删除的过期信息时长为从最后一次housekeeping以来到配置周期的4倍,不少于4小时且不大于4天。|<|
|Include|no|<|<|可以在配置文件中指定单个文件或者指定一个目录（所有文件在该目录中）。
只有在指定的目录中包含相关文件, 才可以使用正则匹配的通配符 。例如: `/absolute/path/to/config/files/*.conf`. Zabbix 2.4.0以后都支持模式匹配。
参看关于限制条件[特例](special_notes_include)。|<|
|JavaGateway|no|<|<|Zabbix Java 网关的IP 地址 (或主机名) 。
Java 轮询器启动时才需要该参数。
Zabbix 2.0.0以后的所有版本都支持该参数.|<|
|JavaGatewayPort|no|1024-32767|10052|Zabbix Java 网关监听端口。
Zabbix 2.0.0以后的所有版本都支持该参数。|<|
|ListenIP|no|<|0.0.0.0|trapper监听的Ip地址，多个Ip用逗号分开。
如果没有设置该参数，会监听所有网络接口。
从Zabbix 1.8.3开始支持多Ip地址。|<|
|ListenPort|no|1024-32767|10051|trapper监听端口。|<|
|LoadModule|no|<|<|server端启动时加载的模块，这些模块用来扩展server的功能。
格式：
LoadModule=
LoadModule=
LoadModule=
这些模块必须位于LoadModulePath指定的目录中，或者路径必须位于模块名称之前。 如果前面的路径是绝对路径（以“/”开头），则忽略LoadModulePath.
允许多个 LoadModule 参数。|<|
|LoadModulePath|no|<|<|proxy模块本地完整路径.
默认值在编译时指定。|<|
|LogFile|如果日志类型选择yes,其他选择no|<|日志文件名字|<|<|
|LogFileSize|no|0-1024|1|日志文件大小，单位 MB。
0 - 禁止日志文件自动回滚.
*注意*: 如果日志文件达到限定的大小，文件回滚失败, 不管是什么原因, 现有的日志会被截断，并重新记录日志。|<|
|LogRemoteCommands|no|<|0|当执行shell命令时可以记录日志。
0 - 禁止
1 - 允许
从Zabbix 3.4.0开始支持该参数。|<|
|LogType|no|<|file|日志输出类型:
*file* - 写入LogFile 参数指定的日志文件中,
*system* - 写入syslog,
*console* - 控制台输出.
从Zabbix 3.0.0开始支持该参数。|<|
|LogSlowQueries|no|0-3600000|0|数据库查询消耗时间，大于该时间将会记入日志 (毫秒)。
0 - 不记录慢查询日志。
DebugLevel=3时该选项可用。
从Zabbix 1.8.2开始支持该参数。|<|
|PidFile|no|<|/tmp/zabbix\_proxy.pid|PID文件名字。|<|
|ProxyLocalBuffer|no|0-720|0|Proxy将在本地保留数据N小时，即使数据已与server同步。\\\\如果第三方应用程序将使用本地数据，则可以使用此参数。|<|
|ProxyMode|no|0-1|0|Proxy工作模式。
0 - 主动模式
1 - 被动模式
从Zabbix 1.8.3开始支持该参数。
*注意* 当使用 Active proxy 时，敏感的 proxy 配置数据可供有权访问Zabbix server trapper端口的应用使用。 因为第三方应用可以假装是活动proxy并请求配置数据而不会进行身份验证。|<|
|ProxyOfflineBuffer|no|1-720|1|如果无法连接Zabbix server，proxy将保留数据N小时。\\\\旧数据将丢失。|<|
|ServerPort|no|1024-32767|10051|当ProxyMode参数设置为 *主动模式*:\\\\可以通过Zabbix server的IP地址或DNS名称获取配置数据并将数据发送给Zabbix server。
当ProxyMode参数设置为*被动模式*:\\\\逗号分隔的IP地址列表，可选以CIDR表示法或Zabbix server的DNS名称。 仅接受来自此处配置地址的传入连接。 如果启用了IPv6支持，则“127.0.0.1”，“:: 127.0.0.1”，“:: ffff：127.0.0.1”将被同等对待，“:: / 0”将允许任何IPv4或IPv6地址。 '0.0.0.0/0'可用于允许任何IPv4地址。
*示例*：Server = 127.0.0.1,192.168.1.0 / 24，:: 1,2001：db8 :: / 32，zabbix.example.com|<|
|SNMPTrapperFile|no|<|/tmp/zabbix\_traps.tmp|临时文件， 用于传递 SNMP trap守护进程的数据给server.
必须和 zabbix\_trap\_receiver.pl或 SNMPTT 配置文件中的配置保持一致。
从Zabbix 2.0.0开始支持该参数。|<|
|SocketDir|no|<|/tmp|Zabbix 内部服务使用的用于存储 IPC sockets的目录。从Zabbix 3.4.0开始支持该参数。|<|
|SourceIP|no|<|<|对外连接的源IP地址。如:
-连接到Zabbix server;
- 无代理连接(VMware, SSH, JMX, SNMP, Telnet and simple checks);
- HTTP agent连接;
- 预处理JavaScript HTTP请求|<|
|SSHKeyLocation|no|<|<|SSH检查和操作的公钥和私钥的位置。|<|
|SSLCertLocation|no|<|<|用于客户端身份验证的SSL证书文件的位置。
该参数只用于web监控，从Zabbix 2.4开始支持该参数|<|
|SSLKeyLocation|no|<|<|用于客户端身份验证的SSL私钥文件的位置。
该参数只用于web监控，从Zabbix 2.4开始支持该参数。|<|
|SSLCALocation|no|<|<|为SSL服务器证书验证覆盖证书颁发机构(CA)文件的位置。如果不设置，系统范围的目录将被使用。
注意，这个参数的值将被设置为libcurl选项curloptcapath， 在7.42.0之前的libcurl版本中，只有使用OpenSSL编译libcurl才会有效。 更多信息见 [cURL 网页](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html).
这个参数从Zabbix 2.4.0开始的web监控和自从Zabbix 3.0.0开始的SMTP身份验证中使用。|<|
|StartDBSyncers|no|1-100|4|数据库进程的初始实例数量。
在版本1.8.5之前，上限是64。
这个参数从Zabbix 1.8.3开始得到了支持。|<|
|StartDiscoverers|no|0-250|1|发现进程的初始实例数量。
在Zabbix 1.8.5版本之前，最大能设置为255。|<|
|StartHTTPPollers|no|0-1000|1|HTTP 轮询进程的初始实例数量。|<|
|StartIPMIPollers|no|0-1000|0|IPMI 轮询进程的初始实例数量。
在Zabbix 1.8.5版本之前，最大能设置为255。|<|
|StartJavaPollers|no|0-1000|0|Java 轮询子进程的初始实例数量。
从Zabbix 2.0.0开始支持该参数。|<|
|StartPingers|no|0-1000|1|ICMP pingers进程的初始实例数量
在Zabbix 1.8.5版本之前，最大能设置为255。|<|
|StartPollersUnreachable|no|0-1000|1|不可达主机 (包括IPMI 和 Java)的轮询进程的初始实例数量。
从Zabbix 2.4.0开始，如果IPMI或Java轮询器启动，那么至少有一个针对不可访问主机的轮询进程必须运行。\\\\在Zabbix 1.8.5版本之前，最大能设置为255。
这个参数从Zabbix 1.8.3开始得到了支持。|<|
|StartPollers|no|0-1000|5|轮询进程的初始实例数量。\\\\在Zabbix 1.8.5版本之前，最大能设置为255。|<|
|StartPreprocessors|no|1-1000|3|pre-forked实例的预处理线程数量**^[1](zabbix_server#footnotes)^**.
预处理器工作进程启动时，预处理管理器进程将自动启动。
从Zabbix 4.2.0开始支持该参数。|<|
|StartSNMPTrapper|no|0-1|0|设置为1, SNMP trapper进程将启动。
从Zabbix 2.0.0开始支持该参数。|<|
|StartTrappers|no|0-1000|5|trapper进程的初始实例数量。
Trapper接收来自Zabbix发送者、主动agent的数据。
至少要运行一个trapper进程用于在web前端展示服务器可用性和队列视图。
在Zabbix 1.8.5版本之前，最大能设置为255。|<|
|StartVMwareCollectors|no|0-250|0|vmware采集器进程的初始实例数量。\\\\从Zabbix 2.2.0开始支持该参数。|<|
|StatsAllowedIP|no|<|<|ip地址列表以"，"分割,也可以使用CIDR、或者DNS. 只接受ip里表中的请求. 如果未设置此参数，则不接受请求.如果启用ipv6,则 '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' ipv4和ipv6都支持 ，'::/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 4.2.0开始支持该参数。|<|
|Timeout|no|1-30|3|agent、SNMP设备或外部检查的超时时长(单位为秒)。|<|
|TLSAccept|如果TLS certificate 或 PSK 参数都进行了定义(即使是*未加密的*连接)选择yes, 否则为否|<|Zabbix server能接受哪些连接方式。 此|数仅用于被动proxy。 可以指定多个值，以逗号分隔：
*未加密*接受无加密的连接（默认）
// psk // - 接受与TLS的连接和预共享密钥（PSK）
// cert // - 接受与TLS和证书的连接
从Zabbix 3.0.0开始支持该参数。|<|
|TLSCAFile|no|<|<|包含用于对等证书验证的顶级CA（s）证书的文件的完整路径名，用于Zabbix组件之间的加密通信。
从Zabbix 3.0.0开始支持该参数。|<|
|TLSCertFile|no|<|<|包含服务器证书或证书链文件的完整路径名，用于Zabbix组件之间的加密通信。
从Zabbix 3.0.0开始支持该参数。|<|
|TLSCipherAll|no|<|<|GnuTLS或者OpenSSL (TLS 1.2)加密. 默认的密码套件为PSK-based.\ 例如GnuTLS: N例如: TLS\_AES\_256\_GCM\_SHA384:TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256\ 例从Zabbix 4.4.7开始支持该参数。 从Zabbix|NE:+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
.4.7开始支持该参数。|
|TLSCipherCert|no|<|<|GnuTLS加密或者 OpenSSL (TLS 1.2) 加密. 基于证书的加密的默认certificate-based.
例如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
从Zabbix 4.4.7开始支持该参数。|<|
|TLSCipherCert13|no|<|<|OpenSSL 1.1.1或者TLS 1.3，基于证书的加密的默认certificate-based.
从Zabbix 4.4.7开始支持该参数。|<|
|TLSCipherPSK|no|<|<|GnuTLS或者OpenSSL (TLS 1.2) 加密。 默认的密码套件为PSK-based.
例如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
从Zabbix 4.4.7开始支持该参数。|<|
|TLSCipherPSK13|no|<|<|OpenSSL 1.1.1或者TLS 1.3.默认的密码套件为PSK-based..
例如: TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256
从Zabbix 4.4.7开始支持该参数。|<|
|TLSConnect|如果TLS certificate 或 PSK 参数进行了定义(即使是*未加密的*连接)选是, 否则为否|<|该参数仅用于主动proxy连接Zabbix se|ver。 仅可以选择一种方式:
*未加密*接受无加密的连接（默认）
// psk // - 接受与TLS的连接和预共享密钥（PSK）
// cert // - 接受与TLS和证书的连接
从Zabbix 3.0.0开始支持该参数。|<|
|TLSKeyFile|no|<|<|包含私钥文件的完整路径名，用于Zabbix组件之间的加密通信。
从Zabbix 3.0.0开始支持该参数。|<|
|TLSPSKFile|no|<|<|包含proxy与Zabbix server加密通信所使用的预共享密钥文件的完整路径名。
从Zabbix 3.0.0开始支持该参数。|<|
|TLSPSKIdentity|no|<|<|预共享密钥身份字符串，用于与Zabbix server进行加密通信。
从Zabbix 3.0.0开始支持该参数。|<|
|TLSServerCertIssuer|no|<|<|允许server证书颁发者。
从Zabbix 3.0.0开始支持该参数。|<|
|TLSServerCertSubject|no|<|<|允许的server证书主题。
从Zabbix 3.0.0开始支持该参数。|<|
|TmpDir|no|<|/tmp|临时目录|<|
|TrapperTimeout|no|1-300|300|定义trapper处理数据的超时时间。|<|
|User|no|<|zabbix|为了降低权限使用普通用户。
仅当以'root'身份运行且AllowRoot参数设置为禁止时，该参数才起作用。
从Zabbix 2.4.0开始支持该参数。|<|
|UnavailableDelay|no|1-3600|60|在资源[不可达](/zh/manual/appendix/items/unreachability#unavailable_host)期间，Zabbix多少秒检查一次资源是否可用。|<|
|UnreachableDelay|no|1-3600|15|在资源[不可](/zh/manual/appendix/items/unreachability#unreachable_host) 期间 ，Zabbix多少秒检查一次资源是否可达.|<|
|UnreachablePeriod|no|1-3600|45|在资源[不可](/zh/manual/appendix/items/unreachability#unreachable_host)期间 ，Zabbix多少秒检查一次资源是否可达。|<|
|VMwareCacheSize|no|256K-2G|8M|存储VMware数据的共享内存大小。
VMware内部检查\[vmware,buffer,...\] 可以用来监控VMware缓存使用情况 (参见 [内部检查](/manual/config/items/itemtypes/internal))。
注意，如果没有配置并启动vmware收集器实例，那么共享内存就不会被分配。\\\\从Zabbix 2.2.0开始支持该参数。|<|
|VMwareFrequency|no|10-86400|60|间隔多少秒从单个VMware服务收集数据。\\\\任何VMware监控项的最小更新周期都大于或等于该时间。
从Zabbix 2.2.0开始支持该参数。|<|
|VMwarePerfFrequency|no|10-86400|60|间隔多少秒从单个VMware服务检索性能计数器统计数据。
该时间为任一VMware [监控项](/zh/manual/config/items/itemtypes/simple_checks/vmware_keys#footnotes)（使用VMware性能计数器）的最小更新间隔。
从Zabbix 2.2.9, 2.4.4开始支持该参数。|<|
|VMwareTimeout|no|1-300|10|vmware采集器等待 VMware 服务(vCenter or ESX 管理程序)响应的最大时长。
从Zabbix 2.2.9, 2.4.4开始支持该参数。|<|
[comment]: # ({/0e27a1f6-01eb45e4})