創(chuàng)建wss服務(wù)

問：

Workerman如何創(chuàng)建一個wss服務(wù)，使得客戶端可以用過wss協(xié)來連接通訊，比如在微信小程序中連接服務(wù)端。

答：

wss協(xié)議實際是websocket+SSL，就是在websocket協(xié)議上加入SSL層，類似https(http+SSL)。
所以只需要在websocket協(xié)議的基礎(chǔ)上開啟SSL即可支持wss協(xié)議。

方法一、利用nginx/apache代理SSL(推薦)

推薦理由

• 可以復(fù)用443端口，客戶端連接時不必指定端口
• 集中管理 SSL 證書，可以復(fù)用網(wǎng)站配置
• 可以負載均衡
• 自帶日志監(jiān)控
• 更好的兼容性

通訊原理及流程

1、客戶端發(fā)起wss連接連到nginx/apache

2、nginx/apache將wss協(xié)議的數(shù)據(jù)轉(zhuǎn)換成ws協(xié)議數(shù)據(jù)并轉(zhuǎn)發(fā)到Workerman的websocket協(xié)議端口

3、Workerman收到數(shù)據(jù)后做業(yè)務(wù)邏輯處理

4、Workerman給客戶端發(fā)送消息時，則是相反的過程，數(shù)據(jù)經(jīng)過nginx/apache轉(zhuǎn)換成wss協(xié)議然后發(fā)給客戶端

nginx配置參考

前提條件及準備工作：

1、已經(jīng)安裝nginx，版本不低于1.3

2、假設(shè)Workerman監(jiān)聽的是8282端口(websocket協(xié)議)

3、已經(jīng)申請了證書（pem/crt文件及key文件）假設(shè)放在了/etc/nginx/conf.d/ssl下

4、打算利用nginx開啟443端口對外提供wss代理服務(wù)（端口可以根據(jù)需要修改）

5、nginx一般作為網(wǎng)站服務(wù)器運行著其它服務(wù)，為了不影響原來的站點使用，這里使用地址 域名.com/wss 作為wss的代理入口。也就是客戶端連接地址為 wss://域名.com/wss

nginx配置類似如下：

server {
  listen 443;
  # 域名配置省略...

  ssl on;
  ssl_certificate /etc/ssl/server.pem;
  ssl_certificate_key /etc/ssl/server.key;
  ssl_session_timeout 5m;
  ssl_session_cache shared:SSL:50m;
  ssl_protocols SSLv3 SSLv2 TLSv1 TLSv1.1 TLSv1.2;
  ssl_ciphers ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP;

  location /wss
  {
    proxy_pass http://127.0.0.1:8282;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
    proxy_set_header X-Real-IP $remote_addr;
  }

  # location / {} 站點的其它配置...
}

測試

// 證書是會檢查域名的，請使用域名連接。注意這里不寫端口
ws = new WebSocket("wss://域名.com/wss");

ws.onopen = function() {
    alert("連接成功");
    ws.send('tom');
    alert("給服務(wù)端發(fā)送一個字符串：tom");
};
ws.onmessage = function(e) {
    alert("收到服務(wù)端的消息：" + e.data);
};

利用apache代理wss

也可以利用apache作為wss代理轉(zhuǎn)發(fā)給workerman。

準備工作：

1、GatewayWorker 監(jiān)聽 8282 端口(websocket協(xié)議)

2、已經(jīng)申請了ssl證書, 假設(shè)放在了/server/httpd/cert/ 下

3、利用apache轉(zhuǎn)發(fā)443端口至指定端口8282

4、httpd-ssl.conf 已加載

5、openssl 已安裝

啟用 proxy_wstunnel_module 模塊

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so

配置SSL及代理

#extra/httpd-ssl.conf
DocumentRoot "/網(wǎng)站/目錄"
ServerName 域名

# Proxy Config
SSLProxyEngine on

ProxyRequests Off
ProxyPass /wss ws://127.0.0.1:8282/wss
ProxyPassReverse /wss ws://127.0.0.1:8282/wss

