PhotoPrism：自托管 AI 照片管理库 Docker Compose 部署与使用指南

PhotoPrism 是一个 AI 驱动、隐私优先的自托管照片与视频管理应用，可自动按内容和地点打标签、识别人脸、识别 RAW 与视频格式，并提供强大的组合搜索过滤，适合在自己的服务器上搭建私人相册。

一、项目官方信息

二、官方图片

PhotoPrism 桌面搜索界面：

三、环境要求

• Docker 与 Docker Compose（官方推荐）；
• 64 位 AMD/Intel/ARM 处理器（支持树莓派、Apple Silicon）；
• 一台可长期运行的服务器，足够的磁盘存放照片与索引；
• 一个现代浏览器访问 Web UI。

四、部署步骤（Docker Compose）

1. 准备目录

mkdir -p ~/photoprism/storage ~/photoprism/photos
cd ~/photoprism

2. 创建 docker-compose.yml

services:
  photoprism:
    image: photoprism/photoprism:latest
    ports:
      - "2342:2342"
    environment:
      PHOTOPRISM_ADMIN_USER: "admin"
      PHOTOPRISM_ADMIN_PASSWORD: "your-insecure-password"
      PHOTOPRISM_ORIGINALS_PATH: "/photoprism/originals"
      PHOTOPRISM_STORAGE_PATH: "/photoprism/storage"
    volumes:
      - "./photos:/photoprism/originals"
      - "./storage:/photoprism/storage"
    restart: unless-stopped

3. 启动

docker compose up -d

4. 访问

打开浏览器访问 http://服务器IP:2342，用上面设置的管理员账号密码登录。

五、使用方法

导入与索引

把照片放进 photos/ 目录（即容器内 /photoprism/originals），PhotoPrism 会自动索引：读取 Exif/XMP 元数据、识别内容、生成缩略图、识别地点与人脸。也可在 Web UI 里手动触发重新索引。

浏览与搜索

• 按时间线浏览全部照片；
• 用组合搜索过滤：标签、地点、分辨率、颜色、质量等；
• Live Photos 悬停自动播放；
• 世界地图按拍摄地点浏览照片。

相册与分享

• 创建相册组织照片；
• 分享链接给他人；
• 通过 WebDAV 客户端（Windows 资源管理器、macOS Finder）直接连接，像本地盘一样打开/编辑/删除文件。

六、常见问题 FAQ

Q1：PhotoPrism 是什么？ 自托管 AI 照片管理库，自动标签、人脸识别、组合搜索、世界地图。

Q2：怎么部署？ 官方推荐 Docker Compose，启动后访问 2342 端口。

Q3：默认端口是多少？ 2342。

Q4：照片放在哪里？ 挂载到容器内 /photoprism/originals，PhotoPrism 会自动索引。

Q5：支持 RAW 吗？ 支持，可浏览各种 RAW 图片与视频格式。

Q6：手机照片怎么备份进来？ 可用 PhotoSync 等兼容 App 后台备份，或通过 WebDAV 连接。

七、跳转链接

• GitHub 仓库：https://github.com/photoprism/photoprism
• 官方文档：https://docs.photoprism.app
• 在线演示：https://try.photoprism.app
• Docker 镜像：https://hub.docker.com/r/photoprism/photoprism