1. 概述
1.1 版本
| FineDataLink 版本 |
|---|
| 4.0 |
1.2 應用場景
本文將介紹在單機環境下，如何配置 WebSocket 埠。
注：FineDataLink 工程支援容器 Websocket 方案。推薦優先查看是否可使用該方案：容器Websocket方案
無需任何使用者操作，無需任何手動配置，無需額外開啟埠，系統可自動使用 Web 容器自帶的 WebSocket 進行連結，埠複用 http 埠。
2. 範例
2.1 修改欄位值
超級管理者可透過「fine_conf_entity視覺化配置插件」修改 WebSocket 埠。重啟伺服器後設定生效。
注1：修改 FineDB 資料庫表欄位值的方法請參考 FineDB 常用表欄位修改 。
注2：從 4.0.6 之前的版本升級到 4.0.6 及之後的版本，WebSocket埠/轉發埠不會改變，以之前的版本為準。
| 埠 | 參數名 | 4.0.6及之後版本的預設值 | 4.0.6之前版本的預設值 | 設定範圍 |
|---|---|---|---|---|
| Websocket 埠 | WebSocketConfig.port | ["58888", "59888"] | ["38888", "39888"] | 參數值為埠陣列： ["port1","port2"] port均屬於區間： (1024,65535] |
| Websocket 轉發埠 | WebSocketConfig.requestPorts | 58889 | 38889 |
設定埠號時有一些注意事項：
1）WebSocket 埠/轉發埠，支援設定多個值。
2）埠號可設定範圍：1024~65535，若為多個值，設定格式為：[埠號1,埠號2,埠號3]。
3）建議「WebSocket埠」設定多個值，作為備用，防止一台伺服器部署了多個工程，埠被佔用。
4）不要設定埠號為伺服器遠端連結埠 3389。
5）不要重複設定某個埠號既是 WebSocket 埠，又是 WebSocket 轉發埠。
6）若 WebSocketConfig.port、WebSocketConfig.requestPort 欄位後面有空格，配置不生效。
7）若 WebSocketConfig.port、WebSocketConfig.requestPort 大小寫錯誤，配置不生效。
2.2 開放埠
若防火牆開啟，可關閉防火牆，或者單獨開放埠。
若雲伺服器有安全組或者類似的內容，需要設定埠對外開放。
2.3 重啟工程
重啟 FineDataLink 。
重啟工程時，需要殺死工程下運作的進程，等待 2 分鐘埠釋放後，再重啟工程，否則有可能重啟失敗。
2.4 效果預覽
按照WebSocket埠>>WebSocket轉發埠的順序，即如果使用預設值埠，按照「58888，59888，58889」的順序依次嘗試監聽。
如果有一個埠建立監聽成功，則不再嘗試其他埠。
如果所有埠都無法與系統伺服器建立監聽，會進入部署精靈頁面，引導修改監聽埠列表，相關功能會受到影響。
此時請重新配置 WebSocket 埠和 WebSocket 轉發埠，直到有可用埠。