人脸识别终端网关系统

项目概述

人脸识别终端网关是一个轻量级微服务系统，部署在人脸识别终端设备与第三方业务平台之间，作为二者通信的中间件。它解决的核心问题是：如何用一套系统统一管理不同品牌、不同协议的人脸识别终端设备，并将设备的识别数据可靠地送达业务平台。

系统零数据库依赖，适合部署在边缘侧低功耗硬件上，已在多个学校宿舍、园区的门禁管理场景中投入实际使用。通过分组管理+异步分发策略、三级缓存保障机制和完整的 Web 远程管理后台，大幅降低多品牌人脸终端的管理复杂度。

主要功能

系统核心功能包括：

• 多品牌设备统一接入：将天敏、杰视等不同品牌设备的共性操作抽象为标准化接口，通过统一 HTTP API 管理所有终端；新增设备品牌时只需开发适配程序，不影响上层业务逻辑。

• 人脸数据异步分发：采用分组管理+异步分发策略，业务平台只需向设备组下发数据，系统自动将人脸数据逐一推送至组内各设备，推送失败自动重试，确保数据最终送达。

• 识别记录可靠上报：三层保障机制——统一接入解析、本地缓存防丢、自定义模板推送+自动重试，支持多推送目标和按人员类型过滤（全体/注册用户/陌生人）。

• 设备在线监控：设备定期心跳上报，系统实时更新在线状态和 IP 地址；Web 后台直观展示设备总数、在线数量、离线数量及待上传数据量。

• 视频流集成查看：自动将设备 RTSP 视频流转为浏览器可播放格式，在 Web 管理后台即可实时查看摄像头画面，无需安装任何客户端插件。

• Web 远程运维管理：完整的 Web 管理后台，涵盖系统信息、网络设置、设备管理、数据联动、用户管理、识别记录、系统日志和端口转发等模块。

技术架构

系统采用轻量级技术架构：

• 轻量级微服务：采用微服务设计，各功能模块独立部署维护，互不干扰，新增功能按需启用。

• 零数据库依赖：系统无需数据库即可运行，适合部署在边缘侧低功耗硬件上，降低部署门槛和运维成本。

• HTTP API 统一对接：业务平台通过标准 HTTP 接口与网关交互，无需关心设备品牌差异和底层通信协议。

• 边缘侧部署：支持 x86 和 ARM 架构，适合部署在宿舍弱电机房、园区门卫室等边缘场景的低功耗硬件上。

• 三级缓存与自动重试：识别记录本地缓存、推送失败自动重试、断网数据不丢失的综合保障机制。