immich文件存储：多存储后端支持详解

你是否还在为照片和视频的存储问题烦恼？immich作为自主托管的照片和视频备份解决方案，提供了灵活的文件存储后端支持，让你可以根据自己的需求选择合适的存储方式。读完本文，你将了解immich的文件存储机制、支持的存储后端类型以及如何进行配置。

存储位置检测与配置

immich的文件存储位置可以通过环境变量进行配置。在docker/example.env文件中，你可以设置UPLOAD_LOCATION变量来指定上传文件的存储位置，默认值为./library。

# The location where your uploaded files are stored
UPLOAD_LOCATION=./library

如果没有显式设置UPLOAD_LOCATION，immich会自动检测存储位置。从server/src/services/storage.service.ts的代码中可以看到，系统会检查/data和/usr/src/app/upload这两个候选路径，优先选择存在的路径作为存储位置。

存储后端类型

immich支持多种存储后端，以满足不同用户的需求：

本地文件系统存储

本地文件系统存储是immich的默认存储方式。系统会在存储位置下创建多个文件夹来组织不同类型的文件，如照片、视频、缩略图等。这些文件夹的定义可以在server/src/services/storage.service.ts中找到，通过StorageFolder枚举来管理。

云存储支持

虽然在提供的代码中没有直接看到S3或MinIO的具体实现，但immich支持云存储后端。你可以通过配置相应的环境变量来启用云存储功能，如AWS S3、MinIO等兼容S3 API的存储服务。

存储完整性检查

immich具有完善的存储完整性检查机制，确保你的文件安全存储。在系统启动时，会对各个存储文件夹进行读写权限验证。

从server/src/services/storage.service.ts的代码中可以看到，系统会为每个存储文件夹创建.immich文件，并进行读写测试。如果检测到问题，会抛出相应的错误信息。

private async verifyReadAccess(folder: StorageFolder) {
  const { internalPath, externalPath } = this.getMountFilePaths(folder);
  try {
    await this.storageRepository.readFile(internalPath);
  } catch (error) {
    this.logger.error(`Failed to read (${internalPath}): ${error}`);
    throw new ImmichStartupError(`Failed to read: "${externalPath} (${internalPath}) - ${docsMessage}"`);
  }
}

存储位置迁移

如果你需要更改存储位置，immich提供了自动迁移功能。当检测到存储位置变化时，系统会自动更新数据库中的文件路径，确保数据的一致性。

if (previous !== current) {
  this.logger.log(`Media location changed (from=${previous}, to=${current})`);
  await this.databaseRepository.migrateFilePaths(previous, current);
}

文件删除机制

immich有专门的任务处理文件删除操作。当需要删除文件时，系统会将删除任务加入队列，确保文件被正确删除。相关实现可以在server/src/services/storage.service.ts的handleDeleteFiles方法中查看。

总结

immich提供了灵活可靠的文件存储解决方案，支持本地文件系统和云存储等多种后端。通过环境变量可以轻松配置存储位置，系统内置的完整性检查和自动迁移功能确保了文件的安全性和可维护性。无论是个人用户还是企业用户，都可以根据自己的需求选择合适的存储方案，享受immich带来的便捷照片和视频备份体验。