Базовый HTTP-прокси

class werkzeug.middleware.http_proxy.ProxyMiddleware(app, targets, chunk_size=16384, timeout=10)

Перенаправляет запросы под путём к внешнему серверу, перенаправляя другие запросы к приложению.

Этот миддлвар может только перенаправлять HTTP-запросы, так как HTTP — единственный протокол, обрабатываемый сервером WSGI. Другие протоколы, такие как запросы WebSocket, не могут быть перенаправлены на этом уровне. Это следует использовать только для разработки, в производстве должен использоваться реальный сервер прокси.

Миддлвар принимает словарь, сопоставляющий префикс пути с словарем, описывающим хост, к которому будет осуществляться перенаправление:

app = ProxyMiddleware(app, {
    "/static/": {
        "target": "http://127.0.0.1:5001/",
    }
})

Каждый хост имеет следующие параметры:

target:

Целевой URL для перенаправления. Это необходимо.

remove_prefix:

Удалить ли префикс из URL перед отправкой его целевому серверу. По умолчанию False.

host:

"<auto>" (default):

Заголовок хоста автоматически переписывается на URL целевого сервера.

None:

Заголовок хоста не изменяется с запроса клиента.

Любое другое значение:

Заголовок хоста перезаписывается указанным значением.

headers:

Словарь заголовков, которые будут отправлены с запросом целевому серверу. По умолчанию {}.

ssl_context:

ssl.SSLContext, определяющий, как проверять запросы, если целевой сервер использует HTTPS. По умолчанию None.

В приведённом примере всё под "/static/" перенаправляется на сервер на порту 5001. Заголовок хоста переписывается на целевой URL, и префикс "/static/" удаляется из URL.

Parameters:

• app (WSGIApplication) – Обёртка WSGI-приложения.
• targets (t.Mapping[str, dict[str, t.Any]]) – Конфигурации целевых серверов прокси. См. описание выше.
• chunk_size (int) – Размер блоков для чтения из входного потока и записи в целевой сервер.
• timeout (int) – Время в секундах, по истечении которого операция с целевым сервером завершается с ошибкой.

Changelog

Добавлена в версии 0.14.