本文是Writing WebSocket servers的中文文档,翻译自MDNWriting WebSocket servers。篇幅略长,我的能力有限不免有所错误,抛砖引玉共同进步。node
WebSocket 服务器简单来讲就是一个遵循特殊协议监听服务器任意端口的tcp应用。搭建一个定制服务器的任务一般会让让人们感到惧怕。然而基于实现一个简单的Websocket服务器没有那么麻烦。 git
一个WebSocket server可使用任意的服务端编程语言来实现,只要该语言能实现基本的Berkeley sockets(伯克利套接字)。例如c(++)、Python、PHP、服务端JavaScript(node.js)。下面不是关于特定语言的教程,而是一个促进咱们搭建本身服务器的指南。 github
咱们须要明白http如何工做而且有中等编程经验。基于特定语言的支持,了解TCP sockets 一样也是必要的。该篇教程的范围是介绍开发一个WebSocket server须要的最少知识。 web
该文章将会从很底层的观点来解释一个 WebSocket server。WebSocket servers 一般是独立的专门的servers(由于负载均衡和其余一些缘由),所以一般使用一个反向代理(例如一个标准的HTTP server)来发现 WebSocket握手协议,预处理他们而后将客户端信息发送给真正的WebSocket server。这意味着WebSocket server没必要充斥这cookie和签名的处理方法。彻底能够放在代理中处理。 编程
首先,服务器必须使用标准的TCPsocket来监听即将到来的socket链接。基于咱们的平台,这些极可能被咱们处理了(成熟的服务端语言提供了这些接口,使咱们没必要从头作起)。例如,假设咱们的服务器监听example.com的8000端口,socket server响应/chat的GET请求。 json
警告:服务器能够选择监放任意端口,可是若是在80或443以外,可能会遇到防火墙或者代理的问题。443端口大多数状况下是能够的,固然须要一个安全链接(TLS/SSL)。此外,注意这一点,大多数浏览器不容许从安全的页面链接到不安全的Websocket服务器。
在WebSockets中握手是web,是HTTP想WS转化的桥梁。经过握手,链接的详情会被判断,而且在完成以前每个部分均可以终端若是条件不知足。服务器必须谨慎解析客户端请求的全部信息,不然安全问题将会发生。 浏览器
尽管咱们在开发一个服务器,客户端仍然须要发起一个Websocket握手过程。所以咱们必须知道如何解析客户端的请求。客户端将会发送一个标准的HTTP请求,大概像下面的例子(HTTP版本必须1.1及以上,请求方式为GET)。 安全
GET /chat HTTP/1.1
Host: example.com:8000
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==
Sec-WebSocket-Version: 13复制代码
此处客户端能够发起扩展或者子协议,在Miscellaneous查看更多细节。一样,公共的headers像User-Agent, Referer, Cookie, or authentication等一样能够包括,一句话作你想作的。这些并不直接和WebSocket相关,忽略掉他们也是安全的,在不少公共的设置中,会有一个代理服务器来处理这些信息。 bash
若是有的header不被识别或者有非法值,服务器应该发送'400 Bad Request'并马上关闭socket,一般也会在HTTP返回体中给出握手失败的缘由,不过这些信息可能不会被展现(由于浏览器不会展现他们)。若是服务器不识别WebSockets的版本,应该返回一个Sec-WebSocket-Version 消息头,指明能够接受的版本(最好是V13,及最新)。下面一块儿看一下最神秘的消息头Sec-WebSocket-Key。 服务器
当服务器接受到请求时,应该发送一个至关奇怪的响应,看起来大概这个样子,不过仍然遵循HTTP规范。 请注意每个header以\r\n结尾而且在最后一个后面加入额外的\r\n。
HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=复制代码
此外,服务器能够在这里决定扩展或者子协议请求。更多详情请查看Miscellaneous。Sec-WebSocket-Accept 部分颇有趣,服务器必须基于客户端请求的Sec-WebSocket-Key 中获得它,具体作法以下:将Sec-WebSocket-Key 和"258EAFA5-E914-47DA-95CA-C5AB0DC85B11"连接,经过SHA-1 hash得到结果,而后返回该结果的base64编码。
###提示
由于这个看似复杂的过程存在,因此客户端不用关心服务器是否支持websocket。另外,该过程的重要性仍是在于安全性,若是一个服务器将一个Websocket链接做为http请求解析的话,将会有不小的问题。
所以,若是key是"dGhlIHNhbXBsZSBub25jZQ==",Accept将会是"s3pPLMBiTxaQ9kYGzzhZRbK+xOo=",一旦服务器发送这些消息头,握手协议就完成了。
服务器在回复握手以前,能够发送其余的header像Set-Cookie、要求签名、重定向等。
虽然并不直接与Websocket协议相关,但值得咱们注意。服务器将会跟踪客户端的sockets,所以咱们没必要和已经完成握手协议的客户端再次进行握手。相同客户端的IP地址能够尝试屡次链接(可是服务器能够选择拒绝,若是他们尝试屡次链接以达到保存本身Denial-of-Service 踪影的目的)
客户端和服务器均可以在任意时间发送消息、这正是websocket的魔力所在。然而从数据帧中提取信息的过程就不那么充满魔力了。尽管全部的帧遵循相同的特定格式,从客户端发到服务器的数据经过X异或加密 (使用32位的密钥)进行处理,该规范的第五章详细描述了相关内容。
每一个从客户端发送到服务器的数据帧遵循下面的格式:
帧格式:
0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-------+-+-------------+-------------------------------+
|F|R|R|R| opcode|M| Payload len | Extended payload length |
|I|S|S|S| (4) |A| (7) | (16/64) |
|N|V|V|V| |S| | (if payload len==126/127) |
| |1|2|3| |K| | |
+-+-+-+-+-------+-+-------------+ - - - - - - - - - - - - - - - +
| Extended payload length continued, if payload len == 127 |
+ - - - - - - - - - - - - - - - +-------------------------------+
| |Masking-key, if MASK set to 1 |
+-------------------------------+-------------------------------+
| Masking-key (continued) | Payload Data |
+-------------------------------- - - - - - - - - - - - - - - - +
: Payload Data continued ... :
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +
| Payload Data continued ... |
+---------------------------------------------------------------+复制代码
MASK (掩码:一串二进制代码对目标字段进行位与运算,屏蔽当前的输入位。)位只代表信息是否已进行掩码处理。来自客户端的消息必须通过处理,所以咱们应该将其置为1(事实上5.1节代表,若是客户端发送未掩码处理的消息,服务器必须断开链接)当发送一个帧至客户端时,不要处理数据而且不设置mask位。下面将会阐述缘由。注意:咱们必须处理消息即便用一个安全的socket。RSV1-3能够被忽略,这是待扩展位。
opcode字段定义如何解析有效的数据:
FIN 代表是不是数据集合的最后一段消息,若是为0,服务器继续监听消息,以待消息剩余的部分。不然服务器认为消息已经彻底发送。
为了解析有效编码数据,咱们必须知道什么时候结束。这是知道有效数据长度的重要所在。不幸的是,有一些复杂。让咱们分步骤来看。
若是MASK位被设置(固然它应该被设置,对于一个从客户端到服务器的消息),读取后4字节(即32位),即加密的key。一旦数据长度和加密key被解码,咱们能够直接从socket中读取成批的字节。获取编码的数据和掩码key,将其解码,循环遍历加密的字节(octets,text数据的单位)而且将其与第(i%4)位掩码字节(即i除以4取余)进行异或运算,若是用js就以下所示(该规则就是加密解密的规则而已,不必深究,你们知道如何使用就好)。
var DECODED = "";
for (var i = 0; i < ENCODED.length; i++) {
DECODED[i] = ENCODED[i] ^ MASK[i % 4];
}复制代码
如今咱们能够知道咱们应用上解码以后的数据具体含义了。
FIN和opcode字段共同工做来说一个消息分解为单独的帧,该过程叫作消息分割,只有在opcodes为0x0-0x2时才可用(前面也提到,当前版本其余数值无心义)。
回想一下,opcode指明了一个帧的将要作什么,若是是0x1,数据是text。若是是0x2,诗句是二进制数据。然而当其为0x0时,该帧是一个继续帧,表示服务器应该将该帧的有效数据和服务器收到的最后一帧连接起来。这是一个草图,指明了当客户端发送text消息时,第一个消息在一个单独的帧里发送,然而第二个消息却包括三个帧,服务器如何反应。FIN和opcode细节仅仅对客户端展现。看一下下面的例子应该会更容易理解。
Client: FIN=1, opcode=0x1, msg="hello"
Server: (消息传输过程完成) Hi.
Client: FIN=0, opcode=0x1, msg="and a"
Server: (监听,新的消息包含开始的文本)
Client: FIN=0, opcode=0x0, msg="happy new"
Server: (监听,有效数据与上面的消息拼接)
Client: FIN=1, opcode=0x0, msg="year!"
Server: (消息传输完成) Happy new year to you too!复制代码
注意:第一帧包括一个彻底的消息(FIN=1而且opcode!=0x0),所以当服务器发现结束时能够返回。第二帧有效数据为text(opcode=0x1),可是完整的消息没有到达(FIN=0)。该消息全部剩下的部分经过继续帧发送(opcode=0x0),而且最后以帧经过FIN=1代表身份。
在握手接受以后的任意点,不管是客户端仍是服务器均可以选择发送ping给另外一部分。当ping被接收时,接收方必须尽量的返回一个pong。咱们能够用该方式来确保链接依然有效。
一个ping或者pong只是一个规则的帧,可是是控制帧,Pings的opcode为0x9,pong是0xA。当咱们获得ping时,返回具备彻底相同有效数据的pong。(对ping和pong而言,最大有效数据长度是125)咱们可能在没有发送ping的状况下,获得一个pong。这种状况请忽略。
在发送pong以前,若是咱们接收到不止一个ping,只需回应一个pong便可。
要关闭客户端和服务器之间的链接,咱们能够发送一个包含特定控制队列的数据的控制帧来开始关闭的握手协议。当接收到该帧时,另外一方发送一个关闭帧做为回应。而后前者会关闭链接。关闭链接以后接收到的数据都会被丢弃。
WebSocket 扩展和子协议在握手过程当中经过headers进行约定。有时扩展和子协议太近似了以至于难以分别。最基本的区别是,扩展控制websocket 帧而且修改有效数据。然而子协议构成websocket有效数据而且从不修改任何事物。扩展是可选的广义的,子协议是必须的局限性的。
将扩展看做压缩一个文件在发送以前,不管你如何作,你将发送相同的数据只不过帧不一样而已。收件人最终将会受到与你本地拷贝相同的数据,不过以不一样方式发送。这就是扩展作的事情。websockets定义了一个协议和基本的方式去发送数据,然而扩展例如压缩能够以更短的帧来阿松相同的数据。
将子协议看做定作的xml表或者文档类型说明。你在使用XML和它的语法,可是你被限制于你赞成的结构。WebSocket子协议就是如此。他们不介绍其余一些华丽的东西,仅仅创建结构,像一个文档类型和表同样,两个部分(client & server)都赞成该协议,和文档类型和表不一样,子协议由服务器实现而且客户端不能对外引用。
一个客户端必须请求特定的子协议,为了达到目的,将会发送一些像下面的内容做为原始握手的一部分。
GET /chat HTTP/1.1
...
Sec-WebSocket-Protocol: soap, wamp复制代码
或者等价的写法
...
Sec-WebSocket-Protocol: soap
Sec-WebSocket-Protocol: wamp复制代码
如今,服务器必须选择客户端建议而且支持的一种协议。若是多余一个,发送客户端发送过来的第一个。想象咱们的服务器可使用soap和wamp中的一个,而后,返回的握手中将会发送以下形式。
Sec-WebSocket-Protocol: soap复制代码
服务器不能发送超过一个的Sec-Websocket-Protocol消息头,若是服务器不想使用任一个子协议,应该不发送Sec-WebSocket-Protocol 消息头。发送一个空白的消息头是错误的。客户端可能会关闭链接若是不能得到指望的子协议。
若是咱们但愿咱们的服务器遵照必定的子协议,天然地在咱们的服务器须要额外的代码。想象咱们使用一个子协议json,基于该子协议,全部的数据将会做为JSON传递,若是一个客户端征求子协议而且服务器想使用它,服务你须要有一个JSON解析。实话实说,将会有一个工具库,可是服务器也要须要传递数据。
为了不名称冲突,推荐选用domain的一部分做为子协议的名称。若是咱们开发一个使用特定格式的聊天app,咱们可能使用这样的名字:Sec-WebSocket-Protocol: chat.example.com 注意,这不是必须的。仅仅是一个可选的惯例,咱们可使用咱们想用的任意字符。
翻译这篇文档的初衷是看到关于websocket的中文大部分都是客户端相关的内容,本身又对服务器端的实现感兴趣,没有找到合适的资料,就只好本身阅读下英文,本着提升本身的目的将其翻译下来,但愿对其余同窗有所帮助,原文查看 。后面请期待node实现websocket服务器的实践篇。