多协议网络服务端:CetNetworkServer 设计笔记

作者:CetXiyuan |技术栈:Qt 5.15.2 (MinGW 32-bit) |平台:Windows

阅读时长:约 10 分钟 |受众:网络服务端开发者、车联网后台工程师


写在前面

系列有一篇写了 CetNetworkTester——汽车协议的 TCP 测试客户端。这一篇是它的配套服务端

CetNetworkServer 不是测试工具,而是一个生产环境用的网络服务端——HTTP/TCP/SSL 三端口同时运行,向设备提供用户认证、文件分发、设备管理、锁车控制和许可证签发服务。和 CetNetworkTester(客户端/测试)正好是一对。

声明:本文基于真实项目 CetNetworkServer V2.4.2(发布日期 2026-07-15)。


一、工具定位:面向设备管理的生产服务端

维度CetNetworkTesterCetNetworkServer
角色测试客户端生产服务端
协议TCP 客户端(单一)HTTP + TCP + SSL 三端口
用途协议帧组装/解析/测试设备管理/认证/文件分发
用户测试工程师运营/运维人员
对端JT808/GB32960 服务端车载终端设备

核心功能:

功能说明
三协议并行HTTP(可配端口)/ TCP(81)/ SSL(443)同时监听
用户认证多角色(cetxiyuan/admin/svrcomm)+ Cookie 会话
设备管理SIM 卡维度的设备追踪和元数据管理
文件传输分块上传下载 + 进度追踪 + 16MB 缓冲区
锁车控制远程锁车/解锁命令分发
许可证签发MAC 地址 + IP 绑定的软件授权

二、三端口并行架构

┌──────────────┐ │ HTTP Server │ ← QTcpServer, 可配端口 客户端 ──┤ TCP Server │ ← QTcpServer, 端口 81 │ SSL Server │ ← CetSslServer, 端口 443 └──────┬───────┘ ↓ MainWindow(集中调度) ├── doNewConnection() → 接受连接,按协议类型标记 ├── doReadyRead() → 处理请求数据 └── doDisconnected() → 清理断开的客户端 ↓ ┌──────────────┐ │ SQLite DB │ ← 用户/设备/许可证数据 └──────────────┘ ↓ ┌──────────────┐ │ThreadDataStream│ ← 文件 I/O 工作线程 └──────────────┘

三个 QTcpServer 实例在同一个主线程中事件驱动运行。连接管理和业务逻辑集中在 MainWindow 中,通过协议前缀区分客户端类型:

// 客户端列表的标记 [HTTP] 192.168.1.100:52341 // HTTP 客户端 [TCP] 10.0.0.5:33210 // TCP 客户端 [SSL] 172.16.0.3:55432 // SSL 客户端 [HTTPBFT] 192.168.1.101:41234 // 备用 HTTP 客户端

CetSslServer:自定义 SSL 封装

SSL 端口(443)使用自定义的CetSslServer类,继承QTcpServer并封装证书加载和加密协商:

class CetSslServer : public QTcpServer { // 重写 incomingConnection,为每个连接创建 QSslSocket // 加载服务器证书 + 私钥 // 配置加密套件和协议版本 };

三、核心功能

3.1 用户认证:多角色 + Cookie 会话

三重角色体系:

角色权限
cetxiyuan管理员:全部功能、设备管理、许可证签发
admin操作员:设备查询、文件分发
svrcomm只读:设备状态查看

登录后设置 Cookie,后续请求通过 Cookie 校验会话。

3.2 设备管理:SIM 卡维度追踪

每个设备以 SIM 卡 ICCID 为主键,关联元数据:

设备档案: ├── ICCID(SIM 卡唯一标识) ├── VIN(车辆识别码) ├── IMEI(设备识别码) ├── 终端编号 + 型号 + 固件版本 ├── 激活状态 + 在线状态 ├── 锁车状态(已锁/未锁/锁车中) └── 最后在线时间

SQLite 存储,Web 界面可直接查询、编辑、导出。

3.3 文件传输:分块上传下载

设备固件和配置文件通过 HTTP 接口分发。ThreadDataStream 工作线程负责异步 I/O:

class ThreadDataStream : public QThread { // 分块读取文件(16MB 缓冲区) // emit progress(current, total) → UI 进度条更新 // 支持断点续传(记录已传输偏移量) };

主线程只负责接收 HTTP 请求和分发响应,文件 I/O 不阻塞网络事件循环。

3.4 锁车控制:与 CetSimulateEcu 联动

CetNetworkServer 的锁车接口下发锁车/解锁命令 → 车载终端接收 → CAN 总线 → ECU 执行。这个过程和前面 CetSimulateEcu 篇的锁车状态机(INIT→HANDSHAKING→...→LOCKED)是同一套协议的两端——CetNetworkServer 是控制端,CetSimulateEcu 是 ECU 端的模拟器。

3.5 许可证签发:MAC + IP 绑定

软件授权通过 MAC 地址和 IP 绑定生成许可证文件:

用户申请 → 提交 MAC 地址 + 产品 ID ↓ CetNetworkServer → 生成签名许可证 ↓ 客户端加载许可证 → 验证签名 → 激活

和 CetDevelopmentKit/CetDiagnosticInstrument 等工具的 CetLicensePlugin 使用的是同一套许可证体系。


四、线程模型:主线程事件驱动 + 一个文件 I/O 线程

和前面 CAN 系列工具的多线程轮询不同,CetNetworkServer 的线程模型非常简洁:

  • 主线程:三个 QTcpServer 的事件循环 + 业务逻辑处理
  • ThreadDataStream:唯一的工作线程,只做文件分块读取

不需要多线程处理连接——Qt 的网络模块在单个线程中用事件驱动处理数百个并发连接完全没有性能问题。文件 I/O 是唯一需要独立线程的操作,因为大文件的read()可能阻塞事件循环。


五、与 Cet 系列工具的关系

CetNetworkServer + CetNetworkTester 形成了完整的网络通信工具体系:

服务端:CetNetworkServer ←→ 客户端:CetNetworkTester (HTTP/TCP/SSL 三端口) (TCP 客户端, JT808/GB32960)

和其他工具的联动:

CetNetworkServer(许可证签发) ↓ 签发 CetDevelopmentKit / CetDiagnosticInstrument(加载许可证激活) CetNetworkServer(锁车命令) ↓ HTTP/TCP 车载终端 → CAN 总线 → CetSimulateEcu(模拟 ECU 锁车应答)

六、配套资源

  • 上游文章
    • 《汽车协议网络测试工具:CetNetworkTester 设计笔记》(客户端篇)
    • 《用 Qt 写一个 ECU 模拟器:CetSimulateEcu 设计笔记》(锁车联动)
    • 《开发者工具集成平台:CetDevelopmentKit 设计笔记》(许可证体系)

作者:CetXiyuan| 持续分享 Qt/车联网/网络服务端工程实践

本文基于真实项目 CetNetworkServer V2.4.2(发布日期 2026-07-15)。

转载请注明出处。

附录:Nginx 反向代理配置

Nginx 配置用于实现 HTTPS 访问:

前端页面截图: