超級平臺使用說明

一、開發(fā)、使用環(huán)境說明

超級平臺v2.3版本在Windows平臺下使用，為64位程序。建議在Windows Server 2008、Windows7以上系統(tǒng)使用。Liunx版本將在今后根據(jù)需求開發(fā)。

超級平臺v2.3采用Visual Studio 2022版開發(fā)編譯。在開發(fā)、調用配套DLL時注意使用64位模式，建議同樣使用Visual Studio 2022進行DLL模塊的開發(fā)編譯。

Visual Studio 下載網(wǎng)址：https://visualstudio.microsoft.com/zh-hans/

二、功能說明

超級平臺主要作為公司網(wǎng)絡軟件產(chǎn)品的基礎平臺，采用編譯為二進制程序的方式分發(fā)程序，以防源程序泄漏，旨在保護DLL模塊功能開發(fā)者的權益。

系統(tǒng)采用完成端口模型，支持IPv6，在單一端口上同時提供HTTP協(xié)議、自定義TCP協(xié)議、WebSocket協(xié)議的支持。并且支持TLSv1.3的HTTPS加密通訊，當前版本采用OpenSSL 3.0作為SSL支持庫。

采用DLL文件封裝平臺下的軟件功能，以達到高效、安全、保密的要求。

超級平臺支持以普通的Windows應用方式（雙擊）運行，也可以以Windows服務的方式運行。

支持內(nèi)網(wǎng)服務器端通過專用反向代理連接外網(wǎng)服務器，實現(xiàn)外網(wǎng)用戶訪問內(nèi)網(wǎng)服務器。

三、工作流程（原理）

1、普通直接訪問

用戶通過HTTP(s)、WebSocket(s)、普通TCP連接超級平臺服務器。

超級平臺根據(jù)數(shù)據(jù)包標頭判斷是否SSL連接，如果是則進行SSL協(xié)議握手、加密、解密等操作。然后根據(jù)接收到的數(shù)據(jù)，判斷是HTTP、WebSocket還是普通TCP連接。

HTTP協(xié)議時根據(jù)請求的網(wǎng)址，判斷是普通的靜態(tài)文件還是調用哪個DLL功能模塊。如果是普通的靜態(tài)文件，則讀取返回文件內(nèi)容。如果是調用DLL功能模塊，則通過對應的接口調用DLL中的函數(shù)，并返回數(shù)據(jù)。

WebSocket和普通TCP連接時，只能調用DLL功能模塊的函數(shù)。

超級平臺根據(jù)訪問的URL中的第一級目錄名來對應調用相應的DLL模塊。

2、反向代理訪問

超級平臺運行時通過一條TCP連接到專用反向代理服務器，進行身份驗證、有外網(wǎng)連接時呼叫超級平臺。

當接收到反向代理服務器連接呼叫信息時，創(chuàng)建新TCP連接到反向代理模擬用戶的正常訪問。與正常訪問的區(qū)別在于，用戶正常訪問是入站方式，反向代理時是服務器出站方式連接到專用反向代理服務器。

注意：使用反向代理時，域名應該解析到反向代理服務器，而不是超級平臺所在服務器。

四、安裝說明

1、安裝VC運行時

超級平臺編譯時采用靜態(tài)庫中使用MFC，故無需安裝VC運行時，如果用戶所開發(fā)的DLL模塊或所調用的DLL未使用此方式編譯，則需要安裝VC運行時。

2、創(chuàng)建（修改）INI文件

（1）配置INI

INI的文件名需要與超級平臺的EXE文件同名，如SERVER.EXE，則對應SERVER.INI。內(nèi)容如下：

