Immich 中文文档 下载 App

Immich 备份哪些文件:3-2-1 策略下必须带走的数据清单

「服务器坏了,我要带走哪些东西才能完整重建?」——这一页给一张明确的清单。先记住总原则:Immich 的全部状态 = 文件系统上的目录 + 一个数据库,备份就是同时覆盖这两者。

必备:三个原始数据目录

都在 UPLOAD_LOCATION 下:

目录内容为什么必备
library原始照片和视频(默认存放区)你的照片本体,不可再生
upload上传区与用户上传的临时/独立内容同上,部分内容的家
profile用户头像小但丢了要挨个重传

注意:开启存储模板后,原始文件的存放结构会按模板重排,library 的含义随之变化——改存储模板前请先读官方专页并立刻做一次 数据库备份。

必备:数据库转储

UPLOAD_LOCATION/backups 里的 .sql.gz 文件(或你手动触发的那份)。数据库里存着:文件与照片的对应路径、用户账号、共享关系、相册成员、人脸与命名、编辑记录、标签——没有数据库,文件只是匿名像素堆。

官方 FAQ 里的经典问答值得抄录在这:「数据库备份不包含照片和视频——两者必须一起备份。」这是整个备份体系最重要的一句话。

可再生:丢了会疼但能重建

目录内容再生代价
thumbs三种缩略图 + 人脸小图重跑缩略图任务,大库数小时到数天
encoded-video转码视频副本重跑转码任务
机器学习缓存模型与向量缓存向量重建期间搜索不可用

规划备份空间时可以不带上它们;但日常体验会受影响——所以更常见的做法是一并备份,恢复后不用苦等重建。

3-2-1 怎么落到 Immich

3-2-1 策略:3 份数据、2 种介质、1 份异地。对应到 Immich:

  1. 副本一:服务器本机(UPLOAD_LOCATION + 数据库转储)——这是「正在使用的原件」;
  2. 副本二:另一块本地介质——外接硬盘定期整体拷贝 UPLOAD_LOCATION,或 NAS 之间同步;顺手把数据库转储目录也带上;
  3. 副本三(异地):云端对象存储、另一处住所的设备、或可信的家庭成员间的互备。隐私敏感用户选异地方案时记得加密。

官方文档提供了可直接跑的模板备份脚本(配合 cron 定时),思路就是「pg_dump 数据库 + rsync 文件目录」的组合——不想手写的人拿模板改路径就能用。

文件备份与 Immich 自身功能的关系

Immich 内置的 自动数据库备份 解决的是「数据库这一层」的自动化;文件层和异地层 Immich 管不着——因为每家的存储拓扑都不同。诚实地说:这是自托管相对云相册真正的代价所在,云相册对比 里提过的账,在这一页落到实处理。

清单齐了。接下来是备份之外最常被问的扩展场景:外部库——把已有照片目录挂进 Immich。