# 客服配置詳解（開源版無內置客服系統） 想要使用客服需要就的必須開啟長連接。長連接的配置過程稍微復雜，需要服務器放行端口，如果是寶塔就的需要在安全里面接著放行端口。如果是使用https協議訪問，那就增加了一個WSS的配置，接下來會一一詳細解，每一個配置過程。 ## 1、首先放行服務器端口 >[info] 提示：客服端口可自定義，目前系統默認使用 20002/20003/20012 端口，v4.3.0之后版本忽略本步驟 這里以阿里云服務器為參考,進入服務器安全組端口添加放行端口【20002】【20003】，當然也可以放行【20000/30000】范圍之內的全部放行，最后點擊保存即可。效果如下圖  ## 2、放行服務器端口后，緊接著放行寶塔內的端口 >[info] 沒有使用寶塔的用戶，并且開啟了防火墻就的使用命令放行 進入寶塔后臺，點擊安全菜單添加放行端口，可以添加范圍例如：20000:20003,填入放行說明，最后點擊保存。效果如下圖  ## 3、網站需要https協議請求，需要配置WSS >[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系統為核心講解怎樣開啟。