详解nginx websocket配置

时间:2022-06-29 12:00:08

一·什么是websocket

WebSocket协议相比较于HTTP协议成功握手后可以多次进行通讯,直到连接被关闭。但是WebSocket中的握手和HTTP中的握手兼容,它使用HTTP中的Upgrade协议头将连接从HTTP升级到WebSocket。这使得WebSocket程序可以更容易的使用现已存在的基础设施。

WebSocket工作在HTTP的80和443端口并使用前缀ws://或者wss://进行协议标注,在建立连接时使用HTTP/1.1的101状态码进行协议切换,当前标准不支持两个客户端之间不借助HTTP直接建立Websocket连接。

二.创建基于Node的WebSocket服务

安装node.js和npm

?
1
$ yum install nodejs npm

安装ws和wscat模块

ws是nodejs的WebSocket实现,我们借助它来搭建简单的WebSocket Echo Server。

wscat是一个可执行的WebSocket客户端,用来调试WebSocket服务是否正常。

?
1
npm install ws wscat

创建一个简单的服务端

?
1
2
3
4
5
6
7
8
9
10
11
$ vim server.js
console.log("Server started");
var Msg = '';
var WebSocketServer = require('ws').Server
  , wss = new WebSocketServer({port: 8010});
  wss.on('connection', function(ws) {
    ws.on('message', function(message) {
    console.log('Received from client: %s', message);
    ws.send('Server received from client: ' + message);
  });
 });

运行服务端

?
1
2
$ node server.js
 Server started

验证服务端是否正常启动

?
1
2
$ netstat -tlunp|grep 8010
tcp6    0   0 :::8010         :::*          LISTEN   23864/nodejs

使用wscat做为客户端测试

wscat命令默认安装当前用户目录node_modules/wscat/目录,我这里的位置是/root/node_modules/wscat/bin/wscat

输入任意内容进行测试,得到相同返回则说明运行正常。

?
1
2
3
4
5
6
7
$ cd /root/node_modules/wscat/bin/
$ ./wscat --connect ws://127.0.0.1:8010
connected (press CTRL+C to quit)
> Hello
< Server received from client: Hello
> Welcome to www.hi-linux.com
< Server received from client: Welcome to www.hi-linux.com

三.使用Nginx对WebSocket进行反向代理

安装Nginx

?
1
yum -y install nginx

配置Nginx Websocket

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
$ vim /usr/local/nginx/conf/nginx.conf
# 在http上下文中增加如下配置,确保Nginx能处理正常http请求。
http{
 map $http_upgrade $connection_upgrade {
  default upgrade;
  ''   close;
 }
 upstream websocket {
  #ip_hash;
  server localhost:8010;
  server localhost:8011;
 }
# 以下配置是在server上下文中添加,location指用于websocket连接的path。
 server {
  listen    80;
  server_name localhost;
  access_log /var/log/nginx/yourdomain.log;
  location / {
   proxy_pass http://websocket;
   proxy_read_timeout 300s;
   proxy_set_header Host $host;
   proxy_set_header X-Real-IP $remote_addr;
   proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   proxy_http_version 1.1;
   proxy_set_header Upgrade $http_upgrade;
   proxy_set_header Connection $connection_upgrade;
}
}
}

最重要的就是在反向代理的配置中增加了如下两行,其它的部分和普通的HTTP反向代理没有任何差别。

?
1
2
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;

这里面的关键部分在于HTTP的请求中多了如下头部:

?
1
2
Upgrade: websocket
Connection: Upgrade

这两个字段表示请求服务器升级协议为WebSocket。服务器处理完请求后,响应如下报文# 状态码为101 

?
1
2
3
HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: upgrade

告诉客户端已成功切换协议,升级为Websocket协议。握手成功之后,服务器端和客户端便角色对等,就像普通的Socket一样,能够双向通信。不再进行HTTP的交互,而是开始WebSocket的数据帧协议实现数据交换。

这里使用map指令可以将变量组合成为新的变量,会根据客户端传来的连接中是否带有Upgrade头来决定是否给源站传递Connection头,这样做的方法比直接全部传递upgrade更加优雅。

默认情况下,连接将会在无数据传输60秒后关闭,proxy_read_timeout参数可以延长这个时间或者源站通过定期发送ping帧以保持连接并确认连接是否还在使用。

启动nginx

?
1
/etc/init.d/nginx start

试通过Nginx访问WebSocket服务

?
1
2
3
4
5
6
7
$ cd /root/node_modules/wscat/bin/
$ ./wscat --connect ws://192.168.2.210
connected (press CTRL+C to quit)
> Hello Nginx
< Server received from client: Hello Nginx
> Welcome to www.hi-linux.com
< Server received from client: Welcome to www.hi-linux.com

测试成功,ok

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。

原文链接:http://blog.51cto.com/8341475/2156997