Виртуальный хост - это логическое объединение настроенных веб-приложений, связанное с определенным именем хоста. В большинстве простых вариантов конфигурации достаточно виртуального хоста по умолчанию (default_host).
Name | Type | Default | Description |
---|---|---|---|
id | string | Уникальный ИД конфигурации. | |
enabled | boolean | true | Включить виртуальный хост. |
allowFromEndpointRef | Список ссылок на элементы httpEndpoint верхнего уровня (строка, разделенная запятыми). | Укажите идентификатор одной или нескольких конечных точек HTTP, входящий трафик с которых будет разрешено принимать на этом виртуальном хосте. |
Свяжите хост и порт с виртуальным хостом, указав их в формате хост:порт. Хост можно задать как IP-адрес, доменное имя хоста с суффиксом имени домена, доменное имя хоста или значение *, соответствующее всем хостам. Обратите внимание, что адреса IPv6 следует заключать в квадратные скобки [].
Укажите идентификатор одной или нескольких конечных точек HTTP, входящий трафик с которых будет разрешено принимать на этом виртуальном хосте.
Name | Type | Default | Description |
---|---|---|---|
id | string | Уникальный ИД конфигурации. | |
onError |
| WARN | Действие при сбое во время запуска конечной точки. IGNORE Сервер не будет выдавать предупреждения и сообщения об ошибках при обнаружении ошибки конфигурации. WARN Сервер будет выдавать предупреждения и сообщения об ошибках при обнаружении ошибки конфигурации. FAIL Сервер выдаст предупреждение или сообщение об ошибке при первом возникновении ошибки и остановится. |
enabled | boolean | true | Позволяет сделать конечную точку доступной или недоступной. Если значение равно true, то конечная точка активируется диспетчером для обработки запросов HTTP. |
host | string | localhost | IP-адрес, полное доменное имя хоста или краткое имя хоста, применяемые клиентом для запроса ресурса. Для выбора всех доступных сетевых интерфейсов укажите '*'. |
httpPort | int Min: -1 Max: 65535 | Номер порта для запросов HTTP клиента. Для выключения порта укажите значение -1. | |
httpsPort | int 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 для конечной точки.
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | boolean | true | Разрешает применять поддерживаемые соединения (HTTP keepalive). Если значение равно true, соединение сохраняется активным для передачи нескольких последовательных запросов и ответов. Если значение равно false, соединение закрывается сразу после отправки ответа. |
maxKeepAliveRequests | int 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 сек. |
removeServerHeader | boolean | false | Удаляет информацию о реализации сервера из заголовков HTTP, а также выключает страницу приветствия профайла Liberty по умолчанию. |
NoCacheCookiesControl | boolean | true | Позволяет пользователю указать, приводит ли наличие заголовка Set-Cookie к обновлению заголовка Cache-Control с использованием соответствующего значения no-cache. При этом также добавляется заголовок Expires. |
AutoDecompression | boolean | true | Управляет автоматическим развертыванием данных тела входящего запроса в канале HTTP. |
allowFromEndpoint > sslOptions
Параметры протокола SSL для конечной точки.
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | Период (с точностью до секунды) | 1d | Время, в течение которого следует ждать завершения операции чтения или записи через сокет. Это значение переопределяется тайм-аутом, заданным на уровне протокола. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m) или секунды (s). Например, укажите 30 секунд как 30s. Одна запись может включать несколько значений. Так, 1m30s равно 90 сек. |
suppressHandshakeErrors | boolean | false | Отключить протоколирование ошибок процедуры согласования SSL. Ошибки процедуры согласования SSL могут возникать во время нормальной работы, но эти сообщения могут быть полезны в случае неполадок SSL. |
sslRef | Ссылка на элемент ssl верхнего уровня (строка). | Набор конфигураций SSL по умолчанию. Значение по умолчанию: defaultSSLSettings. | |
sslSessionTimeout | Период (с точностью до миллисекунды) | 8640ms | Предельное значение тайм-аута для сеанса SSL в канале SSL. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m), секунды (s) или миллисекунды (ms). Например, укажите 500 миллисекунд как 500ms. Одна запись может включать несколько значений. Так, 1s500ms равно 1,5 сек. |
allowFromEndpoint > tcpOptions
Параметры протокола TCP для конечной точки.
Name | Type | Default | Description |
---|---|---|---|
inactivityTimeout | Период (с точностью до миллисекунды) | 60s | Время, в течение которого следует ждать завершения операции чтения или записи через сокет. Это значение переопределяется тайм-аутом, заданным на уровне протокола. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m), секунды (s) или миллисекунды (ms). Например, укажите 500 миллисекунд как 500ms. Одна запись может включать несколько значений. Так, 1s500ms равно 1,5 сек. |
soReuseAddr | boolean | true | Допускает немедленное повторное связывание с портом при отсутствии активного получателя запросов. |
addressIncludeList | string | Разделенный запятыми список адресов, которым разрешены входящие соединения в этой конечной точке. Можно указать адреса IPv4 или IPv6. Все значения в адресе IPv4 или IPv6 должны задаваться числом или символом подстановки звездочка. | |
addressExcludeList | string | Разделенный запятыми список адресов, которым не разрешены входящие соединения в этой конечной точке. Можно указать адреса IPv4 или IPv6. Все значения в адресе IPv4 или IPv6 должны задаваться числом или символом подстановки звездочка. | |
hostNameIncludeList | string | Разделенный запятыми список имен хостов, которым разрешены входящие соединения в этой конечной точке. Имя хоста указывается без учета регистра и может начинаться с символа звездочка, используемого в качестве символа подстановки. Однако звездочку можно указывать не в любом месте имени хоста. Например, *.abc.com - допустимое имя хоста, а *.abc.* нет. | |
hostNameExcludeList | string | Разделенный запятыми список имен хостов, которым не разрешены входящие соединения в этой конечной точке. Имя хоста указывается без учета регистра и может начинаться с символа звездочка, используемого в качестве символа подстановки. Однако звездочку можно указывать не в любом месте имени хоста. Например, *.abc.com - допустимое имя хоста, а *.abc.* нет. |
allowFromEndpoint > accessLogging
Конфигурация протоколов доступа HTTP для конечной точки.
Name | Type | Default | Description |
---|---|---|---|
enabled | boolean | true | Включить ведение протокола доступа. |
filePath | Путь к файлу | ${server.output.dir}/logs/http_access.log | Путь и имя файла протокола доступа. В пути к файлу можно использовать стандартные переменные подстановки, такие как ${server.output.dir}. |
logFormat | string | %h %u %{t}W "%r" %s %b | Задает формат протокола, в который заносится информации о доступе клиентов. |
maxFileSize | int Min: 0 | 20 | Максимальный размер файла протокола в мегабайтах. При его превышении создается новый файл. Нулевое значение указывает, что размер не ограничен. |
maxFiles | int Min: 0 | 2 | Максимальное число файлов протокола. При его превышении заменяется самый старый файл. Нулевое значение указывает, что число не ограничено. |