Ж4. Конфигурационный файл Прокси-сервера Dr.Web

Конфигурационный файл Прокси-сервера drwcsd-proxy.conf представлен в формате XML и располагается в следующем каталоге:

ОС Windows: C:\ProgramData\Doctor Web\drwcs\etc

ОС Linux: /var/opt/drwcs/etc

ОС FreeBSD: /var/drwcs/etc

Описание параметров конфигурационного файла Прокси-сервера Dr.Web:

<listen spec="">

Корневой элемент <drwcsd-proxy> содержит один или несколько обязательных элементов <listen>, определяющих основные настройки для приема соединений Прокси-сервером.

Элемент <listen> содержит единственный обязательный атрибут spec, атрибуты которого определяют на каком интерфейсе "слушать" входящие подключения клиентов и запускать ли на этом интерфейсе режим discovery.

Атрибуты элемента spec:

Атрибут

Обязательное

Допустимые значения

Описание

По умолчанию

ip | unix

да

Тип протокола для приема входящих соединений. В качестве параметра указывается адрес, прослушиваемый Прокси-сервером.

0.0.0.0 | -

port

нет

Номер порта, прослушиваемого Прокси-сервером.

2193

discovery

нет

yes, no

Режим имитации Сервера Dr.Web. Позволяет клиентам обнаруживать Прокси-сервер в качестве Сервера Dr.Web в процессе его поиска через широковещательные запросы.

yes

multicast

нет

yes, no

Режим "прослушивания" сети для приема широковещательных запросов Прокси-сервером.

yes

multicast-group

нет

Многоадресная группа, в которой располагается Прокси-сервер.

231.0.0.1

[ff18::231.0.0.1]

В зависимости от протокола список необязательных атрибутов, указываемых в атрибуте spec, изменяет свой состав.

Список необязательных свойств, которые могут быть заданы (+) или не могут быть заданы (–) в атрибуте spec в зависимости от протокола:

Протокол

Наличие свойств

port

discovery

multicast

multicast-group

ip

+

+

+

+

unix

+

-

-

-

Включение режима discovery необходимо указывать явно в любом случае, даже если уже включен режим multicast.

 

Алгоритм переадресации при наличии списка Серверов Dr.Web приведен в Руководстве администратора.

<compression mode="" level="">

Элемент <compression> в качестве дочернего для элемента <listen> определяет параметры сжатия на каналах клиент — Прокси-сервер.

Описание атрибутов:

Атрибут

Допустимые значения

Описание

По умолчанию

mode

yes

Сжатие включено.

possible

no

Сжатие отключено.

possible

Сжатие возможно.

level

целое число от 1 до 9

Уровень сжатия. Только для канала клиент — Прокси-сервер

8

<encryption mode="">

Элемент <encryption> в качестве дочернего для элемента <listen> определяет параметры шифрования на каналах клиент — Прокси-сервер.

Описание атрибутов:

Атрибут

Допустимые значения

Описание

По умолчанию

mode

yes

Шифрование включено.

possible

no

Шифрование отключено.

possible

Шифрование возможно.

<forward to="" master="">

Задает настройки, определяющие переадресацию входящих соединений. Элемент <forward> является обязательным. Может быть задано несколько элементов <forward> с различными значениями атрибутов.

Описание атрибутов:

Атрибут

Допустимые значения

Описание

Обязательный

to

Адрес задается в соответствии со спецификацией сетевого адреса, в частности, в формате tcp/<DNS_name>:<port>.

Адрес Сервера Dr.Web, на который будет перенаправлено соединение.

да

master

yes — Сервер Dr.Web будет безусловным управляющим.

no — Сервер Dr.Web не будет управляющим ни при каких условиях.

possible — Сервер Dr.Web будет управляющим только в том случае, если нет безусловных управляющих (со значением yes для атрибута master).

Атрибут определяет, возможно ли удаленное редактирование настроек Прокси-сервера через Центр управления Сервера Dr.Web, указанного в атрибуте to.

Вы можете назначить любое количество Серверов Dr.Web управляющими (значение master="yes"), подключение осуществляется ко всем управляющим Серверам Dr.Web по порядку следования в настройках Прокси-сервера до первого получения валидной (не пустой) конфигурации.

Также вы можете не назначать ни один из Серверов Dr.Web управляющим (значение master="no"). В этом случае настройка параметров Прокси-сервера (в том числе назначение управляющих Серверов Dr.Web) возможна только локально через конфигурационный файл Прокси-сервера.

нет

Если для Сервера Dr.Web атрибут master отсутствует, то по умолчанию считается, что master="possible".

В конфигурационном файле, созданном инсталлятором при установке Прокси-сервера, атрибут master не определен ни для одного из Серверов Dr.Web.

