deface：高效开源视频照片人脸脱敏工具

deface 是什么

deface 是一款专注于人脸匿名化的开源命令行工具。它能够自动识别视频或照片中的人脸，并应用模糊、马赛克等效果进行匿名化处理，生成脱敏后的视频或图片。

核心功能亮点

自动检测人脸，一键完成打码

• 自动检测人脸，无需手动逐帧框选。
• 支持动态画面、多人场景与复杂背景。
• 统一应用匿名化滤镜，快速完成脱敏。

多种匿名化方式可选

• 模糊处理：高斯模糊，适合大多数场景。
• 黑框遮挡：在人脸上叠加实心矩形。
• 马赛克：以网格像素方式处理人脸区域。
• 自定义图片覆盖：使用自定义图片替换人脸区域。
• 支持设置蒙版缩放比例，减少边缘泄露风险。

可调检测阈值，平衡误检与漏检

• 通过调整阈值，减少误检或漏检。
• 支持得分显示，便于测试与调参。

高分辨率媒体的性能优化

• 提供输入下采样选项，提升处理速度。
• 保证缩放比例与原视频的宽高比一致，避免识别精度下降。

硬件加速支持

• 支持使用支持 CUDA 的 Nvidia GPU 进行加速。
• 在部分 Windows 或 CPU 场景下，可结合其他执行后端获得一定程度的加速。

安装方式与环境要求

环境准备

• 操作系统：Linux、Windows 或 macOS。
• Python 版本：3.6 及以上。
• 建议使用虚拟环境隔离依赖。

通过 pip 安装

在已激活的虚拟环境中，运行：

python3 -m pip install deface

或使用 GitHub 最新代码版本：

python3 -m pip install 'git+https://github.com/ORB-HD/deface'

快速上手：一条命令完成视频匿名化

本地视频一键打码

假设原始视频路径为 myvideos/vid1.mp4，执行：

deface myvideos/vid1.mp4

工具会在同目录下生成一个新文件：

myvideos/vid1_anonymized.mp4

默认会对检测到的人脸进行模糊处理，并移除音频轨道。

摄像头实时匿名化演示

如果设备连接了摄像头，可以直接对实时画面进行人脸匿名化预览：

deface cam

等价于对默认摄像头设备执行预览模式，可在隐私敏感场景中用作“实时打码监看”。

典型使用场景

• 研究视频分享时隐藏人脸。
• 教学视频、演示视频中出现路人或敏感人员时进行统一打码。
• 城市街景、商场监控画面剪辑时进行脱敏处理。
• 产品宣传片、活动回顾视频中隐藏未授权出镜者的脸部信息。
• 数据标注、机器学习训练数据准备过程中的隐私保护环节。

开源项目地址

GitHub 项目地址：https://github.com/ORB-HD/deface