PhotoPrism：用照片浏览你的生活

PhotoPrism® 是一款基于人工智能的照片应用，专为 去中心化网络 打造。它利用最新技术自动标记和搜索照片，同时不会干扰你的日常使用。你可以在家中、私有服务器上或云端运行它。

想要先体验一下？欢迎试用我们的 公开演示版。请注意不要上传任何隐私、非法或冒犯性的图片。

功能概览

我们的使命是提供最用户友好且注重隐私的解决方案，帮助你整理并随时访问自己的照片。 因此，PhotoPrism 从零开始构建，旨在无论你在何处都能运行，同时不牺牲自由、隐私或功能：

• 浏览 所有照片，无需担心 RAW 格式 或 视频格式
• 无论你使用手机、平板还是桌面电脑，我们直观的 PWA 应用都能提供原生应用般的体验，并可轻松 安装到主屏幕 上。
• 使用 强大的搜索过滤器 快速找到特定照片和视频，这些过滤器可以组合使用，并适用于多种属性，包括 标签、位置、分辨率、颜色、黑白 以及 质量 等。
• 根据内容和位置 自动为照片添加标签，并识别 家人和朋友的脸部。
• 实况照片 在你将鼠标悬停在其上方时（例如在卡片视图中搜索 type:live）以及观看幻灯片播放时会自动播放。
• 六张高分辨率的 世界地图 和我们的 保护隐私的地理编码服务 可以帮助你重温旅行的美好回忆，探索世界各地。
• 支持从 Exif、XMP 以及其他来源（如 Google Photos）提取并合并元数据。
• 可以使用兼容的应用程序（如 PhotoSync），在后台备份 iOS 和 Android 手机。
• WebDAV 客户端，例如 微软的 Windows 资源管理器 和 苹果的 Finder，可以直接 连接到 PhotoPrism。这样你就可以像操作本地文件一样，在电脑上打开、编辑和删除文件。

作为一家完全 自筹资金且独立的公司，我们承诺绝不会 出售你的数据，并且会始终对我们的软件和服务保持 透明度。除非你主动将文件上传至谷歌、亚马逊、微软或苹果的服务，否则你的数据绝不会被共享给这些公司。🔒

开始使用

关于我们自托管 社区版 的分步 安装说明 可以在 docs.photoprism.app 上找到——你只需要一个网页浏览器和 Docker 来运行服务器即可。该版本支持 Mac、Linux 和 Windows 系统。

稳定版 和 开发预览版 均以 多架构镜像 的形式提供，适用于 64 位 AMD、Intel 和 ARM 处理器。这意味着，树莓派 和 Apple Silicon 用户也能享受到完全相同的功能，并遵循相同的 安装步骤。

如需了解其他安装方式，请参阅我们的 入门常见问题解答，例如使用我们提供的 tar.gz 包。

支持我们的使命 💎

PhotoPrism 完全由自筹资金运营，保持独立。 您的持续支持有助于我们向公众提供更多功能，发布定期更新，并始终保持独立！

我们的会员可以享受额外功能，包括访问交互式世界地图，并可加入我们的私人聊天室，与我们的团队交流。目前我们提供以下会员选项：

• 您可以直接在我们的网站上注册，并通过 Stripe 使用信用卡或 SEPA 付款，无需绑定外部账户，并且可以随时轻松升级或降级。
• 或者，您也可以通过Patreon使用 PayPal、其他货币支付，并为所有等级选择按月或按年计费。

如果您目前通过Github Sponsors支持我们，您还可以在我们的网站上注册，然后点击“激活 Github Sponsors 会员”按钮来绑定您的账户。有关此操作以及如何绑定 Patreon 账户的详细信息，请参阅我们的激活指南。

如需更改信息、咨询会员相关问题或洽谈商业合作，欢迎随时联系我们。

查看会员常见问题 › 立即注册 ›

您的支持为何如此重要

• 您的持续支持帮助我们定期发布更新并保持独立，从而实现我们的使命，保护您的隐私。
• 稳定的资金来源是快速推出您和其他社区成员所请求的新功能的关键。
• 由于我们完全自筹资金且独立运营，我们可以郑重承诺绝不会出售您的数据，并始终对我们的软件和服务保持透明。

如果您喜欢这个项目，也请在 GitHub 上留下一颗星。这将为我们继续前进提供额外的动力。

衷心感谢所有现任及过往的赞助者，你们慷慨的支持一直是项目成功不可或缺的力量！

查看赞助者 › 查看致谢 ›

获取支持

访问docs.photoprism.app/user-guide，了解如何同步、整理和分享您的照片。如果您在家安装软件时遇到困难，欢迎在Github Discussions中发帖提问，或在我们的社区聊天室中寻求帮助。

对于常见问题，您可以使用我们的故障排除清单快速诊断并解决。符合条件的会员也可通过电子邮件向我们发送技术问题和建议。

即将推出的特性和改进

我们的项目路线图展示了当前正在进行的任务以及接下来将实现的功能。欢迎您为喜欢的想法点赞，让我们了解哪些内容最受欢迎。

