devfox101/mt-photos-insightface-unofficial Docker 镜像 - 轩辕镜像

MT Photos人脸识别insightface API镜像

镜像概述

本镜像基于kqstone/mt-photos-insightface-unofficial仓库打包，提供MT Photos人脸识别insightface API服务。内置buffalo_l模型文件，解决首次运行需从GitHub下载模型可能失败的问题，同时支持armV8架构，适配多硬件环境。

核心功能与特性

• 内置模型文件：预打包buffalo_l模型，避免首次运行因网络问题导致的模型下载失败，提升启动效率
• 多架构支持：新增armV8架构适配，兼容更多硬件平台
• 智能资源管理（V1.1.0版本特性）：
  • 容器启动后延迟加载模型，降低初始内存占用
  • 2分钟内无识别任务自动释放模型内存，优化系统资源利用率

更新记录

V1.1.0（2025-03-14）

• 功能优化：实现模型延迟加载机制，减少启动时资源消耗
• 资源管理：添加2分钟无任务自动释放模型内存逻辑，提升资源使用效率
• 模型集成：将buffalo_l模型文件打包至镜像，规避首次运行模型下载风险
• 架构扩展：新增armV8架构支持，扩大硬件适配范围

使用场景

适用于需集成MT Photos人脸识别功能的应用开发，尤其适合对模型加载速度、资源占用有要求的场景，以及网络环境不稳定、需避免首次部署模型下载失败的生产环境。

使用方法

基本部署

镜像已内置模型文件，无需额外配置模型路径，直接运行即可启动API服务：

bash
# 拉取镜像（请替换[镜像标签]为实际版本，如v1.1.0）
docker pull [镜像仓库地址]:[镜像标签]

# 启动容器（默认端口需参考原仓库配置，此处以示例端口8000为例）
docker run -d -p 8000:8000 [镜像仓库地址]:[镜像标签]

注意事项

• 硬件架构需匹配：armV8设备直接运行，x86设备需确认镜像是否提供对应架构版本
• 模型释放机制：自动释放后再次接收任务会重新加载模型，可能产生短暂响应延迟，属正常现象