跳转到主要内容

系统完整性

文件夹检查​

信息

这些检查考虑的文件夹包括：upload/, library/, thumbs/, encoded-video/, profile/, backups/

当 Immich 启动时，它会执行一系列检查以验证是否可以对存储系统使用的卷挂载进行文件读写操作。如果无法完成所有必需的操作，它将无法启动。这些检查包括：

  • 在每个文件夹中创建一个初始的隐藏文件 (.immich)
  • 在每个文件夹中读取一个隐藏文件 (.immich)
  • 在每个文件夹中覆盖一个隐藏文件 (.immich)

这些检查旨在发现以下情况：

  • 权限错误（无法读写文件）
  • 缺少卷挂载（.immich 文件应该存在，但缺失）

常见问题​

备注

.immich 文件作为标记，帮助记录 Immich 使用的卷挂载。除了下面列出的情况，它们不应该被手动创建或删除。

挂失的 .immich 文件​

验证系统挂载文件夹检查 (enabled=true)
...
ENOENT: 没有这样的文件或目录，打开 'upload/encoded-video/.immich'

上面的错误消息显示，服务器之前（成功）将 .immich 文件写入每个文件夹，但现在无法检测到它们。这可能是因为以下任何原因：

  • 权限错误 - 无法读取文件，但文件存在
  • 文件不存在 - 卷挂载发生变化，需要修正
  • 文件不存在 - 用户手动删除了它，需要手动重新创建 (touch .immich)
  • 文件不存在 - 用户从备份恢复，但没有恢复每个文件夹（用户应该恢复所有文件夹或手动在缺失的文件夹中创建 .immich）

忽略检查​

警告

这些检查旨在发现我们过去看到用户可能遇到的常见问题，并且通常表明有需要解决的问题。如果你知道自己在做什么并且想要禁用它们，可以设置以下环境变量：

IMMICH_IGNORE_MOUNT_CHECK_ERRORS=true