数据中心控件WSS协议通信设置教程

# 前言
数据中心控件默认为WS协议，访问端口为62626，不限制ip地址访问；
用户如有特殊需要，可通过运行数据中心后，手工修改ip地址或端口号，实现指定ip地址访问或自定义端口号；
服务地址为0.0.0.0，代表允许任一ip地址访问，此时局域网的电脑均可通过数据中心控件所在电脑的ip进行访问；
如改成127.0.0.1，则允许本机访问，此时局域网的电脑通过访问数据中心控件所在电脑的ip地址是无法访问服务的；
如改成数据中心控件所在电脑的局域网ip地址，如192.168.0.2，则此时局域网通过127.0.0.1是无法访问的，但局域网的其他电脑通过192.168.0.2地址是可以访问数据中心控件的。
对于端口号的修改，一般情况，如果该端口号没有被其他程序占用，不建议修改端口号。

# WSS访问数据中心控件设置

## 前置条件

* 需自行准备一个域名，可为二级域名；
* 需有该域名的https证书；
* 数据中心控件所在电脑上需运行nginx服务

## 设置步骤

* 将域名对应的https证书放在nginx的运行目录中；
比如nginx的目录为C:\nginx-1.22.0，在目录中建立一个ssl文件夹，将证书放在ssl文件夹中，如图

![](/media/202403/2024-03-20_185928_4732850.0041195063618059136.png)

* 修改数据中心控件所在电脑上的nginx服务的运行参数；
nginx的配置文件在运行目录的conf文件夹中，找到nginx.conf文件，用记事本打开

![](/media/202403/2024-03-20_190109_5437930.09731639895699329.png)

清空该文件内容，并将下列代码进行覆盖

~~~
worker_processes 2;
events {
    worker_connections  2048;
}
http {
    include       mime.types;
    default_type  application/octet-stream;
    client_header_buffer_size 512k;
    large_client_header_buffers 4 512k;
    sendfile        off;
    keepalive_timeout  120;	
	map $http_upgrade $connection_upgrade{
	default keep-alive;
	'websocket' upgrade;
	}
server
{
    listen 80;
    listen 443 ssl;
    server_name web.xunoi.com; #此处需替换为自己的域名
    ssl on;
	ssl_certificate C:/nginx-1.22.0/ssl/8552623_web.xunoi.com.pem; #需替换为自己的ssl证书路径
	ssl_certificate_key C:/nginx-1.22.0/ssl/8552623_web.xunoi.com.key; #需替换为自己的ssl证书路径
    ssl_session_timeout 5m;
    ssl_session_cache shared:SSL:50m;
    ssl_protocols SSLv3 SSLv2 TLSv1 TLSv1.1 TLSv1.2; #按照这个协议配置
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
    ssl_prefer_server_ciphers on;
    location /  {   
     proxy_pass http://127.0.0.1:62626;        #通过配置端口指向部署websocker的项目
     proxy_http_version 1.1;    
     proxy_set_header Upgrade $http_upgrade;    
     proxy_set_header Connection "Upgrade";    
     proxy_set_header X-real-ip $remote_addr;
     proxy_set_header X-Forwarded-For $remote_addr;
     }
}
}
~~~

配置项中，需将server_name的值，替换为自己的域名；
将配置中ssl_certificate和ssl_certificate_key的值，设置为自己的ssl文件的路径
如果数据中心控件自定义了端口号，可修改proxy_pass中的ip及端口号

* 配置文件修改后，需重新启动nginx服务使之生效
* 客户端需进入系统C:\Windows\System32\drivers\etc，找到hosts文件，可用记事本打开
![](/media/202403/2024-03-20_190821_3657160.9772394191305627.png)

按下面样例增加代码并保存；此处举例为二级域名为web.xunoi.com，数据中心控件运行的局域网电脑为192.168.199.100；

![](/media/202403/2024-03-20_190842_6214700.2609711910987428.png)

* 设置完毕后，即可通过wss://域名，访问数据中心控件服务

![](/media/202403/2024-03-20_191158_4554920.9595113771554847.png)