picpeak/ml
picpeak
picpeak照片分享平台的可选无状态人脸检测Sidecar服务，与picpeak/backend配合使用，检测图像人脸并返回边界框、关键点、质量信号及512维嵌入向量。
下载次数: 0状态：社区镜像维护者：picpeak仓库类型：镜像最近更新：5 小时前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可：
请先阅读并遵守：https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
picpeak — ML sidecar（人脸检测）
picpeak是开源自托管的摄影师专用照片分享平台。本镜像是可选的人脸检测Sidecar服务：检测单张图像中的人脸，返回每个人脸的边界框、5个关键点、质量信号及512维嵌入向量。
无额外功能：无数据库、无卷、无状态、无外发请求、运行时不下载模型。聚类、身份识别等隐私决策均在后端处理，本服务响应后立即遗忘图像内容。不运行此容器则人脸检测功能不可用。
- 📦 源码/文档/问题：https://github.com/PicPeak/picpeak
- 🧩 依赖服务：
picpeak/backend+picpeak/frontend
支持标签
latest/stable：最新稳定版x.y.z：固定版本（生产推荐，需与后端版本一致）beta/main：main分支最新构建（可能不稳定）- 架构：
linux/amd64、linux/arm64
Sidecar的API契约与后端版本绑定，
PICPEAK_CHANNEL在所有picpeak镜像中一致。
启用方法
维护的compose文件已包含此服务，执行以下命令：
bashdocker compose --profile faces up -d
再在应用中完成两个操作：
- 管理员设置中启用
faces功能开关 - 为每个事件开启"在此相册检测人物"选项
开关关闭时后端不会调用此服务，未安装容器的部署不会尝试连接。
配置
| 参数 | 说明 |
|---|---|
FACE_ML_TOKEN | 必填，容器无此参数无法启动，需与后端FACE_ML_TOKEN一致 |
FACE_ORT_THREADS | ONNX Runtime线程数（默认1） |
端口8000，无需暴露端口（后端通过compose网络访问），FACE_ML_URL默认http://picpeak-ml:8000。
API
除/health外均需X-Face-ML-Token头部：
| 端点 | 说明 |
|---|---|
GET /health | 返回{"status":"ok"}（健康检查） |
GET /info | 返回模型信息（detector/embedder等） |
POST /faces | 接收multipart图像，返回人脸数据 |
模型
内置YuNet（检测）+ FaceNet-512（嵌入）模型，均为MIT许可证，构建时通过SHA-256验证，运行时不下载模型，支持离线安装。详见https://github.com/PicPeak/picpeak/blob/main/ml/LICENSES.md。
注意事项
picpeak/aio（一体化镜像）不支持此功能，因单容器中同时运行人脸检测和缩略图生成会导致性能下降，需使用多容器部署。
文档
官方文档：[***]
Sidecar细节：https://github.com/PicPeak/picpeak/blob/main/ml/README.md
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull picpeak/ml:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"
