photoprism/photoprism

PhotoPrism – AI 驱动的个人照片管理工具

产品简介 – PhotoPrism 是一款开源的自托管 Web 应用程序，让您可以浏览、整理和分享您的照片和视频。它使用设备端机器学习模型自动标记图像、识别面部并提取元数据，同时确保您的数据隐私。

核心功能

• 自动标签 – 深度学习模型分析图像内容并添加描述性标签（例如：dog, beach, sunset）和位置信息。
• 人脸识别 – 检测并分组面部，以便您可以快速找到家人或朋友的照片。
• 强大的搜索 – 结合标签、日期、位置、分辨率、颜色、质量等过滤器，在几秒钟内定位任何媒体文件。
• RAW 与视频支持 – 无需转换即可处理原始相机文件和多种视频格式。
• 渐进式 Web 应用 (PWA) – 可在桌面端、平板电脑或手机上运行；可以像原生应用一样安装。
• 同步与编辑 – WebDAV、PhotoSync 及其他兼容应用可以让您备份移动设备并直接从电脑编辑文件。
• 隐私至上 – 所有 AI 处理均在本地（或您自己的服务器上）运行；除非您主动选择，否则数据不会发送到第三方云服务。

工作原理（高层级）

1. 摄取 (Ingestion) – 您将 PhotoPrism 指向一个文件夹（或通过 WebDAV/PhotoSync 同步）。它会扫描文件、提取 EXIF/XMP 元数据并存储缩略图。
2. 索引 (Indexing) – 内置的基于 TensorFlow 的模型会分析每张图像，生成标签和面部嵌入。
3. 搜索索引 – 标签、位置、时间戳、颜色等被存储在可搜索的数据库（SQLite/PostgreSQL）中。

• Web UI / PWA – 前端 (Vue.js) 查询索引并在响应式图库中展示结果。

入门指南

• 前提条件 – Docker (或 Docker-Compose) 和 Web 浏览器。该项目为 AMD64、ARM64 和 Raspberry Pi 提供多架构 Docker 镜像。
• 典型安装 – docker run -p 2342:2342 -v /path/to/pictures:/photoprism/storage photoprism/photoprism:latest（完整 compose 文件和环境变量请参阅官方文档）。
• 其他方式 – 下载适用于 Linux/macOS/Windows 的 tar.gz 软件包并运行捆绑的二进制文件。

典型使用场景

• 希望在不放弃隐私的情况下获得 AI 辅助整理功能的家庭个人照片存档。
• 需要在本地拥有可搜索媒体库的小型企业或摄影爱好者。
• 任何想要寻找 Google Photos 等云服务自托管替代方案的用户。

局限性 / 注意事项

• AI 模型是预训练的；它们对常见物体和面部效果良好，但可能会遗漏小众类别。
• 对于大型库，初始索引可能会消耗大量 CPU；配备高性能 CPU（或可选的 GPU 支持）可以提高速度。
• 免费社区版缺少部分高级功能（交互式世界地图、私人支持），这些功能仅向付费会员开放。
• 没有内置的协作编辑功能——更改仅保存在服务器实例本地。

了解更多

• 完整文档：https://docs.photoprism.app/
• 公开演示（只读）：https://try.photoprism.app/
• 社区聊天和讨论链接列在 README 中。

---

PhotoPrism 根据 AGPL-3.0 许可证发布；文档采用 CC BY-NC-SA 4.0 许可。