超級(jí)平臺(tái)使用說明

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

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

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

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

二、功能說明

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

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

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

超級(jí)平臺(tái)支持以普通的Windows應(yīng)用方式（雙擊）運(yùn)行，也可以以Windows服務(wù)的方式運(yùn)行。

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

三、工作流程（原理）

1、普通直接訪問

用戶通過HTTP(s)、WebSocket(s)、普通TCP連接超級(jí)平臺(tái)服務(wù)器。

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

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

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

超級(jí)平臺(tái)根據(jù)訪問的URL中的第一級(jí)目錄名來對(duì)應(yīng)調(diào)用相應(yīng)的DLL模塊。

2、反向代理訪問

超級(jí)平臺(tái)運(yùn)行時(shí)通過一條TCP連接到專用反向代理服務(wù)器，進(jìn)行身份驗(yàn)證、有外網(wǎng)連接時(shí)呼叫超級(jí)平臺(tái)。

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

注意：使用反向代理時(shí)，域名應(yīng)該解析到反向代理服務(wù)器，而不是超級(jí)平臺(tái)所在服務(wù)器。

四、安裝說明

1、安裝VC運(yùn)行時(shí)

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

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

（1）配置INI

INI的文件名需要與超級(jí)平臺(tái)的EXE文件同名，如SERVER.EXE，則對(duì)應(yīng)SERVER.INI。內(nèi)容如下：

[Service]
ServiceName = CimsServer（服務(wù)名，注意不要與其他服務(wù)同名）
DiplayName = CimsService（服務(wù)顯示名）
[Server]
Port = 7788（服務(wù)偵聽端口，需要與SN授權(quán)一致）
ThreadCount = 2（工作線程數(shù)量，根據(jù)實(shí)際情況調(diào)整）
RootDirectory = crimswww（網(wǎng)頁根目錄，根據(jù)實(shí)際位置修改）
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（是否強(qiáng)制SSL加密）
Gzip_Static = 1（是否使用GZIP靜態(tài)文件）
Ext = .gsp|.ssp|.xsp（超級(jí)平臺(tái)調(diào)用DLL的URL擴(kuò)展名）
[Proxy]
Host = www.ityg.com（反向代理服務(wù)器域名，如不需要，留空）
Port = 7788（反向代理服務(wù)器端口）
User = abc（反向代理服務(wù)器密碼）
[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
;定時(shí)器定義
[Timer]
;模塊定義
[Modules]
ModuleCount = 2（模塊數(shù)量）
DefaultModule = 0（默認(rèn)模塊號(hào)，如用戶URL中未指定DLL時(shí)調(diào)用此DLL）
AdminModule = 10（具有管理功能的模塊）
#0號(hào)模塊（模塊的編號(hào)是從0開始）
ModuleName_0 = admin（模塊名）
ModuleIni_0 = server_admin.ini（模塊配置文件）
ModuleDLL_0 = admin.dll（模塊DLL文件名）
#1號(hào)模塊（模塊的編號(hào)必須小于模塊數(shù)量）
ModuleName_1 = xajh2（模塊名）
ModuleIni_1 = xajh2.ini（模塊配置文件）
ModuleDll_1 = xajh2.dll（模塊DLL文件名）

（2）授權(quán)INI

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

;到期自動(dòng)申請(qǐng)授權(quán)
[AuthApply]
Host=auth.ityg.com（授權(quán)服務(wù)器域名）
Port=5913（授權(quán)服務(wù)器端口）
ID=（軟件編號(hào)）
Uin=（用戶編號(hào)）
[key]
server =（具體的授權(quán)域名端口）
module =（具體的授權(quán)模塊類型）
check =（其他的授權(quán)信息）

3、運(yùn)行方式：

（1）普通應(yīng)用方式運(yùn)行

雙擊超級(jí)平臺(tái)EXE文件即可運(yùn)行。運(yùn)行后會(huì)顯示一個(gè)窗口，如下：

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

（2）服務(wù)方式運(yùn)行

安裝服務(wù)：

以管理員身份運(yùn)行命令行或PowerShell。進(jìn)入超級(jí)平臺(tái)所在文件夾（以超級(jí)平臺(tái)文件名為SERVER.INI為例）。運(yùn)行如下命令：

server -install

PowerShell下為:

./server -install

安裝成功會(huì)彈出提示。

運(yùn)行服務(wù)：

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

net start cimsserver

即可啟動(dòng)超級(jí)平臺(tái)服務(wù)。

也可以在任務(wù)管理器的任務(wù)頁或服務(wù)管理器中啟動(dòng)服務(wù)。

默認(rèn)情況下，安裝后的服務(wù)為自動(dòng)啟動(dòng)，即開機(jī)時(shí)會(huì)自動(dòng)運(yùn)行。

停止服務(wù)：

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

net stop cimsserver

即可停止超級(jí)平臺(tái)服務(wù)。

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

卸載服務(wù)：

以管理員身份運(yùn)行命令行或PowerShell。進(jìn)入超級(jí)平臺(tái)所在文件夾（以超級(jí)平臺(tái)文件名為SERVER.INI為例）。運(yùn)行如下命令：

server -uninstall

PowerShell下為：

./server -uninstall

即可卸載服務(wù)。卸載成功會(huì)彈出提示。

注意：以服務(wù)方式運(yùn)行時(shí)，沒有顯示界面。在測試時(shí)，可先停止服務(wù)，用雙擊運(yùn)行的方式調(diào)試。程序不能同時(shí)運(yùn)行多個(gè)，會(huì)因?yàn)槎丝谝呀?jīng)占用無法正常使用。

（3）運(yùn)行日志

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