基于AI的开源照片管理应用photoprism

PhotoPrism 是一个 基于 AI 的开源照片管理应用，支持自动识别人脸、地点、物体、颜色等，并提供强大的搜索、浏览和组织功能。它可部署在本地服务器、NAS、树莓派或云主机上，完全掌控你的照片数据。

以下是完整使用指南，涵盖安装、配置、导入照片、访问 Web 界面等核心步骤。

一、核心特性（为什么用 PhotoPrism？）

✅ AI 自动打标：识别物体、场景、人脸（支持人脸分组）
✅ 地理定位：从 EXIF 提取位置，显示在交互式世界地图上
✅ 多端访问：Web 浏览器 + PWA（可安装为桌面/手机 App）
✅ 格式支持广：JPEG、PNG、HEIC、RAW（CR2/NEF/ARW 等）、MP4、MOV、Live Photos
✅ 隐私优先：所有处理在本地完成，不上传到任何第三方
✅ 支持 WebDAV：可通过 Finder（Mac）或文件资源管理器（Windows）直接访问照片库

二、快速安装（推荐 Docker Compose）

要求：已安装 Docker 和 Docker Compose

1. 创建项目目录

mkdir -p ~/photoprism/{storage,originals}
cd ~/photoprism

originals/：存放你的原始照片（可挂载外部硬盘/NAS）
storage/：存放数据库、缓存、缩略图等

2. 创建 `docker-compose.yml`

version: '3.9'

services:
  photoprism:
    image: photoprism/photoprism:latest
    container_name: photoprism
    restart: unless-stopped
    ports:
      - "2342:2342"  # Web UI 访问端口
    environment:
      PHOTOPRISM_ADMIN_PASSWORD: "your_secure_password"  # 初始管理员密码
      PHOTOPRISM_ORIGINALS_LIMIT: 5000                   # 最大文件大小 (MB)
      PHOTOPRISM_DISABLE_CHROMA: "false"                 # 启用色彩分析
      PHOTOPRISM_DETECT_NSFW: "true"                     # 标记敏感内容
      PHOTOPRISM_PUBLIC: "false"                         # 是否公开访问
    volumes:
      - ./storage:/var/lib/photoprism/storage
      - ./originals:/photoprism/originals                # 挂载照片目录
    security_opt:
      - seccomp:unconfined
      - apparmor:unconfined

💡 修改 PHOTOPRISM_ADMIN_PASSWORD 为你自己的强密码！

3. 启动服务

docker-compose up -d

等待 1–2 分钟，首次启动会初始化数据库。

三、访问 Web 界面

打开浏览器，访问：

http://你的服务器IP:2342

初始用户名：admin
密码：你在 docker-compose.yml 中设置的 PHOTOPRISM_ADMIN_PASSWORD

首次登录后建议：

进入 Settings → Account 修改邮箱和密码
进入 Library → Import 手动触发照片扫描（或等待自动扫描）

四、导入照片

方法 1：直接放入 `originals/` 目录（推荐）

将照片复制到你挂载的 ./originals 文件夹中
PhotoPrism 会自动后台扫描新文件（默认每小时一次）
也可在 Web 界面点击 Library → Import 手动触发

方法 2：通过 Web 上传

登录后点击右上角 + Upload
支持拖拽上传（适合少量照片）

方法 3：通过 WebDAV（高级用户）

启用 WebDAV 后，可在 Mac Finder 或 Windows 资源管理器中挂载为网络驱动器
配置参考：官方 WebDAV 文档

五、关键配置说明（环境变量）

环境变量	说明	示例
`PHOTOPRISM_ADMIN_PASSWORD`	初始 admin 密码	`"MyPass123!"`
`PHOTOPRISM_PUBLIC`	是否允许未登录访问	`"false"`（私有） / `"true"`（公开相册）
`PHOTOPRISM_DISABLE_FACES`	禁用人脸识别	`"true"`（节省资源）
`PHOTOPRISM_DISABLE_TENSORFLOW`	禁用 AI（仅基础元数据）	`"true"`（低配设备）
`PHOTOPRISM_ORIGINALS_LIMIT`	单文件最大大小（MB）	`5000`
`PHOTOPRISM_SITE_URL`	公网访问地址（用于分享链接）	`"https://photos.yourdomain.com"`

完整配置列表：Environment Variables

六、AI 功能说明

人脸识别：自动聚类“人物”，需手动确认身份（保护隐私）
物体/场景识别：基于 TensorFlow，支持中文标签（如“猫”、“海滩”）
地理位置：从 EXIF 提取 GPS，在地图上显示（支持离线地图）
颜色分析：可按主色调搜索（如 color:red）
质量评分：自动标记模糊/低质照片（便于清理）

💡 AI 模型首次使用时会自动下载（约 100–300 MB），确保网络畅通。

七、移动端使用

在手机浏览器打开 http://IP:2342
点击 菜单 → Install App（Chrome/Safari 支持 PWA）
即可像原生 App 一样使用，支持离线浏览（已加载的缩略图）

八、安全与备份建议

不要将 2342 端口直接暴露公网！建议通过 Nginx 反向代理 + HTTPS（Let's Encrypt）
定期备份 ./storage 目录（包含数据库和设置）
原始照片始终保存在 ./originals，PhotoPrism 不会修改原始文件

九、高级部署选项

场景	方案
树莓派	使用 `photoprism/photoprism:arm64` 镜像，关闭 AI 节省内存
NAS（群晖/QNAP）	通过 Docker 套件部署，挂载照片共享文件夹
公网访问	配置 Nginx + HTTPS + Basic Auth 或 OAuth
无 Docker 安装	下载 tar.gz 包（仅 Linux）

官方资源

官网：https://www.photoprism.app
文档：https://docs.photoprism.app
GitHub：https://github.com/photoprism/photoprism
在线 Demo：https://try.photoprism.app （可体验功能，勿传隐私照片）
社区聊天：https://link.photoprism.app/chat

常见问题

Q：导入很慢？
A：首次导入会生成缩略图和 AI 分析，大图库需数小时。可在 Settings → Library 中调整并发数。

Q：无法识别人脸？
A：进入 Library → People，点击 “Start Analysis”。确保照片清晰且人脸 > 100px。

Q：如何升级？
A：docker-compose pull && docker-compose up -d