Apache HTTP Server Version 2.5
Available Languages: en
Description: | Websockets support module for
mod_proxy |
---|---|
Status: | Extension |
Module Identifier: | proxy_wstunnel_module |
Source File: | mod_proxy_wstunnel.c |
Compatibility: | Available in httpd 2.4.5 and later |
This module requires the service of mod_proxy
. It provides support for the tunnelling of web
socket connections to a backend websockets server. The connection
is automatically upgraded to a websocket connection:
Upgrade: WebSocket Connection: Upgrade
Proxying requests to a websockets server like echo.websocket.org
can be done using the
ProxyPass
directive:
ProxyPass "/ws2/" "ws://echo.websocket.org/" ProxyPass "/wss2/" "wss://echo.websocket.org/"
Load balancing for multiple backends can be achieved using mod_proxy_balancer
.
Description: | Instructs this module to try to create an asynchronous tunnel |
---|---|
Syntax: | ProxyWebsocketAsync ON|OFF |
Context: | server config, virtual host |
Status: | Extension |
Module: | mod_proxy_wstunnel |
This directive instructs the server to try to create an asynchronous tunnel. If the current MPM does not support the necessary features, a synchronous tunnel is used.
Async support is experimental and subject to change.
Description: | Sets the amount of time the tunnel waits synchronously for data |
---|---|
Syntax: | ProxyWebsocketAsyncDelay num[ms] |
Default: | ProxyWebsocketAsyncDelay 0 |
Context: | server config, virtual host |
Status: | Extension |
Module: | mod_proxy_wstunnel |
If ProxyWebsocketAsync
is enabled, this directive
controls how long the server synchronously waits for more data.
Async support is experimental and subject to change.
Description: | Sets the maximum amount of time to wait for data on the websockets tunnel |
---|---|
Syntax: | ProxyWebsocketIdleTimeout num[ms] |
Default: | ProxyWebsocketIdleTimeout 0 |
Context: | server config, virtual host |
Status: | Extension |
Module: | mod_proxy_wstunnel |
This directive imposes a maximum amount of time for the tunnel to be left open while idle.
Available Languages: en