animcogn/face_recognition

人脸识别Docker镜像文档

镜像概述

本镜像基于https://github.com/ageitgey/face_recognition%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BA%BA%E8%84%B8%E8%AF%86%E5%88%AB%E5%8A%9F%E8%83%BD%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8C%96%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E3%80%82%E6%94%AF%E6%8C%81CPU%E5%92%8CGPU%E4%B8%A4%E7%A7%8D%E8%BF%90%E8%A1%8C%E7%8E%AF%E5%A2%83%EF%BC%8C%E5%B9%B6%E5%8C%85%E5%90%AB%E9%9B%86%E6%88%90Jupyter%E7%9A%84%E7%89%88%E6%9C%AC%EF%BC%8C%E4%BE%BF%E4%BA%8E%E5%9C%A8Kubeflow%E5%B9%B3%E5%8F%B0%E9%83%A8%E7%BD%B2%E6%88%96%E6%9C%AC%E5%9C%B0%E4%BA%A4%E4%BA%92%E5%BC%8F%E5%BC%80%E5%8F%91%E3%80%82

标签说明

CPU镜像

• https://github.com/corbanvilla/face_recognition/blob/docker-refactor/docker/cpu/Dockerfile
• https://github.com/corbanvilla/face_recognition/blob/docker-refactor/docker/cpu-jupyter-kubeflow/Dockerfile

GPU镜像

• https://github.com/corbanvilla/face_recognition/blob/docker-refactor/docker/gpu/Dockerfile
• https://github.com/corbanvilla/face_recognition/blob/docker-refactor/docker/gpu-jupyter-kubeflow/Dockerfile

核心功能与特性

• 多环境支持：提供CPU和GPU版本，满足不同性能需求
• 开箱即用：CPU镜像无需额外驱动，直接运行
• Jupyter集成：包含Jupyter版本，支持交互式开发
• Kubeflow兼容：Jupyter镜像专为Kubeflow平台部署设计
• 基于成熟项目：核心功能来自face_recognition项目，具备稳定的人脸识别能力

使用场景

• 本地人脸识别应用开发与测试
• 无GPU环境下的轻量级人脸识别任务
• 需要GPU加速的大规模人脸识别处理
• Kubeflow平台上的机器学习工作流集成
• 人脸识别算法原型验证与演示

使用方法

CPU镜像使用

CPU镜像无需任何驱动前置条件，可直接运行：

bash
# 基本运行
docker run -it --rm docker.xuanyuan.run/corbanvilla/face_recognition:cpu

# 挂载本地目录（例如人脸识别数据）
docker run -it --rm -v /本地数据目录:/app/data docker.xuanyuan.run/corbanvilla/face_recognition:cpu

GPU镜像使用

前提条件

使用GPU镜像需先安装以下组件：

• https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#nvidia-drivers
• https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#setting-up-nvidia-container-toolkit
• https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/user-guide.html#daemon-configuration-file

运行命令

bash
# 基本GPU运行
docker run -it --rm --gpus all docker.xuanyuan.run/corbanvilla/face_recognition:gpu

# 挂载数据并指定GPU数量
docker run -it --rm --gpus 2 -v /本地数据目录:/app/data docker.xuanyuan.run/corbanvilla/face_recognition:gpu

Jupyter镜像使用

Jupyter镜像主要设计用于Kubeflow部署，但也可作为普通Jupyter实例运行：

bash
# CPU Jupyter运行（映射8888端口）
docker run -it --rm -p 8888:8888 docker.xuanyuan.run/corbanvilla/face_recognition:cpu-jupyter-kubeflow

# GPU Jupyter运行
docker run -it --rm --gpus all -p 8888:8888 docker.xuanyuan.run/corbanvilla/face_recognition:gpu-jupyter-kubeflow

运行后，根据容器输出的URL（包含token）在浏览器中访问Jupyter界面。对于Kubeflow部署，可直接将镜像用于Notebook Server配置。