# 添加 SSL 協(xié)議支持協(xié)議,去掉不安全的協(xié)議
SSLProtocol all -SSLv2 -SSLv3
# 修改加密套件如下
SSLCipherSuite HIGH:!RC4:!MD5:!aNULL:!eNULL:!NULL:!DH:!EDH:!EXP:+MEDIUM
SSLHonorCipherOrder on
# 證書公鑰配置
SSLCertificateFile /server/httpd/cert/your.pem
# 證書私鑰配置
SSLCertificateKeyFile /server/httpd/cert/your.key
# 證書鏈配置,
SSLCertificateChainFile /server/httpd/cert/chain.pem

測試

// 證書是會檢查域名的，請使用域名連接。注意沒有端口
ws = new WebSocket("wss://域名.com/wss");

ws.onopen = function() {
    alert("連接成功");
    ws.send('tom');
    alert("給服務(wù)端發(fā)送一個字符串：tom");
};
ws.onmessage = function(e) {
    alert("收到服務(wù)端的消息：" + e.data);
};

方法二 ，直接用Workerman開啟SSL(不推薦)

注意
nginx/apache代理SSL和Workerman設(shè)置SSL二選一，不能同時開啟。

準備工作：

1、Workerman版本>=3.3.7

2、PHP安裝了openssl擴展

3、已經(jīng)申請了證書（pem/crt文件及key文件）放在磁盤任意目錄

代碼：

<?php
use Workerman\Worker;
use Workerman\Connection\TcpConnection;
require_once __DIR__ . '/vendor/autoload.php';

// 證書最好是申請的證書
$context = array(
    // 更多ssl選項請參考手冊 http://php.net/manual/zh/context.ssl.php
    'ssl' => array(
        // 請使用絕對路徑
        'local_cert'        => '磁盤路徑/server.pem', // 也可以是crt文件
        'local_pk'          => '磁盤路徑/server.key',
        'verify_peer'       => false,
        'allow_self_signed' => true, //如果是自簽名證書需要開啟此選項
    )
);
// 這里設(shè)置的是websocket協(xié)議（端口任意，但是需要保證沒被其它程序占用）
$worker = new Worker('websocket://0.0.0.0:8282', $context);
// 設(shè)置transport開啟ssl，websocket+ssl即wss
$worker->transport = 'ssl';
$worker->onMessage = function(TcpConnection $con, $msg) {
    $con->send('ok');
};

Worker::runAll();

通過以上的代碼，Workerman就監(jiān)聽了wss協(xié)議，客戶端就可以通過wss協(xié)議來連接workerman實現(xiàn)安全即時通訊了。

測試

打開chrome瀏覽器，按F12打開調(diào)試控制臺，在Console一欄輸入(或者把下面代碼放入到html頁面用js運行)

// 證書是會檢查域名的，請使用域名連接，注意這里有端口號
ws = new WebSocket("wss://域名.com:8282");
ws.onopen = function() {
    alert("連接成功");
    ws.send('tom');
    alert("給服務(wù)端發(fā)送一個字符串：tom");
};
ws.onmessage = function(e) {
    alert("收到服務(wù)端的消息：" + e.data);
};

常見錯誤
SSL routines:SSL23_GET_CLIENT_HELLO:http request
原因是客戶端使用ws://域名.com來訪問導(dǎo)致的，正確的訪問地址應(yīng)該是wss://域名.com，既以wss開頭訪問。
出現(xiàn)這個問題大部分場景是端口原本是ws的，突然改成wss后有些客戶端頁面沒刷新，仍然以ws方式訪問，導(dǎo)致錯誤。
這個錯誤可以忽略，不影響正常wss的連接。

注意：

1、如果必須使用443端口請使用上面第一種方案nginx/apache代理方式實現(xiàn)wss。

2、wss端口只能通過wss協(xié)議訪問，ws無法訪問wss端口。

3、證書一般是與域名綁定的，所以測試的時候客戶端請使用域名連接，不要使用ip去連。

4、如果出現(xiàn)無法訪問的情況，請檢查服務(wù)器防火墻。

5、此方法要求PHP版本>=5.6，因為微信小程序要求tls1.2，而PHP5.6以下版本不支持tls1.2。

相關(guān)文章：
透過代理獲取客戶端真實ip
workerman的ssl上下文選項參考