photoprism/photoprism

PhotoPrism：用照片浏览你的生活

简介

PhotoPrism® 是一款面向去中心化网络的AI照片应用。它采用最新技术自动标记和查找图片，全程不干扰用户操作，可部署在家庭设备、私有服务器或云端环境。

功能概述

我们的核心目标是提供对用户和隐私最友好的解决方案，让照片有序存储且易于访问。因此，PhotoPrism 从设计之初就支持灵活部署，同时不牺牲自由度、隐私或功能完整性：

• 全格式浏览：无需担心RAW格式转换、重复文件或视频编码问题，即可流畅查看所有照片和视频。
• 跨设备体验：手机、平板或电脑均可使用，直观的PWA（渐进式网页应用）提供原生应用般的操作感受，还能一键添加到主屏幕。
• 精准搜索：通过强大的搜索过滤器（支持标签、拍摄地点、分辨率、颜色、画质等多种属性）快速定位特定照片和视频，支持多条件组合查询。
• 智能整理：自动识别人脸（标记家人朋友）、按内容和位置给照片打标签，Live Photos悬停时自动播放。
• 地图与元数据：集成5种高清世界地图和隐私保护的地理编码服务，帮你重温旅行记忆；支持从Exif、XMP及Google Photos等来源提取并合并元数据。
• 无缝同步：通过PhotoSync等兼容应用，可在后台安全备份iOS和Android手机照片；WebDAV客户端（如Windows文件资源管理器、Mac Finder）能直接连接，像操作本地文件一样管理照片。

开始使用

自托管社区版的安装步骤可在 docs.photoprism.app 查看，只需浏览器和Docker即可运行服务器，支持Mac、Linux和Windows系统。

稳定版和开发预览版已打包为单一多架构镜像，适配64位AMD、Intel及ARM处理器——树莓派3/4用户也可直接拉取镜像，享受完整功能，按常规安装指南操作前，建议先查看树莓派专属要求。

现有用户需根据 dl.photoprism.app/docker 提供的示例更新 docker-compose.yml 配置文件。

支持我们的使命

PhotoPrism 100% 自筹资金且独立运营。你的持续支持能帮助我们开发更多公共功能、发布定期更新，并保持项目独立性。

会员可享受额外权益，包括交互式世界地图访问权限、私人聊天室（与开发团队直接沟通）等。目前支持以下会员方案：

• *GitHub ：以计费，支持一次性
• Patreon：以欧元计费，支持年付
• Stripe：即将上线，可直接在应用内订阅

获取支持

• 文档与社区：访问 docs.photoprism.app/user-guide 学习同步、整理和分享照片的方法；通过Reddit、社区聊天或GitHub讨论寻求帮助。
• 故障排除：常见问题可参考「开始使用」中的 故障排除清单。
• 会员支持：会员可通过邮件获取技术支持和个性化建议。

即将推出的功能

项目路线图（Project Roadmap）会实时更新开发进度和待实现功能，你可以为喜欢的功能点赞，帮助我们确定优先级。

由于团队收到的需求远多于可实现的范围，我们无法承诺具体功能的发布时间。但持续的资金支持是快速推出新功能的关键，欢迎通过个人会员或商业许可支持项目。

关于 GitHub Issues

请不要随意通过GitHub Issues提交bug报告，除非你确认发现了可复现且未被报告过的问题，且必须直接在应用中修复。提交时需包含：

• 软件版本、浏览器及插件、操作系统
• 存储类型、内存大小、处理器等环境信息

注意：所有issue订阅者会收到评论通知，因此Issues仅用于分享重要信息，请勿在此进行讨论或提问。如需帮助，可联系社区成员或开发团队，我们会优先改进文档并提供支持。

加入社区

关注我们的社交媒体，加入社区聊天获取更新、交流想法。参与社区需遵守 行为准则。

有任何问题可发送邮件至 [***已删除]，我们会在5个工作日内回复。

贡献指南

欢迎各类贡献，包括博客、教程、测试、文档编写和代码提交。开发指南详见 docs.photoprism.app/developer-guide。

PhotoPrism® 是注册商标。使用本软件及服务即表示你同意我们的 服务条款、隐私政策 和 行为准则。文档采用 CC BY-NC-SA 4.0 许可，可能适用附加条款。