Immich故障排除：恢復照片和設定伺服器的完整指南

如果您厭倦了每月支付雲端儲存費用，並且不希望大型企業窺探您的記憶，那麼不妨建立自己的雲端儲存實例。 本地伺服器上的 Immich 簡而言之，這是你能做出的最佳決定。它是一款功能強大的開源替代方案，幾乎完美地模仿了Google相簿的功能，但有一個根本區別： 你擁有絕對的控制權 您的文件儲存在哪裡以及誰可以存取它們。事實上，許多用戶利用這一點來執行以下操作： 從 Google Photos 遷移到 Immich 的完整指南 並重新獲得他們的隱私。

雖然該應用程式的穩定版本已經非常成熟，但最初遇到一兩個問題是正常的。 技術障礙或意外錯誤例如係統無法偵測到新圖片或載入縮圖時發生錯誤。別擔心，這些問題通常都很小。 權限失敗或路徑配置錯誤 在 Docker 中，這個問題可以透過一些精心設計的調整來解決。

如何解決照片不顯示的問題

習慣手動整理資料夾的使用者常犯的一個錯誤是直接將照片複製到 Immich 目錄，並期望它們會自動出現。需要注意的是，為了避免命名衝突，Immich 會在上傳資料夾內以隨機結構管理檔案。如果您想保持自己的資料夾層級結構，則不應將檔案移至上傳路徑，而應配置特定的資料夾結構。 外部函式庫 從管理面板。

當伺服器“看不到”圖像時，首先要檢查的是… docker-compose.yml 檔案中的磁碟區映射如果您已將外部硬碟或資料夾掛載到 NAS 上，則需要確保主機路徑和容器路徑匹配或已正確連結。如果文件存在但 Immich 沒有顯示它們，則可能需要前往… 管理 > 外部庫建立一個新的庫並啟動手動掃描，以便系統可以對內容進行索引。

另一種令人沮喪的情況是錯誤 圖片載入失敗 或缺少縮圖。這通常發生在重新安裝或遷移之後，因為 PostgreSQL 資料庫元資料與檔案的實體位置不符。要解決此問題，必須 重新執行遷移和掃描作業 從「作業」功能表中，確保伺服器擁有處理作業佇列所需的資源。

與Google相簿不同， 伊米奇將影像的實體儲存與他用來組織影像的資訊分開。照片儲存在檔案系統中，而相簿、人物識別、標籤、縮圖和元資料則儲存在 PostgreSQL 資料庫中。由於採用這種架構，即使在遷移或硬體變更後，只要原始檔案和資料庫都保留，系統也能重建大部分圖庫。

文件權限：Docker 的阿基里斯之踵

如果一切設定似乎都正確，但您仍然看不到照片，則很可能是您的設定出現了問題。 讀寫權限問題Docker 通常以特定使用者身分執行容器，該使用者可能沒有存取外部硬碟或 UGreen 或 Synology NAS 上的資料夾的權限。即使路徑正確，這也會導致 Immich 無法讀取檔案。

要徹底解決此問題，您需要存取 Linux 伺服器的終端並更改所有權和權限。使用以下命令 sudo chown -R your_username:your_username /path/to/your/photos 後來 sudo chmod -R 775 /path/to/your/photos您需要確保容器可以存取檔案系統。這是許多人容易忽略的關鍵步驟，也是導致 90% 檔案可見性失敗的常見原因。

伺服器安裝和最佳化

為了確保 Immich 流暢運行，最好將其安裝在迷你電腦（例如基於 Intel N100 處理器的電腦）或安裝了 Docker 的 NAS 上。該架構需要至少雙核心伺服器，雖然 4GB 記憶體即可運行，但對於大型庫，建議使用更多記憶體。 升級至 8GB 或 16GBPostgreSQL 和 Redis 資料庫必須位於…上，這一點至關重要。 SSD 或 NVMe 驅動器 為了避免出現瓶頸，硬碟僅用於海量儲存影像。

在 .env 檔案中，請特別注意該變數。 上傳位置此路徑應指向行動應用程式直接上傳檔案的儲存位置。重要提示：請勿將此資料夾放在外部庫中，否則可能會導致問題。 無限掃描循環 這樣一來，即使伺服器處理器過載，​​仍然會發現「新照片」。

提升人工智慧和臉部辨識能力

Immich 的優點之一在於它能夠利用人工智慧對人臉進行分組並蒐索物體。如果您有成千上萬張照片，首次掃描可能需要數天時間。為了加快這一過程，您可以調整… 作業設定中的並發性如果您的 CPU 效能足夠，則允許伺服器同時處理更多任務。此外，如果您擁有 NVIDIA 顯示卡，請配置下列參數： CUDA加速 這將大幅縮短處理時間。

如果您發現臉部辨識不準確，您可以嘗試調整以下設定： 最大識別距離 在機器學習設定中，0.4 通常是不錯的平衡值。對於超過 100.000 萬個檔案的大型函式庫，建議增加該值。 最少可辨識臉孔 為了防止系統建立數千個包含錯誤的小分組，然後逐步降低該值以最佳化搜尋。

移動同步和遠端訪問

Immich 應用程式非常出色，但要實現真正的自動備份，尤其是在 Android 系統上，您需要進入應用程式的電池設定並啟用該功能。 “不受限制”否則，作業系統會終止背景進程，照片將無法上傳，直到您手動開啟應用程式。在 iOS 系統上，情況類似，但係統對後台進程的限制更為嚴格。

要從家外存取您的照片，同時避免將伺服器暴露在網路的風險中，最簡單、最安全的選擇是使用 尾鱗此工具會在您的裝置之間建立一個私人 VPN 網絡，使您能夠使用靜態 IP 位址存取伺服器，而無需配置複雜的反向代理或 SSL 憑證。如果您想了解更多信息，請參閱… 如何使用 Tailscale 與朋友分享 NAS 擴大存取權限。這是讓你的個人「Google Photos」在全球任何地方都能存取的最快方式。

讓 Immich 保持最新狀態就像運行一個 docker compose pull 然後重啟容器。別忘了定期備份，不僅是照片，尤其要備份… PostgreSQL資料庫因為您的媒體庫的所有組織結構、標籤和路徑都儲存在那裡。 3-2-1 備份（三份副本，兩種儲存介質，一份外接儲存）是防止資料遺失的唯一真正保障。