飞牛相册迁移另外一个NAS或者重新安装系统的 简要说明
一、两个重要目录
| 目录 |
作用 |
/volX/@appmeta/trim.photos/ |
缓存数据（缩略图、人脸、AI 索引等） |
/usr/local/apps/@appdata/trim.photos/ |
数据库（照片索引、路径、相册结构） |
两者都要在，相册才完整。只恢复其中一个，可能出现：有缩略图但没索引，或有索引但预览加载失败。
二、@appmeta 里常见子目录
trim.photos/
**── data/
**── thumb/ ← 相册缩略图（列表、时间线预览）
**── face/ ← 人脸识别小图（按人物分组用）
**── ... ← 其他 AI / 索引数据
| 目录 |
是什么 |
举例 |
data/thumb/ |
整张照片的缩小预览 |
相册网格里看到的图 |
data/face/ |
从照片里裁出的人脸小图 |
「人物」相册里的头像 |
**都是 **.jpeg，但用途不同。
三、网页/API 里的图片地址
示例：
http://192.168.2.10:5666/p/api/v1/stream/p/t/140220/s/247120aa-...
| 部分 |
含义 |
5666 |
飞牛统一端口 |
/p/ |
相册应用 |
t |
thumbnail，缩略图 |
140220 |
数据库里的照片 ID |
s/UUID |
登录会话，不是文件路径 |
**实际读的是 **data/thumb/ 里的缓存；没有缓存时，会按 photo.db 里的路径读原图再生成。
四、备份建议
整包备份 trim.photos 文件夹（推荐）：
# 先停相册，再打包
tar -czvf /vol3/1000/备份/trim.photos_日期.tar.gz \
/vol3/@appmeta/trim.photos \
/usr/local/apps/@appdata/trim.photos
注意：
- **大文件不要经 FinalShell 压缩，会临时写到 **
/root/.finalshell/temp/，容易占满系统盘
- 直接在数据盘（如 vol3）打包更安全
五、解压恢复
**若 zip/tar 里是 **整个 trim.photos/ 文件夹，应解压到 @appmeta 上一级：
# ✅ 正确
unzip 相册源数据.zip -d /vol3/@appmeta/
# 得到：/vol3/@appmeta/trim.photos/
# ❌ 错误（会多一层）
unzip 相册源数据.zip -d /vol3/@appmeta/trim.photos/
# 得到：/vol3/@appmeta/trim.photos/trim.photos/
数据库单独恢复示例：
cp -a /vol2/1000/备份/trim.photos/trim.photos \
/usr/local/apps/@appdata/trim.photos
chown -R root:root /usr/local/apps/@appdata/trim.photos/
rm -f /usr/local/apps/@appdata/trim.photos/db/photo.db-wal
rm -f /usr/local/apps/@appdata/trim.photos/db/photo.db-shm
六、恢复后检查
ls /vol3/@appmeta/trim.photos/data/thumb/ # 应有缩略图
ls /vol3/@appmeta/trim.photos/data/face/ # 应有人脸数据
ls /usr/local/apps/@appdata/trim.photos/db/ # 应有 photo.db
然后启动相册，看照片能否正常预览。
七、常见问题
| 现象 |
原因 |
解压后出现 trim.photos/trim.photos/ |
解压目标目录选错了 |
| 系统盘突然满了 |
FinalShell 临时文件在 /root/.finalshell/temp/ |
| 相册打不开 / 权限错误 |
复制后需 chown -R root:root |
| 有缩略图但照片对不上 |
photo.db和 @appmeta不是同一套备份 |
