一键生成专业证件照 HivisionIDPhotos 离线智能制作工具支持多种规格自定义背景

🎬 HivisionIDPhotos - 一键生成专业证件照

项目介绍

HivisionIDPhotos 是一款开箱即用、轻量级的证件照智能制作工具。它采用先进的AI算法，集成了高效的人像抠图、人脸检测和证件照生成功能。无需复杂配置，只需上传一张照片，即可快速获得符合各类标准规格的专业证件照。

项目基于纯离线推理架构设计，仅需CPU即可快速处理，支持多种抠图模型选择（MODNet、BiRefNet等），可生成标准证件照、高清版本和六寸排版照。同时支持自定义背景色、美颜处理、人脸对齐等多项高级功能，让你随时随地制作出媲美专业摄影棚的证件照。

项目地址：点我跳转

部署安装

如需在外网也能访问项目，建议配置内网穿透服务。可前往帕斯内网穿透注册账号，具体操作步骤可参考内网穿透全平台上手攻略，轻松实现远程访问。

最快速上手 - Docker 单命令启动

打开你的 NAS 设备或服务器，执行以下命令即可一键启动 HivisionIDPhotos 服务：

1docker run -d -p 7860:7860 linzeyi/hivision_idphotos

等待镜像下载完成后，在浏览器中访问 `http://你的设备IP:7860` 即可打开应用。

端口说明：

容器内部运行端口为 `7860`

如果该端口已被占用，可修改命令中的第一个 `7860` 为其他端口，例如：`-p 8080:7860`

Docker Compose 部署（可选）

如果你更倾向于使用 docker-compose 管理容器，可以创建以下配置文件：

在项目目录下创建 `docker-compose.yml` 文件，内容如下：

1version: '3.8'
2services:
3  hivision:
4    image: linzeyi/hivision_idphotos:latest
5    ports:
6      - "7860:7860"
7    environment:
8      - RUN_MODE=beast
9      - DEFAULT_LANG=zh
10    restart: unless-stopped

然后在该目录执行：

1docker compose up -d

环境变量配置说明：

必须设置：

无（所有配置都是可选的）

可选设置：

`RUN_MODE`：运行模式，设置为 `beast` 可启用野兽模式，此模式下模型将持久保存在内存中，大幅提升二次推理速度，建议内存16GB以上的用户使用

`DEFAULT_LANG`：默认语言，可设置为 `zh`（中文）或 `en`（英文）

`FACE_PLUS_API_KEY`：Face++ API密钥（可选，用于更高精度的人脸检测）

`FACE_PLUS_API_SECRET`：Face++ API密钥对应的Secret（可选）

其他配置保持默认即可，无需额外设置。

启动 API 服务（可选）

如果你需要通过 API 接口调用证件照生成功能，可以启动 API 后端服务：

1docker run -d -p 8080:8080 linzeyi/hivision_idphotos python3 deploy_api.py

服务启动后，可以通过 `http://你的设备IP:8080` 访问 API 文档。

功能特性

✨ 核心功能：

🖼️ 智能人像抠图（支持多种模型选择）

📸 一键生成标准证件照（支持多种尺寸规格）

🎨 自定义背景色和美颜处理

📄 生成六寸排版照（方便打印）

🔄 人脸智能对齐和旋转

💾 支持多种输出格式和DPI设置

使用指南

部署完成后，打开浏览器访问 `http://你的设备IP:7860`，即可看到友好的Web界面。上传你的照片，选择所需的证件照尺寸和背景色，点击处理按钮，几秒钟内即可获得专业的证件照。

所有处理都在本地完成，无需上传到云端，保护你的隐私。

本篇教程到此结束，祝你使用愉快！🎉

一键生成专业证件照 HivisionIDPhotos 离线智能制作工具 支持多种规格自定义背景