Websocket簡介- FineReport帮助文档 - 全面的报表使用教程和学习资料

1. 概述

報表伺服器版本	新增功能
11.0	-
11.0.2	新增了一個容器Websocket方案，詳情請參見：容器Websocket方案

本文將從以下幾點為大家介紹websocket。

1）為什麼要設定websocket

2）不設定websocket會怎麼樣

3）怎麼設定websocket

4）websocket設定不生效怎麼排查

WebSocket可以讓伺服器端主動向用戶端推送資料。

在WebSocket API中，用戶端和伺服器只需要完成一次握手，兩者之間就直接可以創建持久性的連結，並進行雙向資料傳輸。

WebSocket 主要用於刷新 token、使用者被踢出、平臺消息、記憶體和 CPU 顯示、平臺日誌處當前系統線上人數、資料連結編輯狀態的確定。

FineReport 工程預設配置了 WebSocket 埠和 WebSocket 轉發埠。

根據不同的工程環境，兩個埠的生效順序不完全相同。按照生效順序，會依次嘗試監聽，如果有一個埠監聽成功，則不再嘗試其他埠。

埠

JAR 包

預設值

是否支援

設定多個值

Websocket 埠

WebSocketConfig.port

["38888", "39888"]

支援

Websocket 轉發埠

2019-11-08 及之後

WebSocketConfig.requestPorts

38889

支援

使用者可根據自己的工程情況選擇合適的 WebSocket 埠配置方法，詳情請參見下表：

方案	場景	配置方法
容器Websocket方案	11.0.2及之後版本，新增了一個容器Websocket方案無需任何使用者操作，系統可自動使用Web容器自帶的WebSocket進行連結，埠複用http埠只需使用者環境滿足生效條件，則自動使用該方案若使用者環境不滿足生效條件，則可考慮自行配置socket.io方案	容器Websocket方案
socket.io方案	單機環境配置 WebSocket 埠	單機配置WebSocket埠
	集群環境配置 WebSocket 埠	集群配置WebSocket埠
	HTTPS 環境配置 Websocket 埠	HTTPS環境配置WebSocket
	僅對外開放一個埠	不額外給WebSocket對外開放埠