Документация: ПО Факел — разрабатываемая версия

Обратный прокси-сервер

Обзор

Обратный прокси-сервер ПО Факел распределяет входящие соединения TCP и запросы HTTP между группами серверов. Клиенты подключаются к адресу и порту маршрутизатора, а маршрутизатор передает каждое соединение или запрос одному из серверов группы. Это позволяет распределить нагрузку между серверами, исключать из работы неисправные серверы и завершать соединения TLS на маршрутизаторе.

Обратный прокси-сервер настраивается в разделе load-balancing reverse-proxy:

  • service <name> — входящая служба (frontend): адреса (listen-address) и порт (port), на которых принимаются подключения, режим работы (mode, значение по умолчанию http), сертификат TLS из конфигурации PKI (ssl certificate), перенаправление HTTP на HTTPS (redirect-http-to-https), группа серверов по умолчанию (backend) и правила (rule), которые выбирают группу серверов по имени домена или пути URL;

  • backend <name> — группа серверов (backend): серверы (server) с адресом и портом, алгоритм распределения (balance, значение по умолчанию round-robin), проверки доступности серверов (health-check, http-check, параметр check сервера), резервные серверы (backup), тайм-ауты и параметры TLS;

  • global-parameters — общие ограничения (например, max-connections), набор шифров и минимальная версия TLS (значение по умолчанию 1.3);

  • vrf — экземпляр VRF, в котором работает служба.

Команда show reverse-proxy выводит таблицу состояния: для каждой входящей службы, группы серверов и сервера — имя (столбец Proxy name), роль (Role: входящая служба, группа серверов или имя сервера), состояние (Status), частоту запросов (Req rate), время ответа (Resp time) и время с момента последнего изменения состояния (Last change). По этой таблице видно, какие серверы исключены из работы проверкой доступности. Если обратный прокси-сервер не настроен, команда выводит сообщение Reverse-proxy is not configured.

Значения столбца Status:

  • OPEN — входящая служба принимает подключения;

  • UP — сервер прошел проверку доступности; для группы серверов — в группе есть доступный сервер;

  • DOWN — сервер не прошел проверку доступности; для группы серверов — в группе нет доступных серверов;

  • no check — для сервера не включена проверка доступности (параметр check).

Если в группе нет доступных серверов, клиент получает ответ HTTP с кодом 503. Кроме настроенных служб и групп серверов, таблица содержит служебную группу серверов buildin_acme_certbot, которая используется для получения сертификатов по протоколу ACME.

Правила входящей службы (service <name> rule) применяются в порядке возрастания номеров. Запрос передается в группу серверов первого правила, условиям которого он соответствует. Правила перенаправления (set redirect-location) проверяются раньше правил выбора группы серверов (set backend) независимо от номеров. Если запрос не соответствует ни одному правилу, он передается в группу серверов по умолчанию (backend).

Правила группы серверов (backend <name> rule) выбирают сервер группы (set server) по имени домена (domain-name) и перенаправляют запросы (set redirect-location) по пути URL (url-path). Перенаправление выполняется с кодом ответа HTTP 301.

Команда restart reverse-proxy перезапускает службу обратного прокси. Если служба не настроена, команда выводит сообщение Reverse-Proxy not configured. Команда доступна только пользователю уровня «Администратор» (см. Уровни пользователей).

Пример настройки

В примере служба web принимает соединения HTTP на порту 80 и передает их двум серверам группы srv.

Шаг

Команда

Описание

1

set load-balancing reverse-proxy backend srv server s1 address 192.0.2.11

Добавляет в группу серверов srv сервер s1

2

set load-balancing reverse-proxy backend srv server s1 port 8080

Задает порт сервера s1

3

set load-balancing reverse-proxy backend srv server s2 address 192.0.2.12

Добавляет в группу серверов сервер s2

4

set load-balancing reverse-proxy backend srv server s2 port 8080

Задает порт сервера s2

5

set load-balancing reverse-proxy service web listen-address 203.0.113.10

Задает адрес, на котором служба web принимает соединения

6

set load-balancing reverse-proxy service web port 80

Задает порт службы

7

set load-balancing reverse-proxy service web backend srv

Назначает службе группу серверов srv

Список команд

Режим «Конфигурирование»


load-balancing reverse-proxy backend <backend>

