Immich 自托管照片库：部署前的数据迁移、备份与恢复检查

手机里的照片越来越多，旧硬盘上还有按年份整理的文件夹。把它们交给 Immich 之前，最值得先做的不是打开自动上传，而是确认两件事：现有照片能否按预期进入照片库，以及服务器损坏后，能否从备份重新打开它们。

Immich 是自托管的照片与视频管理项目，适合希望自己掌控存储位置、同时使用时间线和相册等管理功能的用户。但照片库不只是一批图片文件：上传的原件与记录用户、相册等信息的数据库都需要纳入保全计划。官方备份与恢复文档也明确提醒，完整备份需要同时覆盖上传的照片、视频和 Immich 数据库。

环境准备：先划清哪些数据不能丢

部署前，先写下现有照片分布在哪里：手机、电脑、移动硬盘、云盘分别有多少内容，哪些是唯一副本。迁移期间保留原位置，不要把“已经在 Immich 中看见缩略图”当作可以删除原件的依据。

接着检查服务器的磁盘空间、持久化目录、目录权限和备份目的地。照片原件之外，还要为数据库、缩略图及后续增长留出空间；具体资源要求和部署配置应以准备使用的版本文档为准。如果备份仍放在同一块硬盘上，硬盘故障时它可能与照片库一起消失。

从 Immich 项目仓库进入对应版本的部署文档，按官方提供的配置准备服务。启动前，核对配置中的上传目录和数据库持久化位置是否指向预期磁盘；不要在尚未确认挂载关系时直接复制别人的路径。

首次启动后，先完成管理员账户设置，用浏览器上传几张可删除的测试照片，再重启服务，确认照片仍能显示、原件仍在预期目录。这个小检查能尽早暴露目录未持久化或权限错误，代价远低于导入完整照片库后再返工。

从旧图库中复制一小批样本，而不是移动原文件。样本最好包含不同年份、手机照片、视频，以及你实际使用的特殊格式或成组文件。记录试迁移前的文件数量和目录位置，再按选定的导入方式操作；已有目录是由 Immich 接管上传，还是作为外部文件来源使用，应先依据当前版本文档确认，避免把两种路径混为一谈。

导入完成后，不只看首页数量，还要抽查：

若发现缺失，先停止批量导入。核对源文件是否仍存在、容器能否读取相应目录、后台任务是否完成，以及服务日志中是否有明确错误。缩略图尚未出现，不一定代表原件丢失；反过来，能看到缩略图也不能证明原件可恢复。

建立备份计划时，至少分别列出上传的照片和视频、数据库，并保存重建部署所需的配置记录。确认每项备份的来源、目标位置、执行时间和保留方式；定期检查备份文件是否实际生成，不能只依赖任务显示“成功”。

数据库备份尤其需要遵循对应版本的官方流程，避免复制运行中的数据目录后就认定备份有效。Immich 官方文档提示，备份与恢复流程曾在 v2.5.0 发生变化；使用较旧版本创建的备份时，应切换到相应版本文档查找恢复方法。发布或执行操作前，也应再次核验当前版本的步骤。

不要第一次等到故障当天才尝试恢复。用试迁移数据做一次演练：准备隔离的测试环境，确认版本与备份对应，恢复数据库和媒体文件，再检查账户能否登录、照片能否打开并下载、相册和抽样元数据是否正常。不要把演练直接指向仍在使用的原始目录或生产数据库。

演练结束后，留下可重复执行的记录：备份存放位置、所用版本、恢复顺序、耗时和遇到的问题。只有当这些步骤能在另一套环境中完成，备份才不只是磁盘上的一份文件。

Immich 可以让自托管照片管理更方便，但它不能替你决定哪些旧文件可以删除。先完成小批量试迁移和恢复演练，再逐步扩大导入范围；在验证通过之前，保留旧图库的独立副本。