virtualHost - Виртуальный хост (virtualHost)

Виртуальный хост - это логическое объединение настроенных веб-приложений, связанное с определенным именем хоста. В большинстве простых вариантов конфигурации достаточно виртуального хоста по умолчанию (default_host).

NameTypeDefaultDescription
idstringУникальный ИД конфигурации.
enabledbooleantrueВключить виртуальный хост.
allowFromEndpointRefСписок ссылок на элементы httpEndpoint верхнего уровня (строка, разделенная запятыми).Укажите идентификатор одной или нескольких конечных точек HTTP, входящий трафик с которых будет разрешено принимать на этом виртуальном хосте.

hostAlias

Свяжите хост и порт с виртуальным хостом, указав их в формате хост:порт. Хост можно задать как IP-адрес, доменное имя хоста с суффиксом имени домена, доменное имя хоста или значение *, соответствующее всем хостам. Обратите внимание, что адреса IPv6 следует заключать в квадратные скобки [].

allowFromEndpoint

Укажите идентификатор одной или нескольких конечных точек HTTP, входящий трафик с которых будет разрешено принимать на этом виртуальном хосте.

NameTypeDefaultDescription
idstringУникальный ИД конфигурации.
onError
  • IGNORE
  • WARN
  • FAIL
WARNДействие при сбое во время запуска конечной точки.
IGNORE
Сервер не будет выдавать предупреждения и сообщения об ошибках при обнаружении ошибки конфигурации.
WARN
Сервер будет выдавать предупреждения и сообщения об ошибках при обнаружении ошибки конфигурации.
FAIL
Сервер выдаст предупреждение или сообщение об ошибке при первом возникновении ошибки и остановится.
enabledbooleantrueПозволяет сделать конечную точку доступной или недоступной. Если значение равно true, то конечная точка активируется диспетчером для обработки запросов HTTP.
hoststringlocalhostIP-адрес, полное доменное имя хоста или краткое имя хоста, применяемые клиентом для запроса ресурса. Для выбора всех доступных сетевых интерфейсов укажите '*'.
httpPortint
Min: -1

Max: 65535
Номер порта для запросов HTTP клиента. Для выключения порта укажите значение -1.
httpsPortint
Min: -1

Max: 65535
Порт для запросов HTTP клиента, защищенных с помощью SSL (https). Для выключения порта укажите значение -1.
httpOptionsRefСсылка на элемент httpOptions верхнего уровня (строка).defaultHttpOptionsПараметры протокола HTTP для конечной точки.
sslOptionsRefСсылка на элемент sslOptions верхнего уровня (строка).Параметры протокола SSL для конечной точки.
tcpOptionsRefСсылка на элемент tcpOptions верхнего уровня (строка).defaultTCPOptionsПараметры протокола TCP для конечной точки.
accessLoggingRefСсылка на элемент httpAccessLogging верхнего уровня (строка).Конфигурация протоколов доступа HTTP для конечной точки.

allowFromEndpoint > httpOptions

Параметры протокола HTTP для конечной точки.

NameTypeDefaultDescription
keepAliveEnabledbooleantrueРазрешает применять поддерживаемые соединения (HTTP keepalive). Если значение равно true, соединение сохраняется активным для передачи нескольких последовательных запросов и ответов. Если значение равно false, соединение закрывается сразу после отправки ответа.
maxKeepAliveRequestsint
Min: -1
100Максимальное число запросов, допустимых для поддерживаемых соединений HTTP. Значение -1 указывает, что число не ограничено.
persistTimeoutПериод (с точностью до секунды)30sВремя, в течение которого сокет может простаивать в промежутке между обработкой запросов. Этот параметр действует только в случае применения поддерживаемых соединений. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m) или секунды (s). Например, укажите 30 секунд как 30s. Одна запись может включать несколько значений. Так, 1m30s равно 90 сек.
readTimeoutПериод (с точностью до секунды)60sВремя, в течение которого следует ждать завершения операции чтения в сокете после первоначального запроса на чтение. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m) или секунды (s). Например, укажите 30 секунд как 30s. Одна запись может включать несколько значений. Так, 1m30s равно 90 сек.
writeTimeoutПериод (с точностью до секунды)60sВремя, в течение которого следует ждать передачи очередной порции ответных данных через сокет. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m) или секунды (s). Например, укажите 30 секунд как 30s. Одна запись может включать несколько значений. Так, 1m30s равно 90 сек.
removeServerHeaderbooleanfalseУдаляет информацию о реализации сервера из заголовков HTTP, а также выключает страницу приветствия профайла Liberty по умолчанию.
NoCacheCookiesControlbooleantrueПозволяет пользователю указать, приводит ли наличие заголовка Set-Cookie к обновлению заголовка Cache-Control с использованием соответствующего значения no-cache. При этом также добавляется заголовок Expires.
AutoDecompressionbooleantrueУправляет автоматическим развертыванием данных тела входящего запроса в канале HTTP.