Описание:
Создает группу серверов (backend) обратного прокси-сервера.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend>

  • delete load-balancing reverse-proxy backend <backend>

  • show load-balancing reverse-proxy backend <backend>

Аргументы:

  • <backend> — имя группы серверов (backend).

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> balance <balance>

Описание:
Задает алгоритм распределения нагрузки между серверами группы.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> balance <balance>

  • delete load-balancing reverse-proxy backend <backend> balance <balance>

  • show load-balancing reverse-proxy backend <backend> balance

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <balance> — алгоритм распределения. Возможные значения: source-address — выбор сервера по хешу IP-адреса источника; round-robin — поочередный выбор серверов (round robin); least-connection — выбор сервера с наименьшим числом соединений. Значение по умолчанию: round-robin.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> description <description>

Описание:
Добавляет описание группы серверов.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> description <description>

  • delete load-balancing reverse-proxy backend <backend> description <description>

  • show load-balancing reverse-proxy backend <backend> description

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <description> — описание группы серверов. Формат: строка.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> health-check <health-check>

Описание:
Задает проверку доступности серверов группы без использования HTTP. Сервер, который не отвечает по выбранному протоколу, исключается из распределения запросов.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> health-check <health-check>

  • delete load-balancing reverse-proxy backend <backend> health-check <health-check>

  • show load-balancing reverse-proxy backend <backend> health-check

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <health-check> — протокол проверки. Возможные значения: ldap — проверка по протоколу LDAP; mysql — проверка по протоколу MySQL; pgsql — проверка по протоколу PostgreSQL; redis — проверка по протоколу Redis; smtp — проверка по протоколу SMTP.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> http-check expect status <status>

Описание:
Задает код ответа, при котором проверка доступности по HTTP считается пройденной.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> http-check expect status <status>

  • delete load-balancing reverse-proxy backend <backend> http-check expect status <status>

  • show load-balancing reverse-proxy backend <backend> http-check expect status

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <status> — ожидаемый код ответа HTTP. Формат: целое число. Диапазон значений: от 200 до 399.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> http-check expect string <string>

Описание:
Задает строку, которая должна быть в теле ответа, чтобы проверка доступности по HTTP считалась пройденной.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> http-check expect string <string>

  • delete load-balancing reverse-proxy backend <backend> http-check expect string <string>

  • show load-balancing reverse-proxy backend <backend> http-check expect string

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <string> — ожидаемая строка. Формат: строка.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> http-check method <method>

Описание:
Задает метод HTTP, который используется для проверки доступности.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> http-check method <method>

  • delete load-balancing reverse-proxy backend <backend> http-check method <method>

  • show load-balancing reverse-proxy backend <backend> http-check method

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <method> — метод HTTP. Возможные значения: options, head, get, post, put.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> http-check uri <uri>

Описание:
Задает URI, который запрашивается при проверке доступности по HTTP.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> http-check uri <uri>

  • delete load-balancing reverse-proxy backend <backend> http-check uri <uri>

  • show load-balancing reverse-proxy backend <backend> http-check uri

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <uri> — URI проверки, например / или /health.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> http-response-headers <header>

Описание:
Добавляет заголовок HTTP, который включается в ответы группы серверов.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> http-response-headers <header>

  • delete load-balancing reverse-proxy backend <backend> http-response-headers <header>

  • show load-balancing reverse-proxy backend <backend> http-response-headers <header>

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <header> — имя заголовка HTTP. Формат: строка.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> http-response-headers <header> value <value>

Описание:
Задает значение заголовка HTTP.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> http-response-headers <header> value <value>

  • delete load-balancing reverse-proxy backend <backend> http-response-headers <header> value <value>

  • show load-balancing reverse-proxy backend <backend> http-response-headers <header> value

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <header> — имя заголовка HTTP. Формат: строка.

  • <value> — значение заголовка HTTP. Формат: строка.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> logging facility <facility>

Описание:
Включает журналирование сообщений указанной категории для группы серверов.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> logging facility <facility>

  • delete load-balancing reverse-proxy backend <backend> logging facility <facility>

  • show load-balancing reverse-proxy backend <backend> logging facility <facility>

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — внутренние сообщения службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> logging facility <facility> level <level>

