客服系統發佈以來，一直有朋友詢問如何在寶塔面板中安裝部署，開始我一直認爲參考 Linux 版的安裝教程就可以了，一直沒有專門寫寶塔環境的教程。這段時間來諮詢的朋友越來越多，經過了解，我才知道寶塔面板的普及率有多高，好吧，那我就認真對待一下這個問題，詳細編寫了基於寶塔安裝部署升訊威在線客服系統的教程。
在編寫這個教程之後，我也被寶塔拖入坑了，確實很方便！以前我們部署發佈環境，都是在 Linux 上直接操作，對面板類的運維工具不是很感冒。這次詳細的瞭解和操作之後，只能感慨技術發展的太快，面板工具已經和早年我們印象中的樣子完全不同了，估計以後我自己再在 Linux 上部署新系統，也會先來一套寶塔再說。
在寶塔面板上部署整套客服系統，流程熟悉以後 ， 10 分鐘都不要。確實牛批。
開始
本文以 CentOS 7.9 爲例進行說明，其它版本的 Linux 安裝配置過程大同小異。
準備服務器和安裝寶塔的過程本文不再贅述。
客服系統的私有化安裝部署包可以在此下載 📩 ：https://docs.shengxunwei.com/Post/f7bc8496-14ee-4a53-07b4-08d8e3da6269/553293a8-dfa1-4282-bc3f-96c6c623fc9a
安裝 LNMP 套件
登錄寶塔面板後，勾選並安裝以下組件：
- Nginx
- MySQL
- PHP
- phpMyAdmin
客服系統對以上組件的版本沒有特殊要求，可自由選擇安裝較新版本。
詳細操作過程本文不再贅述，有需要可參閱：https://docs.shengxunwei.com/Post/f7bc8496-14ee-4a53-07b4-08d8e3da6269/37b59df0-30aa-4609-97b4-374b2bfc564f
安裝 .Net Core
進入寶塔面板的“終端”畫面。
安裝 .Net Core
- 安裝
sudo rpm -Uvh https://packages.microsoft.com/config/rhel/7/packages-microsoft-prod.rpm
sudo dnf install dotnet-sdk-3.1
如果提示 command not found，則先執行
yum -y install sudoyum -y install dnf
安裝依賴庫
進入寶塔面板的“終端”畫面。
安裝 libgdiplus
安裝該組件後訪客端頁面纔可以輸出圖形驗證碼。
-
安裝依賴
yum install libgdiplus-devel -y -
創建鏈接
ln -s /usr/lib64/libgdiplus.so /usr/lib/gdiplus.dll
ln -s /usr/lib64/libgdiplus.so /usr/lib64/gdiplus.dll
注意：如果是先啓動了服務器主程序（Server），再安裝 libgdiplus。需要重新啓動 Server 主程序以使 libgdiplus 生效。
重新啓動的方法是進入“軟件商店”畫面，進入 “Supervisor 管理器”，在主程序的“進程管理”列點擊運行狀態以使之重新啓動。
放行客服程序端口
9527 是客服程序默認使用的 TCP/IP 通信端口，也可以在配置主程序時修改爲其它端口號。
注意：私有化部署免費版固定使用 9527 端口，請勿修改。
進入寶塔面板的“安全”畫面，在防火牆標題下的“放行端口”後輸入“9527”，點擊“執行”。
放行成功後，該端口顯示在列表中。
創建數據庫
進入寶塔面板的“數據庫”畫面後，點擊“添加數據庫”。
創建數據庫完成後，點擊右側的“管理”。
使用創建數據庫時設置的用戶名和密碼登錄 phpMyAdmin。
選中左側新建的數據庫“kf”，將右側標籤頁切換到“SQL”，然後將私有化部署安裝包中提供的建表腳本複製到輸入區，點擊右側的“執行”按鈕。
提示成功後，完成數據庫表結構創建。
配置和上傳客服系統服務端程序
修改配置文件
將服務端程序上傳之前，可先在本地電腦完成對配置文件的修改。
參閱：使用自動化工具配置服務器端程序 https://docs.shengxunwei.com/Post/f7bc8496-14ee-4a53-07b4-08d8e3da6269/6bcdb41b-c963-46e9-aa42-e4ef4bf5f5f3
也可以選擇先把服務端程序上傳後，再通過寶塔的“文件”功能，手工對配置文件修改。
參閱：配置文件修改維護說明 https://docs.shengxunwei.com/Post/f7bc8496-14ee-4a53-07b4-08d8e3da6269/ca613726-63f2-4c7d-934f-b8b104281407
上傳服務器程序
在寶塔面板中進入“文件”功能，進入 /www/wwwroot 目錄，將私有化部署包中的以下目錄上傳到該目錄：
- Management
- Resource
- Server
如果要修改配置文件，找到要修改的配置文件，雙擊啓動編輯即可。
配置服務器主程序
注意：服務端程序使用 5000 端口作爲反向代理，請勿佔用此端口。
安裝 Supervisor 管理器並啓動客服主程序
進入寶塔面板的“軟件商店”畫面，搜索“Supervisor”並安裝。
安裝成功後點擊“Supervisor”右側的“設置”。
在“Supervisor 管理器”中，添加守護進程：
- 運行目錄選擇
/www/wwwroot/Server - 啓動命令輸入
dotnet Sheng.Linkup.Server.dll - 進程數量
1
點擊“確定”按鈕添加。
添加成功後，進程管理列顯示“已啓動”，表示主程序啓動成功。
如果啓動失敗，可先切換到寶塔面板的“終端”功能，進入
/www/wwwroot/Server目錄後，執行dotnet Sheng.Linkup.Server.dll命令，觀察提示的錯誤信息。
最常見的錯誤原因如數據庫連接串配置錯誤，注意檢查 Server 目錄中的 AppSettings.json 文件，參閱：主程序配置文件修改維護說明
更多信息可參閱：檢查單（部署遇到問題請對照檢查）
添加和配置主程序站點
進入寶塔面板的“網站”畫面，點擊“添加網站”按鈕，在彈出的添加對話框中，輸入：
- 你的主程序域名，如 kf-api.yourname.com
- 根目錄選擇
/www/wwwroot/Server - PHP 版本選擇
純靜態
然後點擊“提交”按鈕。
添加成功後，點擊右側的“設置”，打開設置畫面，然後切換到“配置文件”後，在開頭部分添加以下內容：
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
upstream dotnet_server_proxy {
server localhost:5000;
keepalive 2000;
}
接着切換到“反向代理”畫面，點擊“添加反向代理”按鈕：
- 目標 URL 輸入
http://localhost:5000
然後點擊“提交”按鈕。
添加反向代理成功後，點擊“配置文件”。
在反向代理的配置文件中，將以下內容添加到 location / 節點：
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
完成站點配置後，在站點列表中點擊狀態列中的“運行中”，重新啓動站點以使配置全部生效。
初始化主程序
- 訪問域名，進入 Status 查看狀態
https://kf-api.yourname.com/Status
注意：直接訪問域名顯示 404 是正常的，主程序沒有默認頁面，請留意上面的示例網址，進入
Status命令
請確認已經完成了對服務器主程序配置文件的配置。
參閱：配置和上傳客服系統服務端程序
- 初始化數據
訪問域名，進入Status/Setup命令
如：https://kf-api.yourname.com/Status/Setup
配置靜態資源站點
進入寶塔面板的“網站”畫面，點擊“添加網站”按鈕，在彈出的添加對話框中，輸入：
- 你的主程序域名，如 kf-resource.yourname.com
- 根目錄選擇
/www/wwwroot/Resource - PHP 版本選擇
純靜態
然後點擊“提交”按鈕。
添加成功後，點擊右側的“設置”，打開設置畫面，然後切換到“默認文檔”後，修改爲 v.html，然後點擊“添加”按鈕：
訪問靜態資源站點的域名，如 http://kf-resource.yourname.com ，顯示出版本信息。
配置 Web 管理後臺
請確認已經完成了對服務器主程序配置文件的配置。
參閱：配置和上傳客服系統服務端程序
添加和配置配置 Web 管理後臺站點
進入寶塔面板的“網站”畫面，點擊“添加網站”按鈕，在彈出的添加對話框中，輸入：
- 你的主程序域名，如 kf-m.yourname.com
- 根目錄選擇
/www/wwwroot/Management - PHP 版本選擇
純靜態
然後點擊“提交”按鈕。
訪問 Web 管理後臺站點的域名，如 http://kf-m.yourname.com ，顯示登錄畫面。
配置發佈客服端程序
請參閱：配置發佈客服端程序https://docs.shengxunwei.com/Post/f7bc8496-14ee-4a53-07b4-08d8e3da6269/5de7cef6-ac56-4916-b2cd-c1760cd9ae48
