secubox-openwrt/package/secubox/secubox-app-photoprism/README.zh.md

English | Francais | 中文

SecuBox PhotoPrism

自托管的 Google Photos 替代方案，具有 AI 驱动的功能，在 LXC 容器中运行。

功能特性

• AI 人脸识别 - 自动检测和分组人脸
• 物体检测 - 按物体、场景、颜色搜索照片
• 地点/地图 - 在世界地图上查看照片
• 全文搜索 - 搜索所有元数据
• 相册和分享 - 组织和分享收藏
• RAW 支持 - 处理相机 RAW 文件
• 视频播放 - 带转码的视频流

快速开始

# 安装 PhotoPrism（创建 LXC 容器）
photoprismctl install

# 启动服务
/etc/init.d/photoprism start

# 访问相册
http://192.168.255.1:2342

CLI 命令

命令	描述
install	创建带 PhotoPrism 的 LXC 容器
uninstall	删除容器（保留照片）
start/stop/restart	服务生命周期
status	RPCD 的 JSON 状态
logs [N]	显示最后 N 行日志
shell	打开容器 shell
index	触发照片索引
import	从收件箱文件夹导入
passwd [pass]	重置管理员密码
backup	创建数据库备份
configure-haproxy <domain>	设置 HAProxy + SSL
emancipate <domain>	完整公开暴露

照片管理

添加照片

1. 直接复制：将文件复制到 /srv/photoprism/originals/
2. 导入收件箱：复制到 /srv/photoprism/import/，运行 photoprismctl import
3. WebDAV：在 PhotoPrism 设置中启用 WebDAV

触发索引

添加照片后，运行索引：

photoprismctl index

公开暴露

使用 HAProxy + SSL 将相册暴露到互联网：

photoprismctl emancipate photos.example.com

这将配置：

• 带 Let's Encrypt SSL 的 HAProxy vhost
• mitmproxy WAF 路由
• DNS 记录（如果 dnsctl 可用）

配置

UCI 配置位于 /etc/config/photoprism：

config photoprism 'main'
    option enabled '1'
    option http_port '2342'
    option memory_limit '2G'

config photoprism 'features'
    option face_recognition '1'
    option object_detection '1'
    option places '1'

资源要求

• 内存：推荐 2GB（最低 1GB）
• 存储：容器约 500MB + 您的照片
• CPU：AI 索引是 CPU 密集型的

LuCI 仪表板

访问路径：服务 > PhotoPrism

功能：

• 状态卡片（照片、视频、存储）
• 启动/停止/索引/导入按钮
• AI 功能开关
• 公开暴露表单

数据路径

路径	内容
/srv/photoprism/originals	您的照片和视频
/srv/photoprism/storage	缓存、缩略图、数据库
/srv/photoprism/import	上传收件箱

安全

• 流量通过 mitmproxy WAF（无绕过）
• 管理员密码存储在 UCI 中
• 容器以有限权限运行