Описание:
Задает уровень сообщений указанной категории, которые записываются в журнал для группы серверов.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> logging facility <facility> level <level>

  • delete load-balancing reverse-proxy backend <backend> logging facility <facility> level <level>

  • show load-balancing reverse-proxy backend <backend> logging facility <facility> level

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — внутренние сообщения службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

  • <level> — уровень (level) сообщений. Возможные значения: emerg — аварийные сообщения; alert — срочные сообщения; crit — критические сообщения; err — сообщения об ошибках; warning — предупреждения; notice — сообщения, требующие внимания; info — информационные сообщения; debug — отладочные сообщения; all — все сообщения. Значение по умолчанию: err.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> mode <mode>

Описание:
Задает режим работы прокси-сервера для группы серверов.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> mode <mode>

  • delete load-balancing reverse-proxy backend <backend> mode <mode>

  • show load-balancing reverse-proxy backend <backend> mode

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <mode> — режим работы. Возможные значения: http — режим прокси HTTP; tcp — режим прокси TCP. Значение по умолчанию: http.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> rule <rule>

Описание:
Создает правило обработки запросов для группы серверов. Правило выбирает сервер группы по имени домена или перенаправляет запросы по пути URL.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> rule <rule>

  • delete load-balancing reverse-proxy backend <backend> rule <rule>

  • show load-balancing reverse-proxy backend <backend> rule <rule>

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> rule <rule> domain-name <domain-name>

Описание:
Задает имя домена, с которым сопоставляются запросы.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> rule <rule> domain-name <domain-name>

  • delete load-balancing reverse-proxy backend <backend> rule <rule> domain-name <domain-name>

  • show load-balancing reverse-proxy backend <backend> rule <rule> domain-name

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

  • <domain-name> — имя домена. Формат: строка. Можно задать несколько значений.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> rule <rule> set server <server>

Описание:
Задает сервер группы, на который передаются запросы, соответствующие правилу. Сервер выбирается по имени домена, заданному в правиле (domain-name).

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> rule <rule> set server <server>

  • delete load-balancing reverse-proxy backend <backend> rule <rule> set server <server>

  • show load-balancing reverse-proxy backend <backend> rule <rule> set server

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

  • <server> — имя сервера.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> rule <rule> set redirect-location <redirect-location>

Описание:
Задает адрес URL, на который перенаправляются запросы, соответствующие правилу. Перенаправление выполняется с кодом ответа HTTP 301.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> rule <rule> set redirect-location <redirect-location>

  • delete load-balancing reverse-proxy backend <backend> rule <rule> set redirect-location <redirect-location>

  • show load-balancing reverse-proxy backend <backend> rule <rule> set redirect-location

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

  • <redirect-location> — адрес URL. Формат: URL.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> rule <rule> ssl <ssl>

Описание:
Задает условие сопоставления запросов по SSL.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> rule <rule> ssl <ssl>

  • delete load-balancing reverse-proxy backend <backend> rule <rule> ssl <ssl>

  • show load-balancing reverse-proxy backend <backend> rule <rule> ssl

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

  • <ssl> — условие сопоставления. Возможные значения: req-ssl-sni — совпадение по запросу SNI (Server Name Indication); ssl-fc-sni — совпадение по SNI входящего соединения (frontend); ssl-fc-sni-end — совпадение по окончанию SNI входящего соединения (frontend).

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> rule <rule> url-path begin <begin>

Описание:
Задает начало пути URL, с которым сопоставляются запросы.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> rule <rule> url-path begin <begin>

  • delete load-balancing reverse-proxy backend <backend> rule <rule> url-path begin <begin>

  • show load-balancing reverse-proxy backend <backend> rule <rule> url-path begin

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

  • <begin> — начало пути URL. Формат: URL. Можно задать несколько значений.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> rule <rule> url-path end <end>

Описание:
Задает конец пути URL, с которым сопоставляются запросы.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> rule <rule> url-path end <end>

  • delete load-balancing reverse-proxy backend <backend> rule <rule> url-path end <end>

  • show load-balancing reverse-proxy backend <backend> rule <rule> url-path end

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

  • <end> — конец пути URL. Формат: URL. Можно задать несколько значений.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> rule <rule> url-path exact <exact>

