[[::linux|返回]]

# 云端人脸识别服务器

为实现偶尔使用的GPU人脸识别需求，在`201911p26`及之后的版本中实现了`云端人脸识别服务器`功能，该功能的核心逻辑是：

+ 在学校部署small版本镜像
+ 在云端部署large版本镜像并安装GPU设备
+ 学校CDN在收到人脸识别请求后将请求转发到云端服务器做人脸识别

## 使用条件

+ 学校CDN到云端网络条件良好
+ 该功能适用于：
  + 演示
  + 需要用户触发才开始进行人脸识别，识别成功或超时后自动退出人脸识别功能
  + 具有人脸检测预处理功能的班牌
+ 该功能不使用用于：
  + 具有长时间运行人脸识别算法要求的学校，例如人脸考勤需要7*24小时运行人脸识别算法
  + 需要使用人脸识别功能的设备较多的学校
  + 没有人脸检测预处理功能的班牌


## 设置
### 云端服务器
安装有GPU硬件并可以公网访问的服务器均可。

+ 安装large版本镜像
+ 在任意一个学校的CMDB下添加一个服务器类型的设备，并在该设备下启用“GPU人脸识别”
+ 在CDN服务器上部署学校证书与设备对应的CMDBID
+ 确认`campusng.py info`的输出中`GPU`的状态显示为`available`
+ 将CDN服务器的80端口配置为可公网访问

### 学校CDN服务器
任意安装small镜像的CDN服务器均可，对性能没有要求，所有的人脸检测与识别均转发到云端服务器处理，但是人脸比对在CDN服务器本地进行。

+ 在CMDB服务器设置中勾选`GPU人脸识别`(CMDB已修改为所有型号的服务器均存在`GPU人脸识别`选项，不再要求必须是HWPC004)
+ 在CDN服务器上手工创建文件`/zxedu/data/config/campusng/zxface_remote_url`,并写入云端GPU服务器的URL(包含`http://`)

> NOTE: 因为人脸比对在CDN服务器本地进行，所以云端服务器只实现了算法并不需要知道识别到的人是谁，从而云端服务器不需要和CDN服务器部署的是同一个学校的证书，一个云端服务器可以同时为多个学校提供服务。


## campusng.py

`campusng.py info`输出中的`GPU`字段显示人脸识别算法的配置与状态，有4种取值：

+ 不显示：CMDB中未启用`GPU人脸识别`
+ 红色unavailable：本地未安装GPU并且未配置`云端人脸识别`
+ 黄色remote：使用`云端人脸识别`
+ 绿色available：使用本地GPU人脸识别