请注意，我们实行零错误政策，竭尽全力帮助用户解决问题或解答疑问。然而，这也意味着我们无法给出新功能的确切发布时间。我们的团队收到的需求远远多于能够实现的数量，因此我们强调，我们并无义务实施您所请求的功能、改进或其他变更。尽管如此，我们非常重视您的反馈，并会认真考虑每一条建议。

由于稳定的资金来源是快速推出新功能的关键，我们诚挚地邀请您通过注册个人会员或购买商业许可来支持我们的使命。

成为会员 ›

GitHub Issues ⚠️

我们恳请您不要通过 GitHub Issues 报告 bug，除非您确定发现了一个完全可复现且此前未被报告过的问题，并且该问题必须直接在应用中修复。感谢您的理解与配合！

• 浏览问题时，请注意，每当有新评论添加时，我们的团队和所有订阅者都会收到 GitHub 发送的邮件通知，因此这些问题仅应用于分享重要信息，而不应被用于讨论、提问或表达个人观点。
• 为了便于我们调查新的 bug 报告，报告中必须包含完整的复现步骤、所使用的软件版本，以及问题发生环境的相关信息，例如浏览器类型、版本、插件、操作系统、存储类型、处理器类型和内存大小。
• 如果您需要帮助，或者问题可能是本地配置错误、对软件工作方式存在误解，请直接联系我们或联系社区成员。
• 这样做不仅能使我们有机会改进文档，提供一流的客户支持，还能避免处理模糊或重复的 bug 报告，以及因回复评论而引发大量通知的情况。

与社区互动

在 Mastodon 或 Bluesky 上关注我们，或加入 社区聊天，以获取最新动态、与其他用户交流并分享您的想法。我们的 行为准则 阐述了与社区成员互动时的“可为”与“不可为”。

作为 贡献者，如果您有不便公开讨论的事情，也欢迎直接 联系我们。请注意，由于我们收到的邮件数量众多，团队可能无法立即回复您。我们会尽力在五个工作日内或更短时间内给予答复。

每一份贡献都至关重要

我们欢迎任何形式的 贡献，包括博客文章、教程、翻译、测试、编写文档以及提交拉取请求。我们的 开发者指南 包含您开始参与所需的所有信息。

---

PhotoPrism® 是一项 注册商标。使用我们提供的软件和服务，即表示您同意我们的 服务条款、隐私政策 和 行为准则。文档依据 CC BY-NC-SA 4.0 许可证 提供；额外条款 可能适用。

PhotoPrism 快速上手指南

PhotoPrism 是一款基于 AI 的自托管照片管理应用，支持自动标签、人脸识别和地理位置标记。它完全运行在本地，保护隐私，适合家庭或个人服务器部署。

环境准备

系统要求

• 操作系统：Linux、macOS 或 Windows（需支持 Docker）
• 架构支持：64 位 AMD、Intel 或 ARM（包括 Raspberry Pi 和 Apple Silicon）
• 内存：建议至少 4GB RAM（处理大量照片时建议 8GB+）
• 存储：根据照片库大小预留足够磁盘空间

前置依赖

• Docker
• Docker Compose（通常随 Docker 桌面版一起安装）

国内加速提示：如果拉取 Docker 镜像较慢，可配置国内镜像加速器（如阿里云、腾讯云、网易云等）。以阿里云为例：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://<your-id>.mirror.aliyuncs.com"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

安装步骤

1. 创建项目目录

   mkdir -p ~/photoprism && cd ~/photoprism
   

2. 下载官方 Docker Compose 配置文件

   curl -L https://dl.photoprism.app/pkg/docker-compose.yml -o docker-compose.yml
   

   若无法访问，可手动创建 docker-compose.yml，内容参考官方文档。

3. 设置管理员密码 编辑 docker-compose.yml，找到 PHOTOPRISM_ADMIN_PASSWORD，修改为强密码：

   environment:
     PHOTOPRISM_ADMIN_PASSWORD: "your_secure_password"
   

4. 启动服务

   docker compose up -d
   

5. 验证运行状态

   docker compose ps
   

   确保 photoprism 容器状态为 Up。

基本使用

1. 访问 Web 界面
   打开浏览器，访问：

   http://localhost:2342
   

   使用用户名 admin 和你设置的密码登录。

2. 导入照片
   将照片放入宿主机的原始照片目录（默认映射为 ./originals）：

   mkdir -p ~/photoprism/originals
   cp -r /path/to/your/photos ~/photoprism/originals/
   

   PhotoPrism 会自动索引并分析新照片（首次可能需要几分钟）。

3. 体验核心功能

   • 在“探索”中查看 AI 自动生成的标签（如“海滩”、“狗”）
   • 在“人物”中查看识别出的人脸
   • 在“地图”中按地理位置浏览照片
   • 使用搜索栏组合筛选条件，例如：color:blue label:mountain

4. 可选：安装为 PWA
   在浏览器中点击地址栏旁的“安装”按钮，即可将 PhotoPrism 添加为桌面或手机主屏应用，获得原生体验。

注意：所有数据均存储在本地，不会上传至任何第三方云服务。