# 人像处理服务

**Repository Path**: javalzw/portrait-library-server

## Basic Information

- **Project Name**: 人像处理服务
- **Description**: 通过http协议提供人像处理（基于中科院seetaface6进行封装的web人像服务）：系统管理、权限管理、用户管理、日志监控、服务器监控、人脸识别、人脸比对1:1、人脸比对1:N、人脸注册、人脸检索、活体检测、人像库等功能；开发语言为java，系统实现技术为Spring Boot + Mybatis Plus + Spring Security + layui，目前市面常用的web服务。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 11
- **Created**: 2023-01-30
- **Last Updated**: 2025-08-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 人像处理服务

#### 介绍
通过http协议提供人像处理（基于中科院seetaface6进行封装的web人像服务）：   
      1. 系统管理：权限管理、用户管理、部门管理、日志监控、服务器监控。   
      2. 业务管理：人像库列表、人脸记录、功能演示。   
      3. http协议接口功能：人脸检测、人脸比对1:1、人脸比对1:N、人脸注册、人脸检索、活体检测、根据图片标识获取人像照片、人像库信息读取等功能。   
   
  **注：目前仅支持Windows服务环境，兼容Linux环境的内容后期更新。**

#### 软件架构
 开发语言为java，系统实现技术为Spring Boot + Mybatis Plus + Spring Security + layui，目前市面常用的web服务；数据库：SQLite、MySQL。


#### 安装教程

 1.  安装依赖环境JDK1.8.0_361（jdk版本要1.8.0_261以上），MySQL5.7+
 2.  导入MySQL数据库脚本创建数据库基础环境（文件位于项目DB文件夹下）。
 3.  将项目打包成可运行jar后存放到固定目录下，拷贝项目中File文件夹下的可执行文件到jar同目录，运行可执行文件启动项目。
 4.  系统账号信息（系统管理员：账号 - admin、密码 - face@1234    人像库管理员：账号 - face、密码 - face@1234）

#### 使用说明

 1.  系统管理：常规的系统权限分配管理机制，先创建不同角色对应的权限组信息，再创建系统用户并分配权限组，当然部门可定是最先需要维护好的；日志功能记录了各项操作的记录信息（包括接口功能使用日志信息），服务器监控就是对运行该服务的设备进行了简单的信息监控。   
 2.  业务管理：   
        1）人像库列表：用于创建管理人像库（其中默认人像库、测试人像库不可手动变更、删除等操作，数据库中也不要手动操作它，方式部分服务使用异常）。   
        2）人脸记录：该列表记录是人脸注册到人像库是保存的记录信息。   
        3）功能演示：对http协议接口部分主要功能的演示。   
 3.  接口功能服务(具体信息可查看接口文档)：   
        1）JK001：token口令获取，每个token有效时长24个小时。地址：http://IP:PORT/face/api/getToken   
        2）JK002：检测照片中的人脸数据并裁剪出人脸后返回结果信息。地址：http://IP:PORT/face/api/faceDetect   
        3）JK003：注册人脸到人像库（该接口不支持多个人脸存在的照片，如果存在多张人脸则只注册第一张被检测到的）。地址：http://IP:PORT/face/api/register   
        4）JK004：注册人脸到人像库（该接口支持多个人脸存在的照片，程序根据检测到的图片依次注册到人像库）。地址：http://IP:PORT/face/api/registerMore   
        5）JK005：人脸比对（1:1）。地址：http://IP:PORT/face/api/compare   
        6）JK006：人脸比对（1:N）。地址：http://IP:PORT/face/api/compareMore   
        7）JK007：通过人像库检索人脸信息（获取用户照片注册时关联的文本信息，例如：姓名#身份证号码#手机号#等其他数据）。地址：http://IP:PORT/face/api/search   
        8）JK008：静默图片活体检测（REAL=0 - 真实人脸、SPOOF=1 - 攻击人脸（假人脸）、FUZZY=2 - 无法判断（人脸成像质量不好）、DETECTING=3 - 正在检测）。地址：http://IP:PORT/face/api/predictImage   
        9）JK009：根据主键标识获取人脸base64字符串照片。地址：http://IP:PORT/face/api/getBase64ImgById/{id}   
        10）JK010：根据主键标识获取人脸照片流。地址：http://IP:PORT/face/api/getImgById/{id}   
        11）JK011：根据人像库编号以及数据下标索引读取人脸注册信息（每次读取100条）。地址：http://IP:PORT/face/api/getFaceData/{index}   
        12）JK012：根据人脸注册标识删除注册信息（多个主键英文逗号隔开）。地址：http://IP:PORT/face/api/removeRegister   
        13）JK999：将图片流转换为base64字符串（该接口不做token权限验证）。地址：http://IP:PORT/face/api/fileToBase64Str   

#### 功能样例
 1. 业务管理：   
      1）人像库列表：
![输入图片说明](File/img/1675749124951.jpg)
      2）人脸记录：
![输入图片说明](File/img/1675749146073.jpg)    
      3）功能演示：
![输入图片说明](File/img/1675748869020.jpg)   ![输入图片说明](File/img/1675749012522.jpg)
    
 2. 接口服务：   
      1）接口文档入口：
![输入图片说明](File/img/1675749201199.jpg)   
      2）接口服务API：
![输入图片说明](File/img/1675749233944.jpg)

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)