PhotoPrism Demo Image 技术文档

镜像概述和主要用途

PhotoPrism® 是一款面向去中心化网络的AI驱动照片应用。它利用最新技术自动标记和查找图片，无需人工干预，可部署于家庭环境、私有服务器或云端。

Demo镜像（demo.photoprism.app）旨在提供快速体验环境，帮助用户直观了解PhotoPrism的核心功能和界面操作。

核心功能和特性

• AI自动标记：通过人工智能技术自动识别照片中的人物、物体、场景等元素并生成标签
• 智能搜索：基于标签、时间、位置等多维度快速查找图片
• 去中心化部署：支持本地服务器、私有云或家庭设备部署，数据完全自主掌控
• 跨平台兼容：可在Linux、macOS、Windows等系统通过Docker运行
• 用户友好界面：直观的Web界面，支持相册管理、分类浏览、幻灯片播放等功能

使用场景和适用范围

• 个人照片管理：整理本地相册，实现自动化分类和快速检索
• 家庭共享：家庭私有服务器部署，多人共享照片库（Demo版暂不支持多用户）
• 功能演示：快速展示PhotoPrism的AI标记和搜索能力，适合开发者或潜在用户评估
• 临时体验：无需复杂配置，通过Demo镜像或公共演示链接即时体验核心功能

使用方法和配置说明

1. 公共Demo访问（推荐）

无需本地部署，直接通过浏览器访问官方公共Demo：
[***]

注意：公共Demo仅供体验，请勿上传私人或敏感图片。

2. 本地Docker部署

2.1 基本运行命令（Docker）

docker run -d \
  --name photoprism-demo \
  -p 8080:2342 \
  --rm \
  demo.photoprism.app

• 参数说明：
  • -d：后台运行容器
  • --name photoprism-demo：指定容器名称
  • -p 8080:2342：映射容器内端口2342到本地8080（Web访问端口）
  • --rm：容器停止后自动删除

2.2 Docker Compose配置示例

创建docker-compose.yml文件：

version: '3.8'

services:
  photoprism-demo:
    image: demo.photoprism.app
    container_name: photoprism-demo
    ports:
      - "8080:2342"  # 本地端口:容器端口
    restart: unless-stopped
    environment:
      - PHOTOPRISM_DEMO=true  # 启用Demo模式
      - PHOTOPRISM_DEBUG=false  # 禁用调试日志

启动命令：

docker-compose up -d

3. 访问和使用

部署完成后，通过浏览器访问 http://localhost:8080 进入Demo界面。默认提供示例照片库，可体验以下操作：

• 浏览自动分类的相册
• 使用搜索框按标签（如“dog”“mountain”）查找图片
• 查看照片详情和AI生成的标签

4. 默认配置说明

• 端口：容器内默认使用2342端口
• 存储：Demo模式下数据仅保存在容器内，重启后重置（非持久化）
• 权限：默认禁用用户认证，无需登录即可访问

5. 注意事项

• Demo环境仅用于功能体验，不保证数据安全性，禁止上传私人或敏感图片
• 性能受宿主机配置影响，低配置设备可能出现加载延迟
• 如需生产环境使用，需部署正式版镜像并配置持久化存储

版权和条款

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

参考链接

• 官方文档
• 社区讨论
• GitHub代码库