<compression mode="" level="">

Элемент <compression> в качестве дочернего для элемента <forward> определяет параметры сжатия на каналах Сервер Dr.Web — Прокси-сервер. Атрибуты аналогичны описанным выше.

<encryption mode="">

Элемент <encryption> в качестве дочернего для элемента <listen> определяет параметры шифрования на каналах Сервер Dr.Web — Прокси-сервер. Атрибуты аналогичны описанным выше.

<update-bandwidth value="" queue-size="">

Элемент <update-bandwidth> позволяет установить ограничение скорости при передаче обновлений от Сервера Dr.Web клиентам и количество клиентов, скачивающих обновления одновременно.

Описание атрибутов:

Атрибут

Допустимые значения

Описание

По умолчанию

value

КБ/с

unlimited

Максимальное значение суммарной скорости при передаче обновлений.

unlimited

queue-size

целое положительное число

unlimited

Максимальное допустимое количество сессий раздачи обновлений, запущенных одновременно с Сервера Dr.Web. При достижении указанного ограничения запросы от Агентов размещаются в очереди ожидания. Размер очереди ожидания не ограничен.

unlimited

<bandwidth value="" time-map="">

У элемента <update-bandwidth> может быть один или несколько дочерних элементов <bandwidth>. Данный элемент позволяет установить ограничение на скорость передачи данных на заданный промежуток времени.

Описание атрибутов:

Атрибут

Допустимые значения

Описание

По умолчанию

value

КБ/с

unlimited

Максимальное значение суммарной скорости при передаче данных при обновлении Агента.

unlimited

time-map

Маска, указывающая на временной промежуток, в течение которого будет активно ограничение.

Значение атрибута time-map задается автоматически после указания соответствующей настройки в веб-интерфейсе Центра управления (см. Руководство администратора, раздел Удаленная настройка Прокси-сервера). Задать time-map вручную через конфигурационный файл удобным способом на данный момент нельзя.

<install-bandwidth value="" queue-size="">

Элемент <install-bandwidth> позволяет установить ограничение скорости передачи данных при установке Агентов и количество клиентов, скачивающих данные для установки одновременно.

Описание атрибутов:

Атрибут

Допустимые значения

Описание

По умолчанию

value

КБ/с

unlimited

Максимальное значение суммарной скорости при передаче данных в процессе установки Агентов.

unlimited

queue-size

целое положительное число

unlimited

Максимальное допустимое количество сессий установки Агента, запущенных одновременно с Сервера Dr.Web. При достижении указанного ограничения запросы от Агентов размещаются в очереди ожидания. Размер очереди ожидания не ограничен.

unlimited

<bandwidth value="" time-map="">

У элемента <install-bandwidth> может быть один или несколько дочерних элементов <bandwidth>. Данный элемент позволяет установить ограничение на скорость передачи данных на заданный промежуток времени.

Описание атрибутов:

Атрибут

Допустимые значения

Описание

По умолчанию

value

КБ/с

unlimited

Максимальное значение суммарной скорости при передаче данных при установке Агента.

unlimited

time-map

Маска, указывающая на временной промежуток, в течение которого будет активно ограничение.

Значение атрибута time-map задается автоматически после указания соответствующей настройки в веб-интерфейсе Центра управления (см. Руководство администратора, раздел Удаленная настройка Прокси-сервера). Задать time-map вручную через конфигурационный файл удобным способом на данный момент нельзя.

<cache enabled="">

Настройки кеша репозитория Прокси-сервера.

Описание атрибутов:

Атрибут

Допустимые значения

Описание

По умолчанию

enabled

yes | no

Определяет, включено ли кеширование.

yes

Элемент <cache> содержит следующие дочерние элементы:

Элемент

Допустимые значения

Описание

По умолчанию

<maximum-revision-queue size="">

целое положительное число

Количество хранимых ревизий.

3

<clean-interval value="">

целое положительное число

Временной интервал между очистками старых ревизий в минутах.

60

<unload-interval value="">

целое положительное число

Временной интервал между выгрузками из памяти неиспользуемых файлов в минутах.

10

<repo-check mode="">

idle | sync

Проверка целостности кеша либо при запуске (может занять продолжительное время), либо в фоновом режиме.

idle

<synchronize enabled="" schedule="">

Настройки синхронизации репозиториев Прокси-сервера и Сервера Dr.Web.

Описание атрибутов:

Атрибут

Допустимые значения

Описание

По умолчанию

enabled

yes | no

Определяет, включена ли синхронизация репозиториев.

yes

schedule

Расписание, согласно которому будет осуществляться синхронизация заданных продуктов.

