From: Eric Covener <covener@apache.org>
Date: Sun, 9 Aug 2020 19:11:11 +0000 (+0000)
Subject: add 2.4 examples of mixed http/ws
X-Git-Tag: 2.4.47~298
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=be4aa6149b39a54014c811462ae9b6d92d54e5bf;p=thirdparty%2Fapache%2Fhttpd.git

add 2.4 examples of mixed http/ws



git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1880722 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/mod_proxy_wstunnel.xml b/docs/manual/mod/mod_proxy_wstunnel.xml
index 4d46e5bf8b7..e36eb328904 100644
--- a/docs/manual/mod/mod_proxy_wstunnel.xml
+++ b/docs/manual/mod/mod_proxy_wstunnel.xml
@@ -50,6 +50,28 @@ ProxyPass "/ws2/"  "ws://echo.websocket.org/"
 ProxyPass "/wss2/" "wss://echo.websocket.org/"
     </highlight>
 
+    <p>Proxying both HTTP and websockets at the same time, with a specific set of URL's being
+websocket-only, can be done by specifying the websockets 
+<directive type="ProxyPass" module="mod_proxy">ProxyPass</directive> directive before the
+HTTP directive:</p>
+<highlight language="config">
+ProxyPassMatch ^/(myApp/ws)$  ws://example.com:9080/$1
+ProxyPass / http://example.com:9080/
+</highlight>
+
+<p>Proxying both HTTP and websockets at the same time, where the websockets URL's are not
+websocket-only or not known in advance can be done by using the
+<directive type="RewriteRule" module="mod_rewrite">RewriteRule</directive> directive to
+configure the websockets proxying:</p>
+<highlight language="config">
+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]
+</highlight>
+
+
 <p>Load balancing for multiple backends can be achieved using <module>mod_proxy_balancer</module>.</p>
 
 <p>In fact the module can be used to upgrade to other protocols, you can set the <code>upgrade</code>