photoprism/pro

PhotoPrism® Pro Docker镜像文档

1. 镜像概述和主要用途

本Docker镜像专门用于安装和运行PhotoPrism® Pro，是一款专业级照片管理解决方案。请注意，使用此镜像必须具备有效的PhotoPrism® Pro客户账户以完成激活，未激活状态下无法正常使用。

商标与条款声明：PhotoPrism®是注册商标。使用本软件及相关服务即表示您同意遵守服务条款、隐私政策和行为准则。文档采用CC BY-NC-SA 4.0许可发布，可能适用https://github.com/photoprism/photoprism/blob/develop/assets/README.md%E3%80%82

2. 核心功能和特性

PhotoPrism® Pro提供专业级照片管理能力，核心功能包括（具体以官方最新说明为准）：

• 高级媒体组织：AI驱动的自动分类、标签生成与内容识别
• 多维度搜索：支持按时间、位置、人物、场景等精准检索
• 扩展存储支持：兼容本地存储、网络存储及云存储服务
• 团队协作：多用户权限管理与共享相册功能
• 数据安全：加密存储与备份机制，保障媒体资产安全

详细功能对比可参考官方Pro版本说明。

3. 使用场景和适用范围

适用场景

• 个人用户需要专业级照片管理与高级功能支持
• 小型团队/工作室的媒体资产协作管理
• 对照片分类、检索效率有高要求的专业场景

适用范围

• 已注册并拥有有效PhotoPrism® Pro客户账户的用户
• 具备Docker环境部署能力的服务器或工作站
• 满足PhotoPrism® Pro系统要求的硬件配置（建议参考官方最低配置）

4. 使用方法和配置说明

4.1 前提条件

• 已获取PhotoPrism® Pro客户账户（注册方式：联系官方）
• 安装Docker Engine（推荐20.10+版本）
• 确保网络通畅（用于激活验证和功能更新）

4.2 Docker部署示例

4.2.1 基础运行命令

bash
docker run -d \
  --name photoprism-pro \
  --restart unless-stopped \
  -p 2342:2342 \
  -v /path/to/your/photos:/photoprism/originals \
  -v /path/to/your/config:/photoprism/config \
  -v /path/to/your/cache:/photoprism/cache \
  -e PHOTOPRISM_LICENSE_KEY="YOUR_LICENSE_KEY" \
  -e PHOTOPRISM_ADMIN_USER="your-admin-email" \
  -e PHOTOPRISM_ADMIN_PASSWORD="your-secure-password" \
  photoprism/pro:latest

4.2.2 参数说明

4.3 激活与初始化

1. 容器启动后，访问 http://主机IP:2342 进入Web界面
2. 使用配置的管理员***和密码登录
3. 系统自动验证许可证密钥，完成激活
4. 按向导完成初始设置（如照片库索引、偏好配置等）

5. 注意事项

• 激活限制：镜像仅支持PhotoPrism® Pro，未激活或非Pro账户无法使用
• 许可证管理：许可证密钥与客户账户绑定，请勿泄露或共享
• 数据备份：建议定期备份照片存储目录及配置文件，防止数据丢失
• 条款合规：使用即表示同意遵守PhotoPrism®的服务条款及相关政策

更多配置细节请参考官方Pro文档。