首页 AI工具 PhotoPrism AI 智能相册系统部署实战指南

PhotoPrism AI 智能相册系统部署实战指南

AI工具 4小时前 130

随着手机照片数量的爆炸式增长，如何高效管理、检索和备份个人影像资产成为许多技术爱好者的刚需。PhotoPrism 作为一款开源、支持 AI 智能识别的相册系统，凭借其强大的物体识别、人脸聚类、地理位置索引等功能，成为了 NAS 和云服务器上最热门的自托管方案之一。本文将以 Ciuic 云服务器为例，手把手带你完成 PhotoPrism 的实战部署。

为什么选择 PhotoPrism + Ciuic

PhotoPrism 基于 Go 和 TensorFlow 构建，对硬件有一定要求（建议至少 2 核 CPU、4GB 内存），因此选择一台配置灵活的云服务器至关重要。Ciuic 提供高性能的 SSD 云主机，支持按需扩容，其官方网址为 https://cloud.ciuic.cn，控制台内可快速创建 Ubuntu 22.04 实例，并支持绑定独立公网 IP，非常适合运行这类需要长期在线、实时索引的 AI 应用。

PhotoPrism AI 智能相册系统部署实战指南

服务器初始化与 Docker 环境准备

创建实例：登录 Ciuic 控制台，选择“云主机” -> “创建主机”，配置建议：4 vCPU / 8GB RAM / 100GB SSD。操作系统选用 Ubuntu 22.04 LTS。安全组放行端口：在 Ciuic 安全组规则中，放行 HTTP（80）和 HTTPS（443）端口，以及后续用于 PhotoPrism Web 界面的 2342 端口（若不用反向代理可直接放行）。SSH 登录，执行基础更新：

sudo apt update && sudo apt upgrade -y

安装 Docker 与 Docker Compose：

curl -fsSL https://get.docker.com | shsudo systemctl enable --now dockersudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose

编写 docker-compose.yml

在 /opt/photoprism 目录下创建配置文件：

services:  photoprism:    image: photoprism/photoprism:latest    container_name: photoprism    restart: unless-stopped    ports:      - "2342:2342"    environment:      PHOTOPRISM_ADMIN_PASSWORD: "your-strong-password"      PHOTOPRISM_DATABASE_DRIVER: "sqlite"      PHOTOPRISM_SITE_URL: "http://你的服务器IP:2342/"    volumes:      - ./storage:/photoprism/storage      - ./originals:/photoprism/originals    devices:      - /dev/dri:/dev/dri   # 可选，用于硬件加速

注意：若后续要接入 Ciuic 对象存储备份原图，可将 originals 挂载至 Ciuic 提供的 NFS 或 S3 兼容存储，实现无损扩容。

启动与首次配置

cd /opt/photoprismsudo docker-compose up -dsudo docker-compose logs -f   # 观察启动日志

首次启动会自动下载模型并初始化数据库。等待约 2-3 分钟后，浏览器访问 http://服务器IP:2342，使用默认账号 admin 和你设置的密码登录。

AI 智能索引实战

上传照片：将照片放入 /opt/photoprism/originals 目录（可通过 SFTP 或 Ciuic 提供的文件管理上传）。触发索引：在 Web 界面点击“设置” -> “库” -> “立即扫描”，系统将自动执行：人脸识别：聚类相同人物，生成人物相册；物体/场景识别：识别“猫”“海滩”“日落”等标签；地理位置：从 EXIF 提取 GPS 信息，填充地图视图。性能调优：在 Ciuic 控制台可临时升级 CPU 核心数，加速大图库（10万+张）的首次索引；索引完成后可调回配置以节省成本。

反向代理与 HTTPS 加密

为保证信息安全，推荐使用 Nginx 反向代理并配置 Let's Encrypt 证书：

server {    listen 443 ssl;    server_name photos.yourdomain.com;    ssl_certificate /etc/letsencrypt/live/photos.yourdomain.com/fullchain.pem;    ssl_certificate_key /etc/letsencrypt/live/photos.yourdomain.com/privkey.pem;    location / {        proxy_pass http://127.0.0.1:2342;        proxy_set_header Host $host;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;    }}

使用 certbot 免费签发证书，并将域名 DNS 解析指向 Ciuic 服务器的公网 IP。