一、前言
大家好，我是攻城狮阿程。有时候需要拍摄上传证件照或者证件照片的底色需要替换，但手头又临时没有PS工具或是拍照工具怎么办，莫慌，今天阿程就给大家带来一款能够智能抠图并生成证件照片的容器应用 —— HivisionIDPhoto，通过它，自己在家也能轻松搞定证件照，而且在本地部署，无需再去网上付费制作证件照。
码字不易，喜欢我的教程欢迎各位多提建议多评论，畅所欲言，涉及破解、打倒美帝走近科学和资源分享的教程容易被和谐，也欢迎各位关注我的公众号和博客，以防走丢。
公众号：攻城狮阿程
知乎：攻城狮阿程
小红书：阿程数码
个人博客：strider1230.cn
淘宝：阿程数码
1.1 软件介绍
HivisionIDPhoto 旨在开发一种实用、系统性的证件照智能制作算法。它利用一套完善的AI模型工作流程，实现对多种用户拍照场景的识别、抠图与证件照生成。
1.2 软件特点
HivisionIDPhoto 有 5 个功能特点：
轻量级抠图（纯离线，仅需 CPU 即可快速推理）
根据不同尺寸规格生成不同的标准证件照、六寸排版照
支持 纯离线 或 端云 推理
美颜
智能换正装（目前该功能还未正式发布）
1.3 部署容器前你可能需要一块固态硬盘
我教程内展示的容器都是配置在固态硬盘上的，建议想多搭容器及虚拟机的朋友在执行教程前先准备一块固态硬盘，容器、虚拟机安装在固态硬盘的好处如下：
不会干扰机械硬盘的休眠，使得机械硬盘始终扮演数据保存的角色
部署在固态硬盘内的容器、虚拟机调用以及响应的速度都比机械硬盘好
容器若发生泄露，不会污染、破坏你的机械硬盘内的数据
1.4 M.2接口 SSD 固态硬盘的适配
Z4系列的M.2接口支持高速存储、只读缓存等功能，如果是要在固态硬盘内部署虚拟机、容器服务等，需要选择高速存储功能；
仅支持M.2接口 NVMe 2280 的SSD固态硬盘，其中2280指的是长度；
官方说由于PCIe4.0自身的兼容性问题，极空间暂时不支持PCIe4.0的SSD，但是实验下来是支持PCIe4.0的固态的，只是安装上去以后该固态硬盘的温度会比PCIe3.0的固态硬盘高10℃左右，因此买的时候要还是建议选择PCIe3.0的SSD；
设置只读缓存时，Z4系列8G-16G内存的产品建议选购256G容量；16G及以上内存的产品建议选购512G容量；（PS：极空间Z4Pro 是支持DDR5 32G 4800MHz的笔记本电脑内存哦）
设置高速存储时，SSD不得小于32GB，最大支持4T；
建议选购大品牌的SSD，这里推荐一个我用了两年的：致钛tiplus5000 1TB/2TB，京东和淘宝上都有货源；
* 请选择耐用 SSD。由于 SSD 的寿命受限于有限的写入次数，请确保使用耐用性更高的 SSD，以防止潜在风险。
1.5 应用截图
1.6 效果图
二、部署 HivisionIDPhoto 容器
2.1 下载 HivisionIDPhoto 官方镜像
2.1.1 通过极空间的 Docker 管理页面拉取（确保镜像源的选择：Docker Hub）
第一步：打开仓库设置界面，确保镜像源选择的是 Docker Hub（Docker Hub打不开的可以去看我的另一篇教程）；
第二步：在左侧边栏选择“镜像”，然后点击“仓库”，接着再点击“自定义拉取”按钮后，点击“自定义拉取”按钮，在弹出的对话框中输入linzeyi/hivision_idphotos拉取镜像，点击拉取，等待拉取完成。
2.1.2 导入其他来源获取的镜像（如极空间用户之间的闪电传）
部分用户可能没有科学上网环境，也不会按上述步骤配置镜像站，导致镜像无法远程拉取，可以通过其他下载途径进行下载，或使用极空间本身提供的闪电传、文件分享功能获取链接下载。
2.2 配置 HivisionIDPhoto 容器
第一步：在本地镜像找到拉取到的镜像，点击添加到容器；
第二步：为了防止极空间突然因停电或升级等原因重启，因此需要勾选上极空间开机后自动启动此容器选项，这里建议勾选调用核心显卡，对照片生成速度会有一定帮助；
第三步：由于本容器无需配置本地文件夹数据存放，因此直接如下图所示配置网络和端口号即可，其中端口号：27860和38080 是我设置的页面高位端口号，软件访问需要使用27860（对应容器端口7860）；
第四步：本项目提供了一些额外的配置项，在环境变量中添加行并填入参数进行设置：
三、 程序测试
3.1 测试登录程序前端页面
使用浏览器打开你极空间的“IP : HivisionIDPhoto 端口号：27860（容器端口默认为7860），能够看到下图所示界面说明 HivisionIDPhoto 已经部署成功。
3.2 测试通过极空间自带的远程登录功能进行访问
第一步：先点击极空间的“远程访问”图标；
第二步：在弹出的对话框中点击“添加新的链接“按钮；
第三步：在弹出的”编辑远程访问“对话框中，备注栏填写：抠图+证件照生成，地址栏填写："你极空间容器的IP地址：27860"，点击“保存”按钮。
四、HivisionIDPhoto 的实操演示（搭配内网穿透使用效果更佳）
① 如下图，红框这里就是图片上传界面，同时注意看下方，它不仅支持本地文件的上传，还支持摄像头直接拍摄以及剪切板复制。
② 上传功能区域的下方是界面语言、人脸检测模型及抠图模型的设置，其中人脸检测模型有两个离线模型一个联网模型，抠图模型提供了四个，个人觉得直接用预设的就好，速度最快，也比较精准，当然大家也可以自行尝试。
在模型下方的设置就是照片的参数调整了，例如要生成证件照的尺寸、背景颜色以及渲染方式，同时在高级参数中可以设置面部比例和头距顶距离，还能美颜、限制图片大小以及添加水印。
右侧红框内是生成预览区域，在生成过程中会显示生成时间花费的时间，同时它提供了标准照、高清照以及六寸的排版照，下面还有抠图的标准照和高清照，满足了你的一切需求。
最后测试了一下Z4Pro性能版的生成速度，CPU为Intel的i3-N305，8核8程3.8GHz的最大频率，核显为UHD。试了一下基本速度在5-15秒左右，抠图的细节也不错，完全可以下载作为证件照使用。
4.5 一些常见问题的解答
Q1：我可以用这个容器应用来制作猫狗宠物证件照吗？
A：不可以，该容器应用在1.2.7版本时可能能够制作宠物证件照，但在最新的1.3.0版本中严格限制了头身比和图像识别（或许你可以试试人面猫头鹰或者狮身人面像）。
Q2：如何修改水印字体？
A：将字体文件放到hivision/plugin/font文件夹下，修改hivision/plugin/watermark.py的font_file参数值为字体文件名。
Q3：我可以在极空间的虚拟机上布置该项目吗？
A：可以，但是没有必要。因为极空间的虚拟机目前仍未开放显卡直通功能，你部署上去就无法享受CPU上的显卡加速了。
五、结语
HivisionIDPhoto 是一个非常好用的容器项目，今年推荐的众多项目中，该项目的质量和实用性绝对可以排在前五。项目在生成途中的CPU占用比较高，同时容器对于内存的要求也挺高，因此个人建议搭建该容器的话NAS处理器至少得是N5105这个级别往上，内存至少有8G以上，所以个人比较推荐用Z4Pro性能版及以上的设备部署。
如果你看完教程还是觉得部署很困难，也可以扫描下方二维码进入我的淘宝小店——阿程数码，直接购买对应的极空间 Docker 服务，我会远程帮你有偿部署。