allowFromEndpoint > sslOptions

Параметры протокола SSL для конечной точки.

NameTypeDefaultDescription
sessionTimeoutПериод (с точностью до секунды)1dВремя, в течение которого следует ждать завершения операции чтения или записи через сокет. Это значение переопределяется тайм-аутом, заданным на уровне протокола. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m) или секунды (s). Например, укажите 30 секунд как 30s. Одна запись может включать несколько значений. Так, 1m30s равно 90 сек.
suppressHandshakeErrorsbooleanfalseОтключить протоколирование ошибок процедуры согласования SSL. Ошибки процедуры согласования SSL могут возникать во время нормальной работы, но эти сообщения могут быть полезны в случае неполадок SSL.
sslRefСсылка на элемент ssl верхнего уровня (строка).Набор конфигураций SSL по умолчанию. Значение по умолчанию: defaultSSLSettings.
sslSessionTimeoutПериод (с точностью до миллисекунды)8640msПредельное значение тайм-аута для сеанса SSL в канале SSL. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m), секунды (s) или миллисекунды (ms). Например, укажите 500 миллисекунд как 500ms. Одна запись может включать несколько значений. Так, 1s500ms равно 1,5 сек.

allowFromEndpoint > tcpOptions

Параметры протокола TCP для конечной точки.

NameTypeDefaultDescription
inactivityTimeoutПериод (с точностью до миллисекунды)60sВремя, в течение которого следует ждать завершения операции чтения или записи через сокет. Это значение переопределяется тайм-аутом, заданным на уровне протокола. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m), секунды (s) или миллисекунды (ms). Например, укажите 500 миллисекунд как 500ms. Одна запись может включать несколько значений. Так, 1s500ms равно 1,5 сек.
soReuseAddrbooleantrueДопускает немедленное повторное связывание с портом при отсутствии активного получателя запросов.
addressIncludeListstringРазделенный запятыми список адресов, которым разрешены входящие соединения в этой конечной точке. Можно указать адреса IPv4 или IPv6. Все значения в адресе IPv4 или IPv6 должны задаваться числом или символом подстановки звездочка.
addressExcludeListstringРазделенный запятыми список адресов, которым не разрешены входящие соединения в этой конечной точке. Можно указать адреса IPv4 или IPv6. Все значения в адресе IPv4 или IPv6 должны задаваться числом или символом подстановки звездочка.
hostNameIncludeListstringРазделенный запятыми список имен хостов, которым разрешены входящие соединения в этой конечной точке. Имя хоста указывается без учета регистра и может начинаться с символа звездочка, используемого в качестве символа подстановки. Однако звездочку можно указывать не в любом месте имени хоста. Например, *.abc.com - допустимое имя хоста, а *.abc.* нет.
hostNameExcludeListstringРазделенный запятыми список имен хостов, которым не разрешены входящие соединения в этой конечной точке. Имя хоста указывается без учета регистра и может начинаться с символа звездочка, используемого в качестве символа подстановки. Однако звездочку можно указывать не в любом месте имени хоста. Например, *.abc.com - допустимое имя хоста, а *.abc.* нет.

allowFromEndpoint > accessLogging

Конфигурация протоколов доступа HTTP для конечной точки.

NameTypeDefaultDescription
enabledbooleantrueВключить ведение протокола доступа.
filePathПуть к файлу${server.output.dir}/logs/http_access.logПуть и имя файла протокола доступа. В пути к файлу можно использовать стандартные переменные подстановки, такие как ${server.output.dir}.
logFormatstring%h %u %{t}W "%r" %s %bЗадает формат протокола, в который заносится информации о доступе клиентов.
maxFileSizeint
Min: 0
20Максимальный размер файла протокола в мегабайтах. При его превышении создается новый файл. Нулевое значение указывает, что размер не ограничен.
maxFilesint
Min: 0
2Максимальное число файлов протокола. При его превышении заменяется самый старый файл. Нулевое значение указывает, что число не ограничено.