携信客服插件布署操作说明

admin

一、设置代理的2种情况：
      1、不使用端口进行socket链接，比如为了隐藏端口、端口不对外开放、端口被占用不愿用其它端口或环境限制要求等（非必须设置）。
      2、站点使用了https协议访问，则必须设置代理

二、宝塔环境
      1、删除php禁用函数（宝塔默认情况下会禁用一些函数）
            a. 进入宝塔面板主界面
            b. 点击“软件商店”
            c. 选择“已安装”->找到对应的应用如”php7.4“
            d. 点击”设置“->选择"禁用函数”
            e. 分别查找 shell_exec、pcntl_signal_dispatch、pcntl_signal、pcntl_alarm、pcntl_fork、pcntl_wait 共6个函数并移除            
             f.  重启php
        2、nginx设置websocket代理（https必须，其它可省略）
             # 在nginx配置文件中加入以下配置（默认端口8011）                        
             location ~ ^/ws$ {
                proxy_pass http://127.0.0.1:8011;
                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 Host $host;
                proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                proxy_redirect off;
             }          
        3、添加放行端口8011 （使用代理，则该设置省略）
              a. 进入宝塔面板 或 云服务器安全组
              b. 点击“安全”，添加8011


三、后台管理

        1、携信客服插件->设置
             a. socket地址（使用代理，必填）
             输入【域名/ws】（不要中括号，不要带http或https前缀），例如本站：forum.ongl.cn/ws
        2、携信客服插件->进程管理
             a. 检测环境，全部通过后
             b. 执行启动

四、其它问题
             1、一些用户的宝塔nginx rewrite重写导致/ws返回404，这时候可以在论坛根目录新建一个名称为ws的空白文件即可
             2、访客端报来源非法问题（多站点引入会出现“来源非法”提示），此时只需编辑站点目录下/data/xchat/.env文件，设置allowUrl=你的站点域名1,域名2,域名3

五、配置事例