手机和相机里攒了几万张照片，想找”去年全家在海边的那张”却只能靠肉眼翻。云相册能做人脸归类，但那是把全家人的脸交给别人。最近在 GitHub 上翻到一个叫 FaceVault 的项目，思路挺直接：把人脸识别整套流程搬回本地，照片不出家门，库里有哪些人就让它自己分。
它是什么
FaceVault 是一个自托管的照片管理系统，2026 年 3 月刚开源，MIT 许可，前端 TypeScript（Next.js 15）、后端 Python（FastAPI）。核心卖点就一句：100% 本地、零云依赖。它用人脸识别库 InsightFace 做检测、用 FAISS 做向量检索和聚类，自动把照片按”人”归堆，不需要你手动打标签。
除了人脸聚类，它还顺手做了几件事：智能去重、上传一张人脸照片就能反过来搜全库里所有有这个人的图、通过二维码邀请链接把相册分享给家人朋友。官方强调所有运算都在你自己的机器上跑，没有第三方账号、没有订阅、没有上传。
为什么值得看
市面上的自托管相册不少，但多数的人脸/语义搜索要么依赖外部 API，要么得自己接机器学习服务。FaceVault 把这条链路封死在本地：InsightFace 首次运行会下载一个约 500MB 的 buffalo_l 模型到本地缓存，之后全部离线。对个人隐私党来说，这意味着你的脸、你家人的脸、你孩子的脸，从始至终没有离开过你的硬盘。
另一个角度是”分享”做得轻。传统相册要开账号才能给别人看，FaceVault 用邀请链接 + 二维码，对方扫码就能进对应相册，后端还能设隐私模式。对有”每年给长辈发一次聚会照”需求的人，比建账号友好。
怎么跑起来
官方给了两种姿势。单机自嗨最省事：
git clone https://github.com/ArshvirSk/FaceVault.git
cd FaceVault/backend
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
# 另开终端
cd ../frontend && npm install && npm run dev前端走 3000 端口，后端 API 在 8000。要是想让家里其他设备也能访问，把后端 API_URL 通过环境变量改成局域网地址就行。GPU 加速不是必须的——默认跑 CPU，想快就替换 onnxruntime 为 onnxruntime-gpu 并装好 CUDA。
注意 Python 版本：作者实测锁定在 3.10.x（3.10.11），用 3.11/3.12 可能踩依赖坑，官方建议老老实实用 3.10 保平安。
有什么坑
先泼盆冷水，别抱太高预期：
项目太新，几乎没社区。 写这篇时 GitHub 上 stars 还是 0，最后一次代码提交停在 2026 年 3 月中旬，半年没动过。这意味着文档可能不全、issue 没人回、踩坑只能自己啃。把它当”尝鲜玩具”可以，别指望当主力相册。
500MB 模型首次必下载。 没有外网或网络慢的环境，第一步就会卡住。模型只下一次，但你要预留空间。
人脸聚类不是 100% 准。 InsightFace 在侧脸、遮挡、童年照上会翻车，聚类结果需要你人工校正。它只是帮你把”疑似同一人”的堆在一起，不是法院级认证。
没有官方 Docker 一键包。 目前得手动起两个服务（后端 + 前端），对纯小白不算友好。想上 NAS 常驻，得自己写 compose 或看护脚本。
适合谁
如果你已经有一台常开的 NAS 或迷你主机，想给家人做个不把脸交出去的私有相册，且愿意花点时间折腾早期项目，FaceVault 是个值得试的方向。它的架构不复杂，代码量也小，真要修 bug 或加功能，比那些几万 commit 的庞然大物容易上手。
反过来，如果你想要开箱即用、社区活跃、移动端同步成熟的方案，那它现在还撑不住。这种项目最怕”开源即停更”，建议先 star 观望，等它活过半年再说。
项目地址：github.com/ArshvirSk/FaceVault（MIT 许可，2026-03 开源）