nicokaiser / nginx-websocket-proxy

nginx WebSocket Proxy

nginx WebSocket Proxy

As of version 1.4, nginx is capable of forwarding WebSocket requests, so it can be used as a reverse proxy for HTTP, HTTPS, WS and WSS.

Here are some simple example configuration snippets for WebSocket forwarding in nginx.

Requirements

• nginx 1.4.x or higher
• WebSocket and HTTP server running on ws|http://localhost:8080

This is a typical scenario given by Engine.IO, Socket.IO, Primus, etc. which provide a WebSocket server with HTTP fallback.

Example Configs

• Simple WebSocket Proxy – forwards WS and HTTP requests to ws|http://localhost:8080
• WebSocketSecure Proxy – forwards WSS and HTTPS requests to ws|http://localhost:8080
• WebSocket Proxy with Path Rewriting – forwards wss|https://ws.example.com/services/myservice to ws|http://localhost:8080
• WebSocket Proxy with Load Balancing – like previous example, but with three backend servers, with one client always being forwarded to the same backend

See Also

• http://nginx.org/en/docs/http/websocket.html
• Nginx Server Configs – Great resource for nginx server config documentation

Author

Nico Kaiser

• http://twitter.com/nicokaiser
• http://kaiser.me
• http://github/nicokaiser

License

MIT License

nginx-websocket-proxy's Issues

Websocket connection disconnects after 4 minutes.

Hi,

I configured nginx-websocket-proxy from link below:

LInk: https://github.com/nicokaiser/nginx-websocket-proxy/blob/df67cd92f71bfcb513b343beaa89cb33ab09fb05/simple-wss.conf

However, i am facing timeout issue.

Please suggest me the solution for this problem.

Websocket SSL Termination

Hi,

I'm using nginx with node.js to offload SSL termination to nginx as node performs poorly at this. I now want to add SSL termination offloading for websockets. Does your wss config make nginx act as an SSL termination proxy? Does it pass the websocket data on to the upstream server over ws, not wss?

Thanks!

nginx 1.15.6

Hi
Please help me with the settings provided by you. All IPs 127.0.0.1 are returned ?