Настройки Web

На этой странице описан блок web: виртуальные хосты, обработка путей (/:, /api, /static), reverse-proxy/балансировка, отдача статики и health-check для upstream.

---

Что такое web

web — это конфигурация HTTP(S) обслуживания: виртуальный хост (домен + TLS/ALPN) и правила маршрутизации по путям.

Virtual Host (domain)

Домен хоста, версия HTTP (ALPN) и сертификаты (certs).

Пути (routing)

Правила для префиксов: /: [...], /api: [...], /static: [...].

Upstream + health-check

Reverse-proxy/балансировка и контроль доступности backend’ов.

Пример (смешанный)

localhost: [
    http_version: "http3"
    certs: certs

    /: [
        balance: [
            ["https://backend1.example.com" 1]
            ["https://backend2.example.com" 1]
        ]
        check: [
            check_type: "http"
            target: "/health"
            interval: 5
            max_fails: 3
        ]
    ]
]

---

Основные поля Virtual Host

• domain — домен виртуального хоста (в примере — localhost)
• certs — переменная сертификатов из config.mgc (например, certs)
• http_version — версии HTTP, которые хост объявляет через ALPN

http_version

http1

HTTP/1.1 (ALPN: http/1.1)

http2

HTTP/1.1 + HTTP/2 (ALPN: http/1.1 + h2)

http3

HTTP/1.1 + HTTP/2 + HTTP/3 (ALPN: http/1.1 + h2 + h3)

Если клиенты/балансировщики не поддерживают HTTP/3, начните с http2. http3 включайте после проверки совместимости.

---

Обработка путей

Путь задаётся как ключ (префикс), например /: [...], /api: [...], /static: [...].
Внутри — правило обработки: reverse-proxy, балансировка или отдача файлов.

Reverse proxy (один upstream)

/: [
    reverse_proxy: "https://backend1.example.com"
]

Балансировка (несколько upstream)

/: [
    balance: [
        ["https://backend1.example.com" 1]
        ["https://backend2.example.com" 1]
    ]
]

Отдача статики

/: [
    serve_in: "/etc/meshgate/default/"
]

---

Health-check

Health-check позволяет автоматически исключать упавшие upstream’ы.

check: [
    check_type: "http"
    target: "/health"
    interval: 5
    max_fails: 3
]

Поля health-check

Поле	Тип	Описание	Пример
check_type	string	Протокол проверки: http или tcp	”http”
target	string	HTTP endpoint для проверки (для tcp обычно не указывается)	“/health”
interval	number	Интервал проверок (секунды)	5
max_fails	number	Ошибок подряд до статуса fail	3

Осторожно

Для tcp-проверок не задавайте target. Для http убедитесь, что endpoint возвращает быстрый и стабильный ответ.