mfsecurity/aaf-afisd Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

指纹匹配服务镜像文档

镜像概述

本Docker镜像提供高效的指纹匹配服务，支持指纹特征数据的比对、验证及相似度评估。镜像内置优化的指纹匹配算法，可快速处理指纹特征模板的比对请求，适用于各类需要身份识别与验证的应用场景，简化指纹识别功能的集成与部署流程。

核心功能与特性

• 指纹特征比对：支持将输入指纹特征与目标指纹特征库进行比对，返回匹配结果
• 相似度评分：提供0-100分的相似度量化评分，支持自定义匹配阈值设置
• 多格式支持：兼容ISO/IEC ***-2等主流指纹特征数据格式
• 高性能处理：优化的算法实现，单实例可支持每秒数百次比对请求
• REST API接口：提供标准HTTP接口，便于与各类应用系统集成
• 轻量化部署：基于Alpine Linux构建，镜像体积小，启动速度快

使用场景与适用范围

• 身份验证系统：用户登录、交易授权等场景的身份核验
• 考勤管理系统：员工上下班打卡的指纹身份确认
• 物理安全门禁：办公楼、机房等场所的指纹门禁控制
• 移动设备应用：手机、平板等移动终端的本地或云端指纹识别
• 司法与公共安全：嫌疑人身份比对、失踪人口查找等公安司法应用

使用方法与配置说明

获取镜像

bash
docker pull [镜像仓库地址]/fingerprint-matching-service:latest

启动容器

基础启动命令：

bash
docker run -d -p 8080:8080 --name fingerprint-service [镜像仓库地址]/fingerprint-matching-service:latest

环境变量配置

带环境变量的启动示例：

bash
docker run -d -p 8080:8080 \
  -e MATCH_THRESHOLD=80 \
  -e LOG_LEVEL=DEBUG \
  --name fingerprint-service [镜像仓库地址]/fingerprint-matching-service:latest

API接口使用示例

1. 指纹比对请求

请求地址：http://localhost:8080/api/match
请求方法：POST
请求体：

json
{
  "template1": "base64-encoded-fingerprint-template-1",
  "template2": "base64-encoded-fingerprint-template-2"
}

响应示例：

json
{
  "matched": true,
  "similarityScore": 92.5,
  "threshold": 85,
  "timestamp": "2023-10-01T12:00:00Z"
}

2. 健康检查

请求地址：http://localhost:8080/api/health
请求方法：GET
响应示例：

json
{
  "status": "UP",
  "version": "1.0.0",
  "uptime": "2h30m"
}

持久化配置

如需持久化存储日志或特征库数据，可挂载本地目录：

bash
docker run -d -p 8080:8080 \
  -v /local/logs:/app/logs \
  -v /local/templates:/app/templates \
  --name fingerprint-service [镜像仓库地址]/fingerprint-matching-service:latest

扩展部署（Docker Compose）

yaml
version: '3'
services:
  fingerprint-service:
    image: [镜像仓库地址]/fingerprint-matching-service:latest
    ports:
      - "8080:8080"
    environment:
      - MATCH_THRESHOLD=85
      - LOG_LEVEL=INFO
    volumes:
      - ./logs:/app/logs
    restart: always