[Service]
ServiceName = CimsServer（服務名，注意不要與其他服務同名）
DiplayName = CimsService（服務顯示名）
[Server]
Port = 7788（服務偵聽端口，需要與SN授權一致）
ThreadCount = 2（工作線程數(shù)量，根據(jù)實際情況調整）
RootDirectory = crimswww（網(wǎng)頁根目錄，根據(jù)實際位置修改）
ModuleInfo = 社區(qū)信息化管理系統(tǒng)（模塊名稱）
SSL = 1（是否開啟SSL加密，0為否1為是，下同）
SSL_key = crimsdebug dty.com.cn.key（SSL私鑰證書）
SSL_crt = crimsdebug dty.com.cn_public.crt（SSL公鑰證書）
SSL_ca = crimsdebug dty.com.cn_chain.crt（SSL根證書）
SSL_force = 0（是否強制SSL加密）
Gzip_Static = 1（是否使用GZIP靜態(tài)文件）
Ext = .gsp|.ssp|.xsp（超級平臺調用DLL的URL擴展名）
[Proxy]
Host = www.ityg.com（反向代理服務器域名，如不需要，留空）
Port = 7788（反向代理服務器端口）
User = abc（反向代理服務器密碼）
[MIME]
.bmp = image/bmp
.css = text/css
.cur = application/octet-stream
.gif = image/gif
.htm = text/html
.html = text/html
.ico = image/x-icon
.jpg = image/jpeg
.jpeg = image/jpeg
.js = text/jscript
.png = image/png
.txt = text/plain
.wav = audio/wav
.xml = text/xml
.xsl = text/xsl
.pdf = application/pdf
;定時器定義
[Timer]
;模塊定義
[Modules]
ModuleCount = 2（模塊數(shù)量）
DefaultModule = 0（默認模塊號，如用戶URL中未指定DLL時調用此DLL）
AdminModule = 10（具有管理功能的模塊）
#0號模塊（模塊的編號是從0開始）
ModuleName_0 = admin（模塊名）
ModuleIni_0 = server_admin.ini（模塊配置文件）
ModuleDLL_0 = admin.dll（模塊DLL文件名）
#1號模塊（模塊的編號必須小于模塊數(shù)量）
ModuleName_1 = xajh2（模塊名）
ModuleIni_1 = xajh2.ini（模塊配置文件）
ModuleDll_1 = xajh2.dll（模塊DLL文件名）

（2）授權INI

授權INI的文件名為SN.INI。具體內(nèi)容在購買軟件時，我公司會提供。內(nèi)容如下：

;到期自動申請授權
[AuthApply]
Host=auth.ityg.com（授權服務器域名）
Port=5913（授權服務器端口）
ID=（軟件編號）
Uin=（用戶編號）
[key]
server =（具體的授權域名端口）
module =（具體的授權模塊類型）
check =（其他的授權信息）

3、運行方式：

（1）普通應用方式運行

雙擊超級平臺EXE文件即可運行。運行后會顯示一個窗口，如下：

此方式主要為開發(fā)、調試時用途。方便觀察端口是否正常偵聽，連接數(shù)量變化等。開發(fā)時，可將超級平臺安裝于開發(fā)電腦上，通過127.0.0.1的IP進行連接。

（2）服務方式運行

安裝服務：

以管理員身份運行命令行或PowerShell。進入超級平臺所在文件夾（以超級平臺文件名為SERVER.INI為例）。運行如下命令：

server -install

PowerShell下為:

./server -install

安裝成功會彈出提示。

運行服務：

（以SERVER.INI中定義的服務名為CimsServer為例）在命令行或PowerShell下運行：

net start cimsserver

即可啟動超級平臺服務。

也可以在任務管理器的任務頁或服務管理器中啟動服務。

默認情況下，安裝后的服務為自動啟動，即開機時會自動運行。

停止服務：

（以SERVER.INI中定義的服務名為CimsServer為例）在命令行或PowerShell下運行：

net stop cimsserver

即可停止超級平臺服務。

也可以在任務管理器的任務頁或服務管理器中停止或重啟服務。

卸載服務：

以管理員身份運行命令行或PowerShell。進入超級平臺所在文件夾（以超級平臺文件名為SERVER.INI為例）。運行如下命令：

server -uninstall

PowerShell下為：

./server -uninstall

即可卸載服務。卸載成功會彈出提示。

注意：以服務方式運行時，沒有顯示界面。在測試時，可先停止服務，用雙擊運行的方式調試。程序不能同時運行多個，會因為端口已經(jīng)占用無法正常使用。

（3）運行日志

運行日志會記錄在Windows系統(tǒng)，打開事件查看器即可查看來源為配置INI中指定的服務名的事件。