Описание:
Задает полный пути URL, с которым сопоставляются запросы.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> rule <rule> url-path exact <exact>

  • delete load-balancing reverse-proxy backend <backend> rule <rule> url-path exact <exact>

  • show load-balancing reverse-proxy backend <backend> rule <rule> url-path exact

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

  • <exact> — полный пути URL. Формат: URL. Можно задать несколько значений.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> server <server>

Описание:
Добавляет сервер в группу.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> server <server>

  • delete load-balancing reverse-proxy backend <backend> server <server>

  • show load-balancing reverse-proxy backend <backend> server <server>

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <server> — имя сервера.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> server <server> address <address>

Описание:
Задает адрес сервера.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> server <server> address <address>

  • delete load-balancing reverse-proxy backend <backend> server <server> address <address>

  • show load-balancing reverse-proxy backend <backend> server <server> address

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <server> — имя сервера.

  • <address> — IP-адрес сервера. Формат: IPv4-адрес (x.x.x.x) или IPv6-адрес (h:h:h:h:h:h:h:h).

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> server <server> backup

Описание:
Назначает сервер резервным: он используется, если остальные серверы группы недоступны.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> server <server> backup

  • delete load-balancing reverse-proxy backend <backend> server <server> backup

  • show load-balancing reverse-proxy backend <backend> server <server> backup

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <server> — имя сервера.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> server <server> check

Описание:
Включает активную проверку доступности сервера.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> server <server> check

  • delete load-balancing reverse-proxy backend <backend> server <server> check

  • show load-balancing reverse-proxy backend <backend> server <server> check

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <server> — имя сервера.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> server <server> port <port>

Описание:
Задает порт сервера.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> server <server> port <port>

  • delete load-balancing reverse-proxy backend <backend> server <server> port <port>

  • show load-balancing reverse-proxy backend <backend> server <server> port

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <server> — имя сервера.

  • <port> — номер порта. Формат: целое число. Диапазон значений: от 1 до 65535.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> server <server> send-proxy

Описание:
Включает передачу серверу заголовка протокола Proxy версии 1 (текстовый формат).

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> server <server> send-proxy

  • delete load-balancing reverse-proxy backend <backend> server <server> send-proxy

  • show load-balancing reverse-proxy backend <backend> server <server> send-proxy

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <server> — имя сервера.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> server <server> send-proxy-v2

Описание:
Включает передачу серверу заголовка протокола Proxy версии 2 (двоичный формат).

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> server <server> send-proxy-v2

  • delete load-balancing reverse-proxy backend <backend> server <server> send-proxy-v2

  • show load-balancing reverse-proxy backend <backend> server <server> send-proxy-v2

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <server> — имя сервера.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> ssl ca-certificate <ca-certificate>

Описание:
Задает центр сертификации из конфигурации PKI для серверов группы.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> ssl ca-certificate <ca-certificate>

  • delete load-balancing reverse-proxy backend <backend> ssl ca-certificate <ca-certificate>

  • show load-balancing reverse-proxy backend <backend> ssl ca-certificate

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <ca-certificate> — имя центра сертификации в конфигурации PKI. Формат: строка.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> ssl no-verify

Описание:
Отключает проверку сертификатов SSL серверов группы.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> ssl no-verify

  • delete load-balancing reverse-proxy backend <backend> ssl no-verify

  • show load-balancing reverse-proxy backend <backend> ssl no-verify

Аргументы:

  • <backend> — имя группы серверов (backend).

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> timeout check <check>

Описание:
Задает время ожидания ответа сервера на проверку доступности после установления соединения. Если ответ не получен за это время, проверка считается неудачной.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> timeout check <check>

  • delete load-balancing reverse-proxy backend <backend> timeout check <check>

  • show load-balancing reverse-proxy backend <backend> timeout check

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <check> — тайм-аут в секундах. Формат: целое число. Диапазон значений: от 1 до 3600.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> timeout connect <connect>

Описание:
Задает максимальное время ожидания установления соединения с сервером. Если соединение не установлено за это время, попытка подключения повторяется; после неудачных попыток клиент получает ответ HTTP с кодом 503.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> timeout connect <connect>

  • delete load-balancing reverse-proxy backend <backend> timeout connect <connect>

  • show load-balancing reverse-proxy backend <backend> timeout connect

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <connect> — время ожидания в секундах. Формат: целое число. Диапазон значений: от 1 до 3600.

Режим: «Конфигурирование».


load-balancing reverse-proxy backend <backend> timeout server <server>

