客服配置详解

想要使用客服需要就的必须开启长连接。长连接的配置过程稍微复杂，需要服务器放行端口，如果是宝塔就的需要在安全里面接着放行端口。如果是使用https协议访问，那就增加了一个WSS的配置，接下来会一一详细解，每一个配置过程。

1、首先放行服务器端口（v4.3.0之后版本忽略本步骤）

[info] 提示：客服端口可自定义，目前系统默认使用 20002/20003/20012 端口，v4.3.0之后版本忽略本步骤

这里以阿里云服务器为参考,进入服务器安全组端口添加放行端口【20002】【20003】，当然也可以放行【20000/30000】范围之内的全部放行，最后点击保存即可。效果如下图

2、放行服务器端口后，紧接着放行宝塔内的端口（v4.3.0之后版本忽略本步骤）

[info] 没有使用宝塔的用户，并且开启了防火墙就的使用命令放行

进入宝塔后台，点击安全菜单添加放行端口，可以添加范围例如：20000:20003,填入放行说明，最后点击保存。效果如下图

3、网站需要https协议请求，需要配置WSS（v4.3.0之后版本忽略本步骤）

[info] 这里需要明确知道一点，在http协议下访问长连接必须为ws协议，在https协议下访问长连接的协议必须是wss。并且两者不能同时拥有。不能像网站一样http和https都能访问。

首先配置wss，就的下载配置ssl的证书，这里以nginx为例，到阿里云ssl证书中心下载当前网站的ssl证书，下载下来的证书为压缩包，里面有两个文件一个文件以.key结尾的，一个文件以.pem为结尾的。把下载好的证书上传到系统后台的设置->系统设置->wss配置里。按照提示上传在对应的位置。

• 【是否开启wss】 选择 开启
• 【ssl证书PEM】上传压缩包中.pem结尾的文件
• 【ssl密钥KEY】上传压缩包中.key结尾的文件
• 点击提交保存配置
  效果如下图
  

4、直接在宝塔上申请的SSL证书，怎么得到证书文件？

进入【宝塔】点击【网站】，网站页面上方的搜索输入网站域名点击搜索，找到对应网站，点击设置->ssl->其他证书；

复制 密钥(KEY)然后在桌面上创建一个.key后缀的文件；

复制证书(PEM格式)然后在桌面上创建一个.pem后缀的文件；
然后就可以按照上一项的说明进行配置了

5、启动长连接

[info] 如何查看网站项目根目录？
答：进入【宝塔】点击【网站】，网站页面上方的搜索输入网站域名点击搜索，找到对应网站复制网站【根目录】

使用远程连接工具连接服务器，推荐使用 Xshell 或 Putty 远程连接工具

[warning] 在启动长连接之前请先去解禁启动长链接需要使用的函数

pcntl_signal pcntl_signal_dispatch pcntl_fork pcntl_wait pcntl_alarm
温馨提示： 找到网站使用的php版本去解禁函数。解禁后重载下php配置。

切换到网站根目录下例如：

cd  /www/wwwroot/crmeb/

输入启动长连接命令

sudo -u www php think workerman start --d

看到如下图所示，证明启动成功，下图中的端口和系统的默认端口是不一致不需要在意这些。上面也提到了长连接的端口是可修改的。

6、测试是否连接成功

在浏览器上打开网站进入H5端，打开浏览器控制台，点击network->ws ，现在进入【我的】页面中的客服页面，查看ws连接是否正常，【Status Code】状态为 101 Switching Protocols 证明启动成功，如下图所示：

7、客服的长连接配置完毕

配置的过程稍微复杂，大致的流程为

1. 放行服务器上长连接需要的端口
2. 放行宝塔中长连接需要的端口
3. 是否需要https协议访问，如果是的话，就需要配置wss
4. 解禁php函数
5. 启动长连接
6. 检测是否成功

以上说明为客服长连接配置的详细说明，这里这要以linux系统为核心讲解怎样开启。