PhotoPrism 简介

PhotoPrism^[1] 是一个为去中心化网络设计的AI照片应用，它利用最新技术自动标记和查找图片，实现自动图像分类与本地化部署，你可以在家中、私有服务器或云端运行它。

项目特点

主要特点

• 浏览所有照片和视频，无需担心RAW转换、重复项或视频格式。
• 使用强大的搜索过滤器轻松找到特定图片。
• 识别家人和朋友的面孔。
• 基于内容和位置自动分类图片。
• 在相册和搜索结果中悬停播放Live Photos。
• 用户界面是一个渐进式Web应用，提供类似本地应用的体验，可以安装在所有主流操作系统和移动设备的主屏幕上。
• 包含四个高分辨率的世界地图，带你回顾你最喜欢的旅行记忆。
• 从Exif、XMP和其他来源（如Google Photos）提取和合并元数据。
• 还可以搜索颜色、色度和质量等更多图片属性。
• 使用PhotoSync安全备份iOS和Android手机。
• WebDAV客户端（如Microsoft的Windows资源管理器和Apple的Finder）可以直接连接到PhotoPrism，你可以像操作本地文件一样打开、编辑和删除文件。

使用场景

PhotoPrism 适用于希望在家中或私有服务器上管理照片库的用户，特别是那些重视隐私和数据自主权的用户。

项目使用

PhotoPrism 提供了详细的安装指南^[2]，只需要一个Web浏览器和Docker^[3]即可运行服务器。

它适用于Mac、Linux和Windows系统，详细可参考安装步骤^[4]。以下为使用Docker Compose安装PhotoPrism的步骤如下：

配置环境

• 确保系统已安装Docker，支持Mac、Linux和Windows。
• 可以选择使用Podman Compose作为Red Hat兼容Linux发行版的Docker Compose的替代品。
• 下载compose.yaml配置文件到任意文件夹，并根据需要进行配置。

配置数据库

• 配置文件中包含预配置的MariaDB数据库服务器。如果不提供其他数据库服务器凭证，将创建SQLite数据库文件。
• 确保数据库文件存储在可靠的设备上，避免使用USB闪存盘、SD卡或共享网络文件夹。

配置卷（Volumes）

• 明确指定要挂载的目录，因为PhotoPrism无法访问未共享的文件夹。
• 将/PHOTOPRISM/ORIGINALS、/PHOTOPRISM/STORAGE和/PHOTOPRISM/IMPORT目录配置为持久卷。
• 将原始照片和视频文件的目录挂载到/PHOTOPRISM/ORIGINALS。
• 将配置、缓存、备份、缩略图和侧边文件的目录挂载到/PHOTOPRISM/STORAGE。
• 可选地，挂载一个导入文件夹，用于将文件以结构化方式传输到原始文件夹，避免重复。

启动服务器

• 打开终端，切换到保存配置文件的文件夹。
• 运行docker compose up -d命令以在后台启动应用和数据库服务。
• 访问Web UI，地址为http://localhost:2342/，使用PHOTOPRISM_ADMIN_PASSWORD配置的初始密码登录。

索引库

故障排除

• 如果服务器内存不足或系统资源紧张，可以尝试减少工作进程数量，增加交换空间，或切换到MariaDB数据库。
• 如果遇到其他问题，可以查看故障排除清单或在社区聊天中寻求帮助。

命令行界面

• 使用docker compose exec photoprism photoprism help列出所有命令和配置选项。
• 使用docker compose exec前缀在指定的服务容器中执行命令。

项目资源

• 用户指南^[5]
• 开发者指南^[6]
• 常见问题解答^[7]
• 故障排除清单^[8]
• 社区聊天^[9]
• Mastodon^[10]
• Bluesky^[11]

注：本文内容仅供参考，具体项目特性请参照官方 GitHub 页面的最新说明。

欢迎关注&点赞&在看，感谢你的阅读~