觀點 · 資訊分享
自架相簿 Immich 升到 3.0：手機能不傷原圖修片、整庫檔案完整性檢查，但舊的向量資料庫不再支援
可以架在自家 NAS 的照片備份系統 Immich 在 7 月 2 日推出 3.0 大版本：新增手機端非破壞性編輯、自動化流程、檔案完整性檢查、即時影片轉檔等功能，同時移除 pgvecto.rs 支援，升級前要先確認。
- 發布
- 2026-07-03
- 篇幅
- 約 5 分鐘 · 2,150 字
- 結構
- 7 節 + 3 題常見問題
- 標籤
一句話看懂：自架照片系統 Immich 在 7 月 2 日推出 3.0 大版本，新增手機端非破壞性編輯、整庫完整性檢查與影片即時轉檔，但舊的 pgvecto.rs 資料庫擴充不再支援，升級前要先檢查。
先用白話講：Immich 是什麼？
你的手機裡可能有幾千張照片，平常備份到雲端相簿。Immich 是一套讓你把這件事搬回自己家裡的系統：架在家裡的 NAS 或小主機上，手機裝 App 就會自動把照片傳回來，還能搜尋、分相簿、分享給家人，資料全部放在自己的硬碟。
這類自架服務最怕兩件事：升級壞掉，以及檔案悄悄損毀。這次的 3.0，兩件事都有被照顧到。
發生什麼事
Immich 在 2026 年 7 月 2 日釋出 3.0.0，這是第一次使用「候選版本（Release Candidate）」流程測試過的大版本。官方列出 13 項重點，挑幾個最有感的：
- 手機非破壞性編輯：手機 App 現在能裁切、旋轉、調整照片而不動到原檔，編輯可以隨時還原，也能在手機編輯、之後到網頁端繼續調整。以前手機端的編輯會另存成新的照片。
- 整庫完整性檢查：維護頁面新增「完整性報告」，會掃描 Immich 的資料夾並和資料庫比對，找出三種異常：資料夾裡有但 Immich 不認得的檔案、資料庫有記錄但檔案不見了、檔案的檢查碼對不上（通常是檔案損毀或改名造成）。每晚的執行時間與時長可以設定。
- Workflows 自動化（預覽）：用拖拉方式把「觸發條件、篩選、動作」串成自動流程，也能用 JSON 分享給別人。
- Android 背景備份更穩：以前背景備份只管新拍的照片，現在可以在背景上傳整個相簿庫，並會提醒電池最佳化或通知設定可能干擾備份。
- HLS 即時影片轉檔（預覽）：不必預先轉好離線版本，播放時即時轉檔，可切換畫質，離線轉檔關掉也能省儲存空間。
- 還有手機版投影片播放、手機 OCR（選取並複製照片裡的文字）、「最近新增」頁面、網頁新影片播放器、大量照片的月份瀏覽變順暢等。
升級前必看：會壞的地方
官方明講 3.0 有一批不相容變更，但對大多數使用者來說，更新方式與以前一樣；許多變動是 API 端點，只影響串接 Immich 的第三方工具。要特別留意的是：
| 項目 | 變動 |
|---|---|
| pgvecto.rs | 不再支援。設 DB_VECTOR_EXTENSION=pgvecto.rs 會直接報錯，要先搬到後繼者 VectorChord |
| 機器學習硬體需求 | x86 CPU 要符合 x86-64-v2 以上（官方說 2010 年後主流 CPU 都符合） |
| 環境變數 | 移除 3 個：IMMICH_MACHINE_LEARNING_PING_TIMEOUT、MACHINE_LEARNING_PRELOAD__CLIP、MACHINE_LEARNING_PRELOAD__FACIAL_RECOGNITION |
| OAuth | 預設不再允許不安全的 http 請求，oauth.issuerUrl 必須是有效網址 |
| 手機 App | 舊版時間軸已移除 |
給開發者的技術細節
用官方 Docker Compose 的話，先在 .env 把版本改成 v3，再照常更新：
# .env
IMMICH_VERSION=v3
docker compose pull && docker compose up -d
其他細節：
- 如果你的 Immich 是 v1.133.0 之前的版本、還沒做過向量資料庫遷移，要先照官方文件的 VectorChord 遷移步驟處理，再升到 3.0
- 伺服器的請求驗證從 class-validator 換成 Zod，驗證失敗的回應格式不同，
correlationId也改放到X-Correlation-ID回應標頭；有寫程式串接的人要調整 - 即時轉檔功能要在管理設定的影片轉檔區啟用；3.0 之前匯入的素材，需要重跑「中繼資料擷取」才會被重新處理
- 同日（UTC）釋出的 3.0.1 修正了「相簿在 v2 手機 App 不顯示」的問題
我的看法
對在 NAS 上自架服務的人來說，我最在意的反而是「完整性檢查」。自架最大的風險不是功能不夠，而是硬碟默默壞掉、檔案被改名，卻沒人發現。每晚自動比對檔案和資料庫，等於幫你多裝了一個哨兵；不過它只負責「發現」，真正的保護還是要靠另外的備份。
升級策略上，這次有資料庫擴充的移除，我會先備份資料庫、確認自己沒在用 pgvecto.rs，再動手。預覽功能（Workflows、即時轉檔）先放著觀察，等行為穩定再說，尤其 NAS 的 CPU 不一定撐得住即時轉檔。
名詞小辭典
- 自架（Self-hosted）：把服務裝在自己管理的機器上，不依賴雲端平台。
- 非破壞性編輯：修圖時不改動原始檔，只記錄「做了哪些調整」，隨時可以還原。
- 向量資料庫擴充（pgvecto.rs / VectorChord）：讓 PostgreSQL 資料庫能處理向量資料（可以想成圖片或文字的「特徵指紋」）的擴充套件；VectorChord 是 pgvecto.rs 的後繼者。
- 轉檔（Transcoding）：把影片轉成較小或相容性較好的格式，方便不同裝置播放。