CyberMind-FR
ccfb58124c
Add complete French (fr) and Chinese (zh) translations for all documentation: - Root files: README, CHANGELOG, SECURITY, BETA-RELEASE - docs/: All 16 core documentation files - DOCS/: All 19 deep-dive documents including embedded/ and archive/ - package/secubox/: All 123+ package READMEs - Misc: secubox-tools/, scripts/, EXAMPLES/, config-backups/, streamlit-apps/ Total: 346 translation files created Each file includes language switcher links for easy navigation between English, French, and Chinese versions. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
121 lines
2.8 KiB
Markdown
121 lines
2.8 KiB
Markdown
[English](README.md) | [Francais](README.fr.md) | 中文
|
||
|
||
# SecuBox PhotoPrism
|
||
|
||
自托管的 Google Photos 替代方案，具有 AI 驱动的功能，在 LXC 容器中运行。
|
||
|
||
## 功能特性
|
||
|
||
- **AI 人脸识别** - 自动检测和分组人脸
|
||
- **物体检测** - 按物体、场景、颜色搜索照片
|
||
- **地点/地图** - 在世界地图上查看照片
|
||
- **全文搜索** - 搜索所有元数据
|
||
- **相册和分享** - 组织和分享收藏
|
||
- **RAW 支持** - 处理相机 RAW 文件
|
||
- **视频播放** - 带转码的视频流
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
# 安装 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
|
||
|
||
### 触发索引
|
||
|
||
添加照片后，运行索引：
|
||
|
||
```bash
|
||
photoprismctl index
|
||
```
|
||
|
||
## 公开暴露
|
||
|
||
使用 HAProxy + SSL 将相册暴露到互联网：
|
||
|
||
```bash
|
||
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 中
|
||
- 容器以有限权限运行
|