Модуль Apache mod_proxy_wstunnel

Сводка

Для работы этого модуля требуется mod_proxy. Он обеспечивает туннелирование соединений веб-сокетов к серверу веб-сокетов в бэкенде. Соединение автоматически переключается на соединение веб-сокета:

Upgrade: WebSocket
Connection: Upgrade

Проксирование запросов к серверу веб-сокетов, например echo.websocket.org, можно настроить с помощью директивы ProxyPass:

ProxyPass "/ws2/"  "ws://echo.websocket.org/"
ProxyPass "/wss2/" "wss://echo.websocket.org/"

Одновременное проксирование HTTP и веб-сокетов, когда определённый набор URL предназначен только для веб-сокетов, можно настроить, указав директиву ProxyPass для веб-сокетов перед директивой HTTP:

ProxyPassMatch ^/(myApp/ws)$  ws://backend.example.com:9080/$1
ProxyPass / http://backend.example.com:9080/

Одновременное проксирование HTTP и веб-сокетов, когда URL веб-сокетов не предназначены исключительно для веб-сокетов или заранее неизвестны, можно настроить с помощью директивы RewriteRule:

ProxyPass / http://example.com:9080/
RewriteEngine on
RewriteCond %{HTTP:Upgrade} websocket [NC]
RewriteCond %{HTTP:Connection} upgrade [NC]
RewriteRule ^/?(.*) "ws://example.com:9080/$1" [P,L]

Балансировку нагрузки между несколькими бэкендами можно настроить с помощью mod_proxy_balancer.

Модуль также можно использовать для переключения на протоколы, отличные от WebSocket, задав параметру обновление протокола в директиве ProxyPass имя пользовательского протокола. Специальные значения upgrade=NONE и upgrade=ANY можно использовать для тестирования или принудительного переключения протокола, но по соображениям безопасности их не рекомендуется использовать в рабочей среде. NONE означает, что проверка заголовка пропускается, но переключение на WebSocket и туннелирование всё равно всегда выполняются. ANY означает, что переключение протокола и туннелирование будут выполняться с использованием любого протокола, запрошенного клиентом.

ProxyWebsocketFallbackToProxyHttp On|Off

ProxyWebsocketFallbackToProxyHttp On