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

Конфигурационный файл Прокси-сервера 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 в процессе его поиска через широковещательные запросы.

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 – Сервер будет безусловным управляющим.

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

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

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

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

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

нет

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

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

<compression mode="" level="">

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

<encryption mode="">

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

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

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

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

Атрибут

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

Описание

По умолчанию

value

КБ/с

unlimited

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

unlimited

queue-size

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

unlimited

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

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

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

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="" /> приводится список продуктов, которые будут синхронизироваться:

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

10-drwgatedb – базы SpIDer Gate,

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

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

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

20-drwandroid11 – Агент Dr.Web для Android,

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

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

<events enabled="" schedule="" />

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

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

Атрибут

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

Описание

По умолчанию

enabled

yes | no

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

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

yes

schedule

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

Значение параметра schedule определяется аналогично расписанию отправки событий в настройках Центра управления. Генерация schedule вручную на данный момент не предоставляется.

<update enabled="" schedule="" />

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

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

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

Атрибут

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

Описание

По умолчанию

enabled

yes | no

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

yes

schedule

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

Генерация schedule вручную на данный момент не предоставляется. По умолчанию автоматическое обновление разрешено без ограничений по времени.

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

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

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

 

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

Дамп сохраняется в каталоге: %All Users\Application Data%\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 определяет имя домена.