简介Nginx服务器的Websockets配置方法

nginx 1.3.13 已经发布了,该版本支持 connection: upgrade 和 upgrade 头,这就意味着支持websocket代理了.很多人都在等这个新特性以至于 “nginx 支持 websockets 吗?” 成为了 freenode上的#nginx频道最常问的问题. 有了这种方式,让我们来看看nginx的websocket实现.
nginx新添加的websockets配置指令

中提到的配置如下:(译者注:原文中的链接其实不是文档的链接.现在nginx的官方文档中已经有websocket的说明了http://nginx.org/en/docs/http/websocket.html)
 

    location /chat/ {
    proxy_pass http://backend;
    proxy_http_version 1.1;
    proxy_set_header upgrade $http_upgrade;
    proxy_set_header connection "upgrade";
    }

这配置的确是相当简单连配置http的版本都是以前版本就支持的. 我们还可以稍微优化一下配置,通过创建一个链接的变量把proxy_set_headers放到一个公共的包含文件中,以此来提高通用性.

 
    map $http_connection $upgrade_requested {
    default upgrade;
    '' close;
    }

这样使得变量 $upgrade_requested 可以在 proxy_set_header connection 里面使用,而且如果没有 upgrade 的链接请求,则conection这个头会被设置为"",这样就不会干扰普通的请求了.这样做的好处是,如果你只使用http/1.1代理,那么你不需要再另外配置一个location来专门处理websockets.

链接升级似乎没有往后移植到稳定的版本中，因此如果你想要使用链接升级功能，你必须使用开发版本。感激的是nginx的开发版本并不意味着它不是运行稳定版，只是意味着api会变，在这种情况下只会影响模块的编写者。不要害怕安装开发版本来尝试这个新特征。

局限性：

到目前为止，在websocket的执行部署中有一些局限性：

客户端必须制定链接升级

客户端必须请求链接升级，否则nginx将会失败。当前这个要求在代码里列为要做的部分，因此我需要说它是怎么失败的，但是我可以肯定的是它最后也会被执行，因此我不需要依赖它。这个约束对任何人来说不是个问题，只会在当模块的编写者或许想要应用连接升级到后端且本身处理响应的情况下才会是问题。

websockets 超时
websockets 仍然受到缺省为60秒的的影响。这意味着，如果你有一个程序使用了 websockets，但又可能超过60秒不发送任何数据的话，那你要么需要增加超时时间，要么实现一个 ping 的消息以保持联系。使用 ping 的解决方法有额外的好处，可以发现连接是否被意外关闭。

keep-alive & websockets
keep-alive pings 对上述超时问题无效，因为它们只是在 tcp 级别上发送空包。它们不向应用程序报告，所以应用程序也不响应它们，因此 proxy_read_timeout 仍然会触发。
 

websockets支持ssl
由于websockets绑定在正常的代理模块中，所以ssl照常的工作运行。

代理缓存
websockets利用两个内存缓冲区来实现代理缓存配置(proxy_buffer_size)的大小，一个用于上行数据，另一个用于下行数据。websockets和普通的代理请求所不同的是，websockets不会将数据缓存到磁盘。

大小写敏感的upgrade头部
有一些后端程序对upgrade头做大小写检查，同时支持“upgrade”和“upgrade”两种写法，否则的话，只有“upgrade”写法能正常工作。如果配置看上去都正确，就是不能正常工作，就要尝试修改头部的大小写了。