超级平台使用说明

一、开发、使用环境说明

超级平台v2.3版本在Windows平台下使用，为64位程序。建议在Windows Server 2008、Windows7以上系统使用。Liunx版本将在今后根据需求开发。

超级平台v2.3采用Visual Studio 2022版开发编译。在开发、调用配套DLL时注意使用64位模式，建议同样使用Visual Studio 2022进行DLL模块的开发编译。

Visual Studio 下载网址：https://visualstudio.microsoft.com/zh-hans/

二、功能说明

超级平台主要作为公司网络软件产品的基础平台，采用编译为二进制程序的方式分发程序，以防源程序泄漏，旨在保护DLL模块功能开发者的权益。

系统采用完成端口模型，支持IPv6，在单一端口上同时提供HTTP协议、自定义TCP协议、WebSocket协议的支持。并且支持TLSv1.3的HTTPS加密通讯，当前版本采用OpenSSL 3.0作为SSL支持库。

采用DLL文件封装平台下的软件功能，以达到高效、安全、保密的要求。

超级平台支持以普通的Windows应用方式（双击）运行，也可以以Windows服务的方式运行。

支持内网服务器端通过专用反向代理连接外网服务器，实现外网用户访问内网服务器。

三、工作流程（原理）

1、普通直接访问

用户通过HTTP(s)、WebSocket(s)、普通TCP连接超级平台服务器。

超级平台根据数据包标头判断是否SSL连接，如果是则进行SSL协议握手、加密、解密等操作。然后根据接收到的数据，判断是HTTP、WebSocket还是普通TCP连接。

HTTP协议时根据请求的网址，判断是普通的静态文件还是调用哪个DLL功能模块。如果是普通的静态文件，则读取返回文件内容。如果是调用DLL功能模块，则通过对应的接口调用DLL中的函数，并返回数据。

WebSocket和普通TCP连接时，只能调用DLL功能模块的函数。

超级平台根据访问的URL中的第一级目录名来对应调用相应的DLL模块。

2、反向代理访问

超级平台运行时通过一条TCP连接到专用反向代理服务器，进行身份验证、有外网连接时呼叫超级平台。

当接收到反向代理服务器连接呼叫信息时，创建新TCP连接到反向代理模拟用户的正常访问。与正常访问的区别在于，用户正常访问是入站方式，反向代理时是服务器出站方式连接到专用反向代理服务器。

注意：使用反向代理时，域名应该解析到反向代理服务器，而不是超级平台所在服务器。

四、安装说明

1、安装VC运行时

超级平台编译时采用静态库中使用MFC，故无需安装VC运行时，如果用户所开发的DLL模块或所调用的DLL未使用此方式编译，则需要安装VC运行时。

2、创建（修改）INI文件

（1）配置INI

INI的文件名需要与超级平台的EXE文件同名，如SERVER.EXE，则对应SERVER.INI。内容如下：

[Service]
ServiceName = CimsServer（服务名，注意不要与其他服务同名）
DiplayName = CimsService（服务显示名）
[Server]
Port = 7788（服务侦听端口，需要与SN授权一致）
ThreadCount = 2（工作线程数量，根据实际情况调整）
RootDirectory = crimswww（网页根目录，根据实际位置修改）
ModuleInfo = 社区信息化管理系统（模块名称）
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静态文件）
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（模块数量）
DefaultModule = 0（默认模块号，如用户URL中未指定DLL时调用此DLL）
AdminModule = 10（具有管理功能的模块）
#0号模块（模块的编号是从0开始）
ModuleName_0 = admin（模块名）
ModuleIni_0 = server_admin.ini（模块配置文件）
ModuleDLL_0 = admin.dll（模块DLL文件名）
#1号模块（模块的编号必须小于模块数量）
ModuleName_1 = xajh2（模块名）
ModuleIni_1 = xajh2.ini（模块配置文件）
ModuleDll_1 = xajh2.dll（模块DLL文件名）

（2）授权INI

授权INI的文件名为SN.INI。具体内容在购买软件时，我公司会提供。内容如下：

;到期自动申请授权
[AuthApply]
Host=auth.ityg.com（授权服务器域名）
Port=5913（授权服务器端口）
ID=（软件编号）
Uin=（用户编号）
[key]
server =（具体的授权域名端口）
module =（具体的授权模块类型）
check =（其他的授权信息）

3、运行方式：

（1）普通应用方式运行

双击超级平台EXE文件即可运行。运行后会显示一个窗口，如下：

此方式主要为开发、调试时用途。方便观察端口是否正常侦听，连接数量变化等。开发时，可将超级平台安装于开发电脑上，通过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

即可卸载服务。卸载成功会弹出提示。

注意：以服务方式运行时，没有显示界面。在测试时，可先停止服务，用双击运行的方式调试。程序不能同时运行多个，会因为端口已经占用无法正常使用。

（3）运行日志

运行日志会记录在Windows系统，打开事件查看器即可查看来源为配置INI中指定的服务名的事件。