系統完整性

資料夾檢查

信息

這些檢查中包含的資料夾包括：upload/、library/、thumbs/、encoded-video/、profile/、backups/

當 Immich 啟動時，它會執行一系列檢查，以驗證它是否能對存儲系統使用的掛載磁碟進行讀取和寫入操作。如果無法執行所有必要的操作，它將無法啟動。檢查包括：

• 在每個資料夾中創建一個初始隱藏文件 (.immich)
• 讀取每個資料夾中的隱藏文件 (.immich)
• 覆蓋每個資料夾中的隱藏文件 (.immich)

這些檢查旨在捕獲以下情況：

• 權限問題（無法讀取/寫入文件）
• 缺少的磁碟掛載（.immich 文件應該存在，但缺失）

常見問題

注释

.immich 文件作為標記，幫助追蹤由 Immich 使用的磁碟掛載。除了下列情況外，它們不應該被手動創建或刪除。

缺少 .immich 文件

驗證系統掛載資料夾檢查（已啟用=true）
...
ENOENT: 找不到此文件或目錄，打開 'upload/encoded-video/.immich'

上述錯誤消息表明伺服器之前曾經（成功地）將 .immich 文件寫入每個資料夾，但現在無法檢測到它們。這可能是由於以下任何原因導致的：

• 權限錯誤 - 無法讀取文件，但文件存在
• 文件不存在 - 磁碟掛載已更改，需要進行更正
• 文件不存在 - 使用者手動刪除了文件，應手動重新創建（touch .immich）
• 文件不存在 - 使用者從備份中恢復，但未恢復每個資料夾（使用者應恢復所有資料夾或手動在任何缺失的資料夾中創建 .immich）

忽略檢查

警告

這些檢查旨在捕捉我們過去曾經見過的使用者常見問題，且通常表明您需要解決某些問題。如果您知道自己在做什麼，並希望禁用它們，可以設置以下環境變數：

IMMICH_IGNORE_MOUNT_CHECK_ERRORS=true