Synology DSM 安裝 immich 教學影片
掛載外部圖庫到 immich
在 Synology NAS 安裝 immich 之後,如果想將之前上傳到 Synology Photos 的相片直接匯入。可以利用 immich 掛載外部圖庫的功能。這個功能只是「參考」掛載圖庫的路徑,並不會複製其中的內容到 immich 的相片資料夾中。所以不必擔心 NAS 中會有兩份相同的相片。
停止 immich 專案
在開始前先在 Container Manager 中將 immich 專案「停止」。接著需要修改之前上傳到 immich 資料夾中的兩個檔案「docker-compose.yml」及「.env」。
修改 docker-compose.yml
修改 docker-compose.yml 比較容易,在專案中選擇 YAML 設定即可看到內容,可直接在這裏修改。

在原本的 – ${UPLOAD_LOCATION}:/usr/src/app/upload 之下加入這一行:
- ${EXTERNAL_PATH}:/usr/src/app/external:ro
以上這行的內容請照抄不要改。其中「:ro」的意思是唯讀。如果你想要掛載的外部圖庫內容可以被修改。可將「:ro」移除。

修改完成後儲存,選擇「僅儲存變更」。

修改 .env
接著將 .env 改名為 .txt,方便我們使用「文字編輯器」(如果未安裝此套件,請安裝) 直接修改。或下載來修改後再重新上傳。

在 UPLOAD_LOCATION= 之下加入這行文字:
EXTERNAL_PATH=/volume1/homes/user/Photos
這裏的內容就要依照你自己 NAS 的路徑來填寫。其中 user 要填實際存在的帳號。請注意一點,掛載 Synology Photos 的相片只能選擇其中一人的帳號。這是 immich 美中不足的地方。所掛載的路徑,在匯入時會包含其下所有子資料夾的內容。
修改完之後記得再將檔案名稱改回 .env。

清除再建立專案
接下來要做的,是在專案的「操作」中先「清除」然後再「建立」。否則變更不會生效。「建立」之後專案會直接啟動,但需要等一下讓 immich 完全啟動後才能操作。

設定外部圖庫
在 immich 網頁的右上角自己的頭像點一下選擇「管理」。之後在左側功能表選擇「外部圖庫」。然後新增外部圖庫。接著選擇圖庫擁有者。

然後按下新增的圖庫最後面的「…」選擇「編輯匯入路徑」。

新增的路徑請照抄以下內容(勿修改):
/usr/src/app/external

儲存之後再點選右上方的「掃瞄所有圖庫」即可。
請注意!如果原始的 Synology Photos 中有非常多的相片,那麼這個掃瞄過程會花上非常長的時間(數小時到一天以上,視機器的效能)。因為 immich 需要重新為這些相片或影片進行編轉碼、人臉辨識等。期間 NAS 的 CPU 可能會一直處於 99% 的狀態。
immich 版本更新流程
在 Synology NAS 安裝 immich 之後,若有後續版本更新,請依照以下流程進行:
- 依前述方式將 immich 專案「停止」並「清除」(可不停止直接清除)。
- 重新下載「docker-compose.yml」及「example.env」並依前文修改這兩個檔案的方式,重新對這兩個檔案進行先前修改過的內容,然後將新的內容取代舊的。
- 在 Container Manager 左側功能表選擇「映像檔」並將 immich 相關的兩個映像檔刪除(參考下圖)。
- 依前述方式在 immich 專案中選擇「建立」,會重新拉取最新版本的映像檔。
- 更新成功。

限制 immich 過度佔用資源
當一次上傳許多相片影片時,immich 在進行人臉辨識等作業會吃掉大部份的資源。CPU 一直處於 99% 會讓 DSM 其它的服務反應整個變慢。要避免此情形發生。可以對 immich 容器資源限制。
停止 immich 專案。在「容器」分別針對 immich 的容器進行「設定」。「CPU 優先權」與「記憶體上限」。







