项目核心特性
HivisionIDPhotos 的核心功能是允许用户上传任意一张正面人物照片,通过先进的AI技术自动生成符合各种规格的标准证件照。该项目不仅支持多种背景颜色和照片尺寸的自定义,还内置了智能美颜处理和水印添加功能,确保输出照片既专业又美观。
- 项目源码地址:
https://github.com/Zeyi-Lin/HivisionIDPhotos(该项目在GitHub上已获得14.8K星标,并且关注度持续快速上升) - 使用Docker Compose部署的配置示例:
services:
hivision_idphotos:
image: docker.1ms.run/linzeyi/hivision_idphotos
restart: unless-stopped
ports:
- 7860:7860
- 快速通过Docker命令启动的示例:
docker run -d --name hivision_idphotos --restart unless-stopped -p 7860:7860 docker.1ms.run/linzeyi/hivision_idphotos
在Docker Compose配置中,已经预先集成了镜像加速地址 docker.1ms.run,这有助于提升镜像拉取速度,但请注意该加速服务可能并非永久稳定可用。
项目概述
HivisionIDPhotos 采用一套完整的AI模型工作流程,能够智能识别用户上传的照片场景,并自动执行精确的抠图操作。该系统根据用户设定的规格要求,快速生成标准证件照或六寸排版照片,所有处理均在本地完成,无需依赖互联网连接。
该项目具备以下主要功能特性:
- 智能图像识别与自动抠图技术
- 支持生成多种标准尺寸的服装照和排版照
- 完全离线运行,兼容Nas设备的CPU处理能力
- 内置美颜功能,提升证件照视觉效果
- 可自定义添加水印信息
- 提供开放的API接口供扩展使用
HivisionIDPhotos 采用Apache-2.0开源许可证,该许可证条款非常宽松,几乎没有任何使用限制。因此,目前已有许多商业项目基于此代码进行二次开发和包装。

如果您有创新想法,完全可以利用其开放API构建自己的商业产品;对于摄影行业从业者,该项目能够显著提高照片处理的效率。
安装与使用体验
通过上述Docker Compose配置或Docker命令,可以下载并运行项目镜像。需要注意的是,镜像文件大小接近2GB,下载过程可能需要一定时间。成功启动后,在浏览器中访问地址:http://<nas-ip>:7860 即可使用。

系统界面完全中文化,操作逻辑清晰易懂。项目支持丰富的自定义选项,包括选择识别模型、抠图模型、照片尺寸、背景颜色、插件功能、美颜强度、水印设置、输出照片大小和打印排版方式等。

用户只需拖拽一张正面人物照片到指定区域,然后点击“开始制作”按钮,系统便会自动处理。在测试环境中,使用CPU处理单张照片大约需要20多秒即可完成全部生成流程。

当使用CPU运行AI生成任务时,处理器的负载会显著升高。例如,在配备N100处理器的Nas设备上运行期间,CPU利用率通常达到三个核心的满负荷状态。

若希望降低系统负载并加快生成速度,建议使用支持GPU加速的NVIDIA显卡,且显存容量不低于16GB。此时,选择 birefnet-v1-lite 抠图模型即可充分利用GPU进行加速处理。
总结与建议
- 操作流程简单直观,实用性高,无需额外显卡支持,兼容各类Nas设备
- 建议作为应急工具保留在系统中,可根据实际需要随时启动使用
- 对于有创业想法的用户,该项目非常适合作为副业开发的基础,具备良好的商业应用潜力