檔案自定義位置

本指南解釋了如何使用 Docker 的 volume mount 將生成的檔案及原始檔案儲存到不同的位置。

備份

請記得在遵循本指南後更新備份設置，確保自動備份工具能將新的備份路徑（特別是 profile/）納入備份。

在 .env 檔案中，我們將定義想要使用的路徑。注意，這些並非全部都需要定義：UPLOAD_LOCATION 將作為檔案存儲的基礎資料夾，其他路徑則作為覆蓋設定。

.env

# 你可以在[這裡](/docs/install/environment-variables)找到所有支援環境變數的文檔

# 自定義上傳檔案、縮略圖和轉碼影片的存儲位置
- UPLOAD_LOCATION=./library
+ UPLOAD_LOCATION=/custom/path/immich/immich_files
+ THUMB_LOCATION=/custom/path/immich/thumbs
+ ENCODED_VIDEO_LOCATION=/custom/path/immich/encoded-video
+ PROFILE_LOCATION=/custom/path/immich/profile
+ BACKUP_LOCATION=/custom/path/immich/backups
...

在定義了這些檔案的位置後，我們將相應地編輯 docker-compose.yml 檔案，並將新的變數添加到 immich-server 容器中。這些路徑是綁定在容器內部的位置，請勿更改。

docker-compose.yml

services:
  immich-server:
      volumes:
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
+     - ${THUMB_LOCATION}:/usr/src/app/upload/thumbs
+     - ${ENCODED_VIDEO_LOCATION}:/usr/src/app/upload/encoded-video
+     - ${PROFILE_LOCATION}:/usr/src/app/upload/profile
+     - ${BACKUP_LOCATION}:/usr/src/app/upload/backups
      - /etc/localtime:/etc/localtime:ro

完成該修改後，您需要將檔案移動到新的資料夾中，確保 Immich 能夠找到它需要的所有內容。如果目前尚未上傳任何重要的資料，也可以通過刪除資料庫資料夾來完全重置 Immich。 然後，重新啟動 Immich 以應用更改：

docker compose up -d

注释

由於 Docker 綁定掛載的底層屬性，不建議將 upload/ 和 library/ 資料夾作為單獨的綁定掛載出現，特別當它們位於相同設備上時。 因此，我們將硬碟或網絡存儲（NAS）掛載到 /usr/src/app/upload，然後再將需要訪問的資料夾掛載到該資料夾下。

thumbs/ 資料夾包含顯示在時間線中的小縮略圖，以及點擊圖片後顯示的大預覽，這些無法分開存儲。

Immich 伺服器的存儲指標將跟蹤 UPLOAD_LOCATION 的可用存儲，因此管理員必須設置某種監控以確保存儲空間不會耗盡。profile/ 資料夾通常非常小，通常小於 1 MB。