How to use Nginx to implement WebSocket protocol support

How to use Nginx to implement WebSocket protocol support

The WebSocket protocol is a protocol that implements two-way communication in Web applications. It allows the server to actively send data to the client without the client first initiating a request. . Compared with the traditional HTTP protocol, the WebSocket protocol has lower latency and higher efficiency, and is suitable for application scenarios with high real-time requirements. This article will introduce how to use Nginx as a reverse proxy to support the WebSocket protocol.

Nginx is a high-performance open source reverse proxy server that can be used in load balancing, reverse proxy, static file caching and other scenarios. Nginx also provides some modules and directives to support the WebSocket protocol. The following is a simple configuration example:

http { # 其他的http配置 map $http_upgrade $connection_upgrade { default upgrade; '' close; } server { listen 80; location /ws/ { proxy_pass http://backend; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection $connection_upgrade; } } }

In the above configuration, we define a/ws/path for processing WebSocket connection requests. WebSocket requests will be proxied to thehttp://backendaddress. Theproxy_passdirective is used to set the proxy's backend server address, and theproxy_http_versiondirective is used to set the proxy's HTTP protocol version. Theproxy_set_headerdirective is used to set request header information, of whichUpgradeandConnectionare required and are used to inform the server to perform protocol upgrades.

It should be noted that themapdirective in the above configuration is used to map theUpgradefield in the client request header to$http_upgradevariable and dynamically set the$connection_upgradevariable based on its value. This allows you to set the value of theUpgradefield to the value of the$connection_upgradefield when theUpgradefield is found in the request. Otherwise, the connection will be closed.

After the configuration is completed, we only need to start Nginx:

sudo service nginx start

Now, we have completed the configuration of using Nginx as a reverse proxy to support the WebSocket protocol. We can use the following code snippet to test the WebSocket connection:

var socket = new WebSocket("ws://yourdomain.com/ws/"); socket.onopen = function () { console.log("Connection established."); }; socket.onmessage = function (event) { console.log("Received message: ", event.data); }; socket.onclose = function () { console.log("Connection closed."); };

Replacews://yourdomain.com/ws/with the actual WebSocket address and open the browser's developer tool to view console output. If you can connect normally and receive messages, it means that the WebSocket protocol has been successfully supported by Nginx.

In summary, through the above configuration and code examples, we can easily use Nginx to support the WebSocket protocol, thereby achieving two-way communication with high real-time requirements.

The above is the detailed content of How to use Nginx to implement WebSocket protocol support. For more information, please follow other related articles on the PHP Chinese website!