Значение атрибута schedule задается автоматически после указания соответствующей настройки в веб-интерфейсе Центра управления (см. Руководство администратора, раздел Удаленная настройка Прокси-сервера). Задать schedule вручную через конфигурационный файл удобным способом на данный момент нельзя.

В качестве дочерних элементов <product name=""> приводится список продуктов, которые будут синхронизироваться:

05-drwmeta — данные безопасности Сервера Dr.Web,

10-drwbases — вирусные базы,

10-drwgatedb — базы SpIDer Gate,

10-drwspamdb — базы Антиспама,

10-drwupgrade — Модуль обновления Dr.Web,

15-drwhashdb — известные хеши угроз,

20-drwagent — Агент Dr.Web для Windows,

20-drwandroid11 — базы Dr.Web для Android,

20-drwcs — Сервер Dr.Web,

20-drwunix — Агент Dr.Web для UNIX,

20-drwcsdoc — документация,

40-drwproxy — Прокси-сервер Dr.Web,

70-drwextra — корпоративные продукты Dr.Web,

70-drwutils — административные утилиты Dr.Web,

80-drwnews — новости компании «Доктор Веб».

<events enabled="" schedule="">

Настройки кеширования событий, полученных от Агентов.

Описание атрибутов:

Атрибут

Допустимые значения

Описание

По умолчанию

enabled

yes | no

Определяет, включено ли кеширование событий.

Если включено, то события будут отправляться на Сервер Dr.Web согласно расписанию. Если отключено — события будут отправляться на Сервер Dr.Web сразу после их получения Прокси-сервером.

yes

schedule

Расписание, согласно которому будет осуществляться передача событий, полученных от Агентов.

Значение атрибута schedule задается автоматически после указания соответствующей настройки в веб-интерфейсе Центра управления (см. Руководство администратора, раздел Удаленная настройка Прокси-сервера). Задать schedule вручную через конфигурационный файл удобным способом на данный момент нельзя.

<update enabled="" schedule="">

Настройка автоматического обновления Прокси-сервера.

При включенном автоматическом обновлении, если синхронизация включена, то обновления Прокси-сервера будут скачиваться с Сервера Dr.Web согласно расписанию синхронизации (см. выше) и устанавливаться согласно расписанию обновления (по умолчанию без ограничений по времени). Если синхронизация отключена, то скачивание и установка производятся по расписанию обновления (по умолчанию без ограничений по времени).

Описание атрибутов:

Атрибут

Допустимые значения

Описание

По умолчанию

enabled

yes | no

Определяет, включено ли автоматическое обновление.

yes

schedule

Расписание, согласно которому будет осуществляться скачивание (если не задана синхронизация) и установка обновлений.

Значение атрибута schedule задается автоматически после указания соответствующей настройки в веб-интерфейсе Центра управления (см. Руководство администратора, раздел Удаленная настройка Прокси-сервера). Задать schedule вручную через конфигурационный файл удобным способом на данный момент нельзя.

По умолчанию автоматическое обновление разрешено без ограничений по времени.

<core-dump enabled="" maximum="">

Режим сбора и количество дампов памяти в случае возникновения SEH-исключения.

Настройка дампов памяти доступна только для ОС Windows.

 

Для сбора дампа памяти ОС должна содержать библиотеку dbghelp.dll.

Дамп сохраняется в каталоге: %APPDATA%\Doctor Web\drwcsd-proxy\dump\

Описание атрибутов:

Атрибут

Допустимые значения

Описание

По умолчанию

enabled

yes | no

Определяет, включен ли сбор дампов.

yes

maximum

целое положительное число

Максимальное количество дампов. Более старые удаляются.

10

<dns>

Настройки DNS.

<timeout value="">

Тайм-аут в секундах для разрешения прямых/обратных DNS-запросов. Оставьте значение пустым, чтобы не ограничивать время ожидания до окончания разрешения.

<retry value="">

Максимальное количество повторных DNS-запросов при неуспешном разрешении DNS-запроса.

<cache enabled="" negative-ttl="" positive-ttl="">

Время хранения в кеше ответов от DNS-сервера.

Описание атрибутов:

Атрибут

Допустимые значения

Описание

enabled

yes — хранить ответы в кеше,

no — не хранить ответы в кеше.

Режим хранения ответов в кеше.

negative-ttl

Время хранения в кеше (TTL) отрицательных ответов от DNS-сервера в минутах.

positive-ttl

Время хранения в кеше (TTL) положительных ответов от DNS-сервера в минутах.

<servers>

Список серверов DNS, заменяющий системный список по умолчанию. Содержит один или несколько дочерних элементов <server address="">, в которых параметр address определяет IP-адрес сервера.

<domains>

Список доменов DNS, заменяющий системный список по умолчанию. Содержит один или несколько дочерних элементов <domain name="">, в которых параметр name определяет имя домена.