# 2 Zabbix прокси

::: noteclassic
Значения по умолчанию являются умолчаниями демона, но не
значениями которые указаны в поставляемых файлах
конфигурации.
:::

Поддерживаемые параметры в файле конфигурации Zabbix прокси:

|Параметр|Обязательный|Диапазон|Умолчание|Описание|
|----------------|------------------------|----------------|------------------|----------------|
|AllowRoot|нет|<|0|Разрешение прокси запускаться под "root". Если отключено и прокси запускается из под "root", прокси попробует переключиться на пользователя "zabbix". Не имеет смысла, если прокси запускается под обычным пользователем.<br>0 - не разрешено<br>1 - разрешено<br>Данный параметр поддерживается с начиная с Zabbix 2.2.0.|
|CacheSize|нет|128K-8G|8М|Размер кэша конфигурации, в байтах.<br>Размер распределенной памяти для хранения данных узлов сети, элементов данных и триггеров.<br>Максимальный предел был 2G до Zabbix 2.2.3.|
|ConfigFrequency|нет|1-604800|3600|Как часто прокси будет получать данные конфигурации от сервера, в секундах.<br>Параметр активного прокси. Игнорируется пассивными прокси (смотрите параметр ProxyMode).|
|DBHost|нет|<|localhost|Имя хоста базы данных.<br>В случае localhost или пустой строки для MySQL, будет использоваться сокет. В случае PostgreSQL<br>только при пустой строке будет произведена попытка использовать сокет.|
|DBName|да|<|<|Имя базы данных или путь к файлу базы данных для SQLite3 (архитектура Zabbix со множеством процессов не позволяет использовать [in-memory базу данных](https://www.sqlite.org/inmemorydb.html), например `:memory:`, `file::memory:?cache=shared` или `file:memdb1?mode=memory&cache=shared`).<br><br>Предупреждение: Не пытайтесь использовать ту же базу данных, которую использует Zabbix сервер.|
|DBPassword|нет|<|<|Пароль к базе данных. Игнорируется при использовании SQLite.<br>Закомментируйте эту строку, если пароль не используется.|
|DBSchema|нет|<|<|Имя схемы. Используется для IBM DB2 и PostgreSQL.|
|DBSocket|нет|<|3306|Путь к сокету MySQL.<br>Порт базы данных, когда не используется локальный сокет. Игнорируется при СУБД SQLite.|
|DBUser|нет|<|<|Пользователь базы данных. Игнорируется при SQLite.|
|DataSenderFrequency|нет|1-3600|1|Прокси будет отправлять собранные значения серверу каждые N секунд. Обратите внимание, что активный прокси всё равно будет опрашивать Zabbix сервер каждую секунд на предмет наличия задач удалённых команд.<br>Параметр активного прокси. Игнорируется пассивными прокси (смотрите параметр ProxyMode).|
|DebugLevel|нет|0-5|3|Задает уровень журналирования:<br>0 - основная информация о запуске и остановки процессов Zabbix<br>1 - критичная информация<br>2 - информация об ошибках<br>3 - предупреждения<br>4 - для отладки (записывается очень много информации)<br>5 - расширенная отладка (записывается еще больше информации)|
|EnableRemoteCommands|нет|<|0|Разрешены ли удаленные команды с Zabbix сервера.<br>0 - не разрешены<br>1 - разрешены<br>Этот параметр поддерживается начиная с Zabbix 3.4.0.|
|ExternalScripts|нет|<|/usr/local/share/zabbix/externalscripts|Размещение внешних скриптов (зависит от указанной при компиляции переменной *datadir*).|
|Fping6Location|нет|<|/usr/sbin/fping6|Размещение fping6.<br>Убедитесь, что владельцем бинарного файла fping6 является root и флаг SUID установлен.<br>Оставьте пустым ("Fping6Location="), если ваша утилита fping поддерживает обработку IPv6 адресов.|
|FpingLocation|нет|<|/usr/sbin/fping|Размещение fping.<br>Убедитесь, что владельцем бинарного файла fping является root и флаг SUID установлен!|
|HeartbeatFrequency|нет|0-3600|60|Частота контрольных сообщений в секундах.<br>Используется для мониторинга доступности прокси на стороне сервера.<br>0 - контрольные сообщения отключены.<br>Параметр активного прокси. Игнорируется пассивными прокси (смотрите параметр ProxyMode).|
|HistoryCacheSize|нет|128K-2G|16M|Размер кэша истории, в байтах.<br>Размер разделяемой памяти для хранения данных истории.|
|HistoryIndexCacheSize|нет|128K-2G|4M|Размер кэша индекса истории, в байтах.<br>Размер разделяемой памяти для индексации данных записываемой истории в кэш истории.<br>Кэшу индекса необходимо около 100 байт на кэширование одного элемента данных.<br>Этот параметр поддерживается начиная с Zabbix 3.0.0.|
|Hostname|нет|<|Задается HostnameItem'ом|Уникальное регистрозависимое имя прокси. Убедитесь, что имя прокси совпадает на стороне сервера!<br>Допустимые символы: цифробуквенные, '.', ' ', '\_' и '-'.<br>Максимальная длина: 64.|
|HostnameItem|нет|<|system.hostname|Элемент данных используется, если параметр Hostname не задан (работает на прокси аналогично как на агенте)<br>UserParameters, счетчики производительности или алиасы не поддерживаются, но поддерживается system.run\[\].<br><br>Игнорируется, если задан параметр Hostname.<br><br>Параметр поддерживается начиная с версии Zabbix 1.8.6.|
|HousekeepingFrequency|no|1-24|1|Как часто Zabbix будет выполнять процедуру очистки базы (в часах).<br>Автоматическая очистка базы данных удаляет устаревшую информацию из базы данных.<br>*Обратите внимание*: Для предотвращения перегрузки функции очистки (например, когда параметры конфигурации ProxyLocalBuffer или ProxyOfflineBuffer сильно завышены), не более чем 4 периода кратных HousekeepingFrequency часов устаревшей истории будет удалено за один цикл очистки по каждому элементу данных. Таким образом, если HousekeepingFrequency равен 1 часу, то за один цикл будет удалено не более чем 4 часа устаревшей истории (начиная с самой старейшей записи).<br>*На заметку*: Для снижения нагрузки на сервер запуск процессе очистки отложен на 30 минут после запуска сервера. Таким образом, если HousekeepingFrequency равен 1 часу, самая первая процедура очистки запустится через 30 минут после запуска сервера, и затем повторится с задержкой в один час. Такое поведение отсрочки введено начиная с Zabbix 2.4.0.<br>Начиная с **Zabbix 3.0.0** имеется возможность отключить автоматическую очистку истории, указав HousekeepingFrequency равным 0. В этом случае процедуру очистки истории можно запустить только с помощью опции контроля управления *housekeeper\_execute* и периодом удаления устаревшей информации является 4 кратный период начиная с последнего цикла удаления истории, но не менее чем 4 часа и не более 4 дней.|
|Include|нет|<|<|Вы можете включить отдельные файлы или все файлы из папки с файлом конфигурации.<br>Для включения только необходимых файлов из указанной папки, поддерживается символ звездочки для поиска совпадения по маске. Например: `/абсолютный/путь/к/файлам/конфигурации/*.conf`. Совпадение с маской поддерживается начиная с Zabbix 2.4.0.<br>Смотрите [специальные заметки](special_notes_include) по поводу ограничений.|
|JavaGateway|нет|<|<|IP адрес (или имя хоста) Zabbix Java gateway.<br>Требуется только, если запущены Java поллеры.<br>Этот параметр поддерживается начиная с Zabbix 2.0.0.|
|JavaGatewayPort|нет|1024-32767|10052|Порт, который слушает Zabbix Java gateway.<br>Этот параметр поддерживается начиная с Zabbix 2.0.0.|
|ListenIP|no|<|0.0.0.0|Список IP адресов разделенных запятыми, которые должен слушать траппер.<br>Траппер будет слушать все сетевые интерфейсы, если этот параметр не указан.<br>Список из нескольких IP адресов поддерживается начиная с Zabbix 1.8.3.|
|ListenPort|нет|1024-32767|10051|Порт, который слушает траппер.|
|LoadModule|нет|<|<|Модули, которые загружаются во время старта. Модули используются для расширения возможностей сервера.<br>Форматы: Loadmodule=<module.so><br>LoadModule=<path/module.so><br>(начиная с 4.2.3) LoadModule=</abs\_path/module.so><br>Модули должны находиться в папке указанной в параметре LoadModulePath или (начиная с 4.2.3) путь должен быть указан до имени модуля. Если путь до модуля абсолютный (начинается с '/'), тогда LoadModulePath игнорируется.<br>Допускается добавлять несколько параметров LoadModule.|
|LoadModulePath|нет|<|<|Абсолютный путь к папке с прокси модулями.<br>По умолчанию зависит от опций компиляции.|
|LogFile|да, если LogType задан как *file*, иначе<br>нет.|<|<|Имя файла журнала.|
|LogFileSize|нет|0-1024|1|Максимальный размер файла журнала в МБ.<br>0 - отключение автоматической ротации журнала.<br>*Примечание*: Если лимит достигнут и ротация не удалась, по каким-либо причинам, существующий файл журнала очищается и начинается новый.|
|LogRemoteCommands|нет|<|0|Включение журналирования выполняемых shell команд как предупреждений.<br>0 - отключено<br>1 - включено<br>Этот параметр поддерживается начиная с Zabbix 3.4.0.|
|LogType|нет|<|file|Тип вывода журнала:<br>*file* - запись журнала в файл указанный в LogFile параметре,<br>*system* - запись журнала в syslog,<br>*console* - вывод журнала в стандартный вывод.<br>Этот параметр поддерживается начиная с Zabbix 3.0.0.|
|LogSlowQueries|нет|0-3600000|0|Как долго могут выполняться запросы в базу данных до того как они запишутся в журнал (в миллисекундах).<br>0 - не журналировать медленные запросы.<br>Эта опция активируется начиная с DebugLevel=3.<br>Этот параметр поддерживается начиная с Zabbix 1.8.2.|
|PidFile|нет|<|/tmp/zabbix\_proxy.pid|Имя PID файла.|
|ProxyLocalBuffer|нет|0-720|0|Прокси будет локально хранить данные N часов, даже, если данные уже синхронизированы с сервером.<br>Этот параметр можно использовать, если локальные данные используются сторонними приложениями.|
|ProxyMode|нет|0-1|0|Режим работы прокси:<br>0 - прокси в активном режиме.<br>1 - прокси в пассивном режиме.<br>Этот параметр поддерживается начиная с Zabbix 1.8.3.<br>*Обратите внимание*, что (деликатные) данные конфигурации могут стать доступны лицам, имеющим доступ к порту траппера Zabbix сервера, при использовании активного прокси. Такое возможно потому что, кто угодно может представиться активным прокси и запросить данные конфигурации; аутентификация не выполняется.|
|ProxyOfflineBuffer|нет|1-720|1|Прокси будет хранить собранные данные N часов в случае, если нет связи с сервером.<br>Более старые данные будут утеряны.|
|ServerPort|нет|1024-32767|10051|Порт Zabbix траппера на стороне Zabbix сервера.<br>Параметр активного прокси. Игнорируется пассивными прокси (смотрите параметр ProxyMode).|
|Server|да|<|<|Если ProxyMode задан значением *активный режим*:<br>IP адрес или DNS имя Zabbix сервера для получения данных с сервера и отправки данных на сервер.<br><br>Если ProxyMode задан значением *пассивный прокси*:<br>Список разделенных запятой IP адресов, опционально в CIDR нотации, или DNS имен Zabbix серверов.<br>Входящие соединения будут приниматься только с адресов указанных в этом списке. Если включена поддержка IPv6, то '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' обрабатываются одинаково и '::/0' разрешает все IPv4 и IPv6 адреса. '0.0.0.0/0' можно использовать, чтобы разрешить любой IPv4 адрес.<br>*Пример*: Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com|
|SNMPTrapperFile|нет|<|/tmp/zabbix\_traps.tmp|Временный файл, используемый для передачи данных прокси от демона SNMP trap.<br>Должен быть таким же, как и в zabbix\_trap\_receiver.pl или в файле конфигурации SNMPTT.<br>Этот параметр поддерживается начиная с Zabbix 2.0.0.|
|SocketDir|нет|<|/tmp|Папка для хранения IPC сокетов, которые используются внутренними сервисами Zabbix.<br>Этот параметр поддерживается начиная с Zabbix 3.4.0.|
|SourceIP|нет|<|<|Локальный IP адрес для исходящих подключений.|
|SSHKeyLocation|нет|<|<|Размещение публичных и приватных ключей для SSH проверок и действий|
|SSLCertLocation|нет|<|<|Размещение файлов клиентских SSL сертификатов для аутентификации клиента.<br>Этот параметр используется только в веб-мониторинге и поддерживается начиная с Zabbix 2.4.0.|
|SSLKeyLocation|нет|<|<|Размещение файлов приватных SSL ключей для аутентификации клиента.<br>Этот параметр используется только в веб-мониторинге и поддерживается начиная с Zabbix 2.4.0.|
|SSLCALocation|нет|<|<|Переопределение расположения файлов центра сертификации (CA) для верификации SSL сертификатов сервера. Если не задано, будет использоваться общесистемная папка.<br>Обратите внимание, что значение этого параметра задаст CURLOPT\_CAPATH опцию libcurl. Для libcurl версий до 7.42.0, эта опция имеет эффект только, если libcurl скомпилирован для использования OpenSSL. Для получения более подробной информации смотрите [веб-страницу cURL](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html).<br>Этот параметр используется в веб-мониторинге начиная с Zabbix 2.4.0 и при аутентификации SMTP начиная с Zabbix 3.0.0.|
|StartDBSyncers|нет|1-100|4|Количество экземпляров пре-форков DB Syncers.<br>Максимальное количество 64 до версии 1.8.5.<br>Этот параметр поддерживается начиная с Zabbix 1.8.3.|
|StartDiscoverers|нет|0-250|1|Количество экземпляров пре-форков автообнаружения.<br>Максимальное количество 255 до версии 1.8.5.|
|StartHTTPPollers|нет|0-1000|1|Количество экземпляров пре-форков HTTP поллеров.<br>Максимальное количество 255 до версии 1.8.5.|
|StartIPMIPollers|нет|0-1000|0|Количество экземпляров пре-форков IPMI поллеров.<br>Максимальное количество 255 до версии 1.8.5.|
|StartJavaPollers|нет|0-1000|0|Количество экземпляров пре-форков Java поллеров.<br>Этот параметр поддерживается начиная с Zabbix 2.0.0.|
|StartPingers|нет|0-1000|1|Количество экземпляров пре-форков ICMP pingers.<br>Максимальное количество 255 до версии 1.8.5.|
|StartPollersUnreachable|no|0-1000|1|Количество экземпляров пре-форков поллеров для недоступных узлов сети (включая IPMI и Java).<br>Начиная с Zabbix 2.4.0, по крайне один поллер для недоступных хостов должен быть запущен, если обычные поллеры, IPMI или Java запускаются.<br>Максимальное количество 255 до версии 1.8.5.<br>Этот параметр опущен в версии 1.8.3.|
|StartPollers|нет|0-1000|5|Количество экземпляров пре-форков поллеров.<br>Максимальное количество 255 до версии 1.8.5.|
|StartPreprocessors|нет|1-1000|3|Количество экземпляров пре-форков "worker" предварительной обработки**^[1](zabbix_server#примечания)^**.<br>Менеджер предобработки запускается автоматически, когда запускается "worker" предварительной обработки.<br>Этот параметр поддерживается начиная с Zabbix 4.2.0.|
|StartSNMPTrapper|нет|0-1|0|Если значение равно 1, будет запущен процесс SNMP траппера.<br>Этот параметр поддерживается начиная с Zabbix 2.0.0.|
|StartTrappers|нет|0-1000|5|Количество экземпляров пре-форков трапперов.<br>Трапперы принимают входящие подключения от Zabbix sender и активных агентов.<br>Максимальное количество 255 до версии 1.8.5.|
|StartVMwareCollectors|нет|0-250|0|Количество экземпляров пре-форков vmware коллекторов.<br>Этот параметр поддерживается начиная с версии Zabbix 2.2.0.|
|StatsAllowedIP|нет|<|<|Список IP адресов разделённых запятой, опционально в CIDR представлении или DNS имена внешних экземпляров Zabbix. Запрос на предоставление статистики будет приниматься только с адресов указанных здесь. Если этот параметр не задан, запросы на статистику не будут приниматься.<br>Если поддержка IPv6 включена, тогда '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' обрабатываются идентично и '::/0' разрешит любой IPv4 или IPv6 адреса. Можно использовать '0.0.0.0/0', чтобы разрешить любой IPv4 адрес.<br>Например: StatsAllowedIP=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com<br>Этот параметр поддерживается начиная с Zabbix 4.0.5.|
|Timeout|нет|1-30|3|Укажите как долго мы ждем ответа от агента, SNMP устройства или внешней проверки (в секундах).|
|TLSAccept|да для пассивных прокси, если заданы TLS сертификат или параметры PSK (даже при *незашифрованном* соединении), в противном случае - нет|<|<|Какие входящие подключения принимаются от Zabbix сервера. Используется пассивным прокси, игнорируется активным прокси. Можно указывать несколько значений, разделенных запятой:<br>*unencrypted* - принимать подключения без шифрования (по умолчанию)<br>*psk* - принимать подключения с TLS и pre-shared ключем (PSK)<br>*cert* - принимать подключения с TLS и сертификатом<br>Этот параметр поддерживается начиная с Zabbix 3.0.0.|
|TLSCAFile|нет|<|<|Абсолютный путь к файлу, который содержит сертификаты верхнего уровня CA(и) для верификации сертификата узла, используется для зашифрованных соединений между Zabbix компонентами.<br>Этот параметр поддерживается начиная с Zabbix 3.0.0.|
|TLSCertFile|нет|<|<|Абсолютный путь к файлу, который содержит сертификат или цепочку сертификатов, используется для зашифрованных соединений между Zabbix компонентами.<br>Этот параметр поддерживается начиная с Zabbix 3.0.0.|
|TLSConnect|да для активных прокси, если заданы TLS сертификат или параметры PSK (даже при *незашифрованном* соединении), в противном случае - нет|<|<|Как прокси должен соединяться с Zabbix сервером. Используется активным прокси, игнорируется пассивным прокси. Можно указать только одно значение:<br>*unencrypted* - подключаться без шифрования (по умолчанию)<br>*psk* - подключаться, используя TLS и pre-shared ключем (PSK)<br>*cert* - подключаться, используя TLS и сертификат<br>Этот параметр поддерживается начиная с Zabbix 3.0.0.|
|TLSCRLFile|нет|<|<|Абсолютный путь к файлу, который содержит отозванные сертификаты. Этот параметр используется для зашифрованных соединений между Zabbix компонентами.<br>Этот параметр поддерживается начиная с Zabbix 3.0.0.|
|TLSKeyFile|нет|<|<|Абсолютный путь к файлу, который содержит приватный ключ прокси, используется для зашифрованных соединений между Zabbix компонентами.<br>Этот параметр поддерживается начиная с Zabbix 3.0.0.|
|TLSPSKFile|нет|<|<|Абсолютный путь к файлу, который содержит pre-shared ключ прокси, используется для зашифрованных соединений с Zabbix сервером.<br>Этот параметр поддерживается начиная с Zabbix 3.0.0.|
|TLSPSKIdentity|нет|<|<|Строка идентификатор pre-shared ключа, используется для зашифрованных соединений с Zabbix сервером.<br>Этот параметр поддерживается начиная с Zabbix 3.0.0.|
|TLSServerCertIssuer|нет|<|<|Разрешенный эмитент сертификата сервера.<br>Этот параметр поддерживается начиная с Zabbix 3.0.0.|
|TLSServerCertSubject|нет|<|<|Разрешенная тема сертификата сервера.<br>Этот параметр поддерживается начиная с Zabbix 3.0.0.|
|TmpDir|нет|<|/tmp|Папка с временными данными.|
|TrapperTimeout|нет|1-300|300|Укажите, как много секунд траппер может потратить на обработку новых данных.|
|User|нет|<|zabbix|Использование привилегий указанного, существующего пользователя системы.<br>Имеет эффект только, если запускается под 'root' и AllowRoot отключен.<br>Этот параметр поддерживается начиная с Zabbix 2.4.0.|
|UnavailableDelay|нет|1-3600|60|Как часто узел сети будет проверяться на доступность в период его [недоступности](/ru/manual/appendix/items/unreachability#недоступный_узел_сети), в секундах.|
|UnreachableDelay|нет|1-3600|15|Как часто узел сети будет проверяться на доступность в период его [недостижимости](/ru/manual/appendix/items/unreachability#недостижимый_узел_сети), в секундах.|
|UnreachablePeriod|нет|1-3600|45|Через сколько секунд [недостижимости](/ru/manual/appendix/items/unreachability#недостижимый_узел_сети) узел сети считается недоступным.|
|VMwareCacheSize|нет|256K - 2G|8M|Разделяемая память для хранения данных VMware.<br>Можно использовать внутренние проверки VMware - zabbix\[vmware,buffer,…\] для мониторинга использования кэша VMware (смотрите раздел о [внутренних проверках](/ru/manual/config/items/itemtypes/internal))<br>Заметьте, что разделяемая память не выделяется, если экземпляры VMware коллекторов настроены на запуск.<br>Этот параметр поддерживается начиная с Zabbix 2.2.0.|
|VMwareFrequency|нет|10-86400|60|Задержка в секундах между сбором данных с одной службы VMware.<br>Это значение необходимо установить наименьшим значением интервала обновления у любого элемента данных VMware мониторинга.<br>Этот параметр поддерживается начиная с Zabbix 2.2.0.|
|VMwarePerfFrequency|нет|10-86400|60|Задержка в секундах между получением статистики по счётчикам производительности с одной службы VMware.<br>Это значение необходимо установить наименьшим значением интервала обновления у любого [элемента данных](/ru/manual/config/items/itemtypes/simple_checks/vmware_keys#примечания) VMware мониторинга, который использует счётчики производительности VMware.<br>Этот параметр поддерживается начиная с Zabbix 2.2.9, 2.4.4.|
|VMwareTimeout|нет|1-300|10|Максимальное количество секунд, которое коллектор vmware потратит на ожидание ответа со службы VMware (vCenter или ESX гипервизора).<br>Этот параметр поддерживается начиная с Zabbix 2.2.9, 2.4.4.|

::: noteclassic
Zabbix поддерживает файлы конфигурации только в кодировке
UTF-8 без
[BOM](https://ru.wikipedia.org/wiki/Маркер_последовательности_байтов).\
\
Комментарии, начинающиеся с "\#", поддерживаются только в начале
строки.
:::