Описание:
Задает максимальное время неактивности на стороне сервера. Если сервер не отвечает за это время, клиент получает ответ HTTP с кодом 504.

Синтаксис:

  • set load-balancing reverse-proxy backend <backend> timeout server <server>

  • delete load-balancing reverse-proxy backend <backend> timeout server <server>

  • show load-balancing reverse-proxy backend <backend> timeout server

Аргументы:

  • <backend> — имя группы серверов (backend).

  • <server> — время неактивности в секундах. Формат: целое число. Диапазон значений: от 1 до 3600.

Режим: «Конфигурирование».


load-balancing reverse-proxy global-parameters logging facility <facility>

Описание:
Включает журналирование сообщений указанной категории для всех служб обратного прокси-сервера.

Синтаксис:

  • set load-balancing reverse-proxy global-parameters logging facility <facility>

  • delete load-balancing reverse-proxy global-parameters logging facility <facility>

  • show load-balancing reverse-proxy global-parameters logging facility <facility>

Аргументы:

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — внутренние сообщения службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

Режим: «Конфигурирование».


load-balancing reverse-proxy global-parameters logging facility <facility> level <level>

Описание:
Задает уровень сообщений указанной категории, которые записываются в журнал для всех служб обратного прокси-сервера.

Синтаксис:

  • set load-balancing reverse-proxy global-parameters logging facility <facility> level <level>

  • delete load-balancing reverse-proxy global-parameters logging facility <facility> level <level>

  • show load-balancing reverse-proxy global-parameters logging facility <facility> level

Аргументы:

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — внутренние сообщения службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

  • <level> — уровень (level) сообщений. Возможные значения: emerg — аварийные сообщения; alert — срочные сообщения; crit — критические сообщения; err — сообщения об ошибках; warning — предупреждения; notice — сообщения, требующие внимания; info — информационные сообщения; debug — отладочные сообщения; all — все сообщения. Значение по умолчанию: err.

Режим: «Конфигурирование».


load-balancing reverse-proxy global-parameters max-connections <max-connections>

Описание:
Задает максимальное число одновременных соединений.

Синтаксис:

  • set load-balancing reverse-proxy global-parameters max-connections <max-connections>

  • delete load-balancing reverse-proxy global-parameters max-connections <max-connections>

  • show load-balancing reverse-proxy global-parameters max-connections

Аргументы:

  • <max-connections> — максимальное число соединений. Формат: целое число. Диапазон значений: от 1 до 2000000.

Режим: «Конфигурирование».


load-balancing reverse-proxy global-parameters ssl-bind-ciphers <ssl-bind-ciphers>

Описание:
Задает набор шифров (cipher suite), которые используются при согласовании SSL/TLS для всех входящих служб. Набор применяется к соединениям TLS 1.2; клиент, который предлагает только другие шифры, не может установить соединение.

Синтаксис:

  • set load-balancing reverse-proxy global-parameters ssl-bind-ciphers <ssl-bind-ciphers>

  • delete load-balancing reverse-proxy global-parameters ssl-bind-ciphers <ssl-bind-ciphers>

  • show load-balancing reverse-proxy global-parameters ssl-bind-ciphers

Аргументы:

  • <ssl-bind-ciphers> — шифр. Возможные значения: ecdhe-ecdsa-aes128-gcm-sha256, ecdhe-rsa-aes128-gcm-sha256, ecdhe-ecdsa-aes256-gcm-sha384, ecdhe-rsa-aes256-gcm-sha384, ecdhe-ecdsa-chacha20-poly1305, ecdhe-rsa-chacha20-poly1305, dhe-rsa-aes128-gcm-sha256, dhe-rsa-aes256-gcm-sha384. Значение по умолчанию: ecdhe-ecdsa-aes128-gcm-sha256 ecdhe-rsa-aes128-gcm-sha256 ecdhe-ecdsa-aes256-gcm-sha384 ecdhe-rsa-aes256-gcm-sha384 ecdhe-ecdsa-chacha20-poly1305 ecdhe-rsa-chacha20-poly1305 dhe-rsa-aes128-gcm-sha256 dhe-rsa-aes256-gcm-sha384. Можно задать несколько значений.

Режим: «Конфигурирование».


load-balancing reverse-proxy global-parameters tls-version-min <tls-version-min>

Описание:
Задает минимальную требуемую версию TLS.

Синтаксис:

  • set load-balancing reverse-proxy global-parameters tls-version-min <tls-version-min>

  • delete load-balancing reverse-proxy global-parameters tls-version-min <tls-version-min>

  • show load-balancing reverse-proxy global-parameters tls-version-min

Аргументы:

  • <tls-version-min> — минимальная версия TLS. Возможные значения: 1.2 — TLS 1.2; 1.3 — TLS 1.3. Значение по умолчанию: 1.3.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service>

Описание:
Создает входящую службу (frontend) обратного прокси-сервера.

Синтаксис:

  • set load-balancing reverse-proxy service <service>

  • delete load-balancing reverse-proxy service <service>

  • show load-balancing reverse-proxy service <service>

Аргументы:

  • <service> — имя входящей службы (frontend).

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> backend <backend>

Описание:
Задает группу серверов службы по умолчанию.

Синтаксис:

  • set load-balancing reverse-proxy service <service> backend <backend>

  • delete load-balancing reverse-proxy service <service> backend <backend>

  • show load-balancing reverse-proxy service <service> backend

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <backend> — имя группы серверов (backend). Формат: строка. Можно задать несколько значений.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> description <description>

Описание:
Добавляет описание входящей службы.

Синтаксис:

  • set load-balancing reverse-proxy service <service> description <description>

  • delete load-balancing reverse-proxy service <service> description <description>

  • show load-balancing reverse-proxy service <service> description

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <description> — описание службы. Формат: строка.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> http-response-headers <header>

Описание:
Добавляет заголовок HTTP, который включается в ответы службы.

Синтаксис:

  • set load-balancing reverse-proxy service <service> http-response-headers <header>

  • delete load-balancing reverse-proxy service <service> http-response-headers <header>

  • show load-balancing reverse-proxy service <service> http-response-headers <header>

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <header> — имя заголовка HTTP. Формат: строка.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> http-response-headers <header> value <value>

Описание:
Задает значение заголовка HTTP.

Синтаксис:

  • set load-balancing reverse-proxy service <service> http-response-headers <header> value <value>

  • delete load-balancing reverse-proxy service <service> http-response-headers <header> value <value>

  • show load-balancing reverse-proxy service <service> http-response-headers <header> value

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <header> — имя заголовка HTTP. Формат: строка.

  • <value> — значение заголовка HTTP. Формат: строка.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> listen-address <listen-address>

Описание:
Задает локальные IP-адреса, на которых служба принимает входящие соединения.

Синтаксис:

  • set load-balancing reverse-proxy service <service> listen-address <listen-address>

  • delete load-balancing reverse-proxy service <service> listen-address <listen-address>

  • show load-balancing reverse-proxy service <service> listen-address

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <listen-address> — локальный IP-адрес. Формат: IPv4-адрес (x.x.x.x) или IPv6-адрес (h:h:h:h:h:h:h:h). Можно задать несколько значений.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> logging facility <facility>

Описание:
Включает журналирование сообщений указанной категории для входящей службы.

Синтаксис:

  • set load-balancing reverse-proxy service <service> logging facility <facility>

  • delete load-balancing reverse-proxy service <service> logging facility <facility>

  • show load-balancing reverse-proxy service <service> logging facility <facility>

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — внутренние сообщения службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> logging facility <facility> level <level>

Описание:
Задает уровень сообщений указанной категории, которые записываются в журнал для входящей службы.

Синтаксис:

  • set load-balancing reverse-proxy service <service> logging facility <facility> level <level>

  • delete load-balancing reverse-proxy service <service> logging facility <facility> level <level>

  • show load-balancing reverse-proxy service <service> logging facility <facility> level

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <facility> — категория (facility) сообщений. Возможные значения: all — все категории, кроме mark; auth — аутентификация и авторизация; authpriv — несистемная авторизация; cron — служба планирования заданий; daemon — системные службы; kern — ядро; lpr — подсистема печати; mail — почтовая подсистема; mark — метки времени; news — подсистема USENET; syslog — внутренние сообщения службы журналирования; user — прикладные процессы; uucp — подсистема UUCP; local0 — локальная категория 0; local1 — локальная категория 1; local2 — локальная категория 2; local3 — локальная категория 3; local4 — локальная категория 4; local5 — локальная категория 5; local6 — локальная категория 6; local7 — локальная категория 7.

  • <level> — уровень (level) сообщений. Возможные значения: emerg — аварийные сообщения; alert — срочные сообщения; crit — критические сообщения; err — сообщения об ошибках; warning — предупреждения; notice — сообщения, требующие внимания; info — информационные сообщения; debug — отладочные сообщения; all — все сообщения. Значение по умолчанию: err.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> mode <mode>

Описание:
Задает режим работы прокси-сервера для службы.

Синтаксис:

  • set load-balancing reverse-proxy service <service> mode <mode>

  • delete load-balancing reverse-proxy service <service> mode <mode>

  • show load-balancing reverse-proxy service <service> mode

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <mode> — режим работы. Возможные значения: http — режим прокси HTTP; tcp — режим прокси TCP. Значение по умолчанию: http.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> port <port>

Описание:
Задает порт, на котором служба принимает входящие соединения.

Синтаксис:

  • set load-balancing reverse-proxy service <service> port <port>

  • delete load-balancing reverse-proxy service <service> port <port>

  • show load-balancing reverse-proxy service <service> port

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <port> — номер порта. Формат: целое число. Диапазон значений: от 1 до 65535.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> redirect-http-to-https

Описание:
Включает перенаправление запросов HTTP на HTTPS. Служба принимает запросы HTTP на порту 80 своих адресов (listen-address) и перенаправляет их на HTTPS с кодом ответа 301, кроме запросов к пути /.well-known/acme-challenge/.

Синтаксис:

  • set load-balancing reverse-proxy service <service> redirect-http-to-https

  • delete load-balancing reverse-proxy service <service> redirect-http-to-https

  • show load-balancing reverse-proxy service <service> redirect-http-to-https

Аргументы:

  • <service> — имя входящей службы (frontend).

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> rule <rule>

Описание:
Создает правило обработки запросов для входящей службы. Правила применяются в порядке возрастания номеров; порядок обработки описан в разделе «Обзор».

Синтаксис:

  • set load-balancing reverse-proxy service <service> rule <rule>

  • delete load-balancing reverse-proxy service <service> rule <rule>

  • show load-balancing reverse-proxy service <service> rule <rule>

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> rule <rule> domain-name <domain-name>

Описание:
Задает имя домена, с которым сопоставляются запросы.

Синтаксис:

  • set load-balancing reverse-proxy service <service> rule <rule> domain-name <domain-name>

  • delete load-balancing reverse-proxy service <service> rule <rule> domain-name <domain-name>

  • show load-balancing reverse-proxy service <service> rule <rule> domain-name

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

  • <domain-name> — имя домена. Формат: строка. Можно задать несколько значений.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> rule <rule> set backend <backend>

Описание:
Задает группу серверов, на которую передаются запросы, соответствующие правилу.

Синтаксис:

  • set load-balancing reverse-proxy service <service> rule <rule> set backend <backend>

  • delete load-balancing reverse-proxy service <service> rule <rule> set backend <backend>

  • show load-balancing reverse-proxy service <service> rule <rule> set backend

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

  • <backend> — имя группы серверов (backend).

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> rule <rule> set redirect-location <redirect-location>

Описание:
Задает адрес URL, на который перенаправляются запросы, соответствующие правилу. Перенаправление выполняется с кодом ответа HTTP 301.

Синтаксис:

  • set load-balancing reverse-proxy service <service> rule <rule> set redirect-location <redirect-location>

  • delete load-balancing reverse-proxy service <service> rule <rule> set redirect-location <redirect-location>

  • show load-balancing reverse-proxy service <service> rule <rule> set redirect-location

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

  • <redirect-location> — адрес URL. Формат: URL.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> rule <rule> ssl <ssl>

Описание:
Задает условие сопоставления запросов по SSL.

Условие req-ssl-sni используется в службе в режиме tcp, которая передает соединения TLS серверам без расшифровки. Для такой службы задайте tcp-request inspect-delay: без него правило с условием req-ssl-sni не срабатывает. Условие ssl-fc-sni используется в службе, которая принимает соединения TLS с сертификатом (ssl certificate).

Синтаксис:

  • set load-balancing reverse-proxy service <service> rule <rule> ssl <ssl>

  • delete load-balancing reverse-proxy service <service> rule <rule> ssl <ssl>

  • show load-balancing reverse-proxy service <service> rule <rule> ssl

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

  • <ssl> — условие сопоставления. Возможные значения: req-ssl-sni — совпадение по запросу SNI (Server Name Indication); ssl-fc-sni — совпадение по SNI входящего соединения (frontend); ssl-fc-sni-end — совпадение по окончанию SNI входящего соединения (frontend).

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> rule <rule> url-path begin <begin>

Описание:
Задает начало пути URL, с которым сопоставляются запросы.

Синтаксис:

  • set load-balancing reverse-proxy service <service> rule <rule> url-path begin <begin>

  • delete load-balancing reverse-proxy service <service> rule <rule> url-path begin <begin>

  • show load-balancing reverse-proxy service <service> rule <rule> url-path begin

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

  • <begin> — начало пути URL. Формат: URL. Можно задать несколько значений.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> rule <rule> url-path end <end>

Описание:
Задает конец пути URL, с которым сопоставляются запросы.

Синтаксис:

  • set load-balancing reverse-proxy service <service> rule <rule> url-path end <end>

  • delete load-balancing reverse-proxy service <service> rule <rule> url-path end <end>

  • show load-balancing reverse-proxy service <service> rule <rule> url-path end

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

  • <end> — конец пути URL. Формат: URL. Можно задать несколько значений.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> rule <rule> url-path exact <exact>

Описание:
Задает полный пути URL, с которым сопоставляются запросы.

Синтаксис:

  • set load-balancing reverse-proxy service <service> rule <rule> url-path exact <exact>

  • delete load-balancing reverse-proxy service <service> rule <rule> url-path exact <exact>

  • show load-balancing reverse-proxy service <service> rule <rule> url-path exact

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <rule> — номер правила. Формат: целое число. Диапазон значений: от 1 до 10000.

  • <exact> — полный пути URL. Формат: URL. Можно задать несколько значений.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> ssl certificate <certificate>

Описание:
Задает сертификат из конфигурации PKI.

Синтаксис:

  • set load-balancing reverse-proxy service <service> ssl certificate <certificate>

  • delete load-balancing reverse-proxy service <service> ssl certificate <certificate>

  • show load-balancing reverse-proxy service <service> ssl certificate

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <certificate> — имя сертификата в конфигурации PKI. Формат: строка. Можно задать несколько значений.

Режим: «Конфигурирование».


load-balancing reverse-proxy service <service> tcp-request inspect-delay <inspect-delay>

Описание:
Задает максимальное время ожидания данных при анализе содержимого. Параметр нужен правилам с условием ssl req-ssl-sni: служба ожидает начало согласования TLS в течение заданного времени, чтобы прочитать имя сервера (SNI).

Синтаксис:

  • set load-balancing reverse-proxy service <service> tcp-request inspect-delay <inspect-delay>

  • delete load-balancing reverse-proxy service <service> tcp-request inspect-delay <inspect-delay>

  • show load-balancing reverse-proxy service <service> tcp-request inspect-delay

Аргументы:

  • <service> — имя входящей службы (frontend).

  • <inspect-delay> — время ожидания в миллисекундах. Формат: целое число. Диапазон значений: от 1 до 65535.

Режим: «Конфигурирование».


load-balancing reverse-proxy vrf <vrf>

Описание:
Задает экземпляр VRF, в котором работает обратный прокси-сервер.

Синтаксис:

  • set load-balancing reverse-proxy vrf <vrf>

  • delete load-balancing reverse-proxy vrf <vrf>

  • show load-balancing reverse-proxy vrf

Аргументы:

  • <vrf> — имя экземпляра VRF. Формат: строка.

Режим: «Конфигурирование».


Режим «Администрирование»


reverse-proxy

Описание:
Показывает состояние обратного прокси-сервера: входящие службы, группы серверов и серверы, их состояние, частоту запросов, время ответа и время последнего изменения состояния.

Синтаксис:

  • show reverse-proxy

Режим: «Администрирование».


restart reverse-proxy

Описание:
Перезапускает службу обратного прокси. Если служба не настроена (раздел load-balancing reverse-proxy), команда ничего не перезапускает и выводит сообщение Reverse-Proxy not configured.

Синтаксис:

  • restart reverse-proxy

Режим: «Администрирование».

Уровень привилегий: «Администратор».