Immich 於 2026 年 10 月底釋出 3.4 版候選版本，為自託管相片與影片庫加入網頁端通行密鑰登入、手機端 JPEG XL 解碼、手機標籤管理與工作流 OCR 條件，並修補逾十項安全問題。專案在 GitHub 累積 118,449 顆星標，仍以 AGPL 3.0 授權釋出。
這次發布節奏值得注意。官方部落格的 3.4 版發布文章在 10 月 29 日上線，內文仍標示為待完成稿；候選版本由 rc.1 推進到 11 月 6 日的 rc.3，最新穩定版維持在 3.3.6。對於把家庭相片放在自架伺服器的使用者，這個版本帶來的是登入方式與格式支援的結構性改變，並非單純的功能堆疊。
Immich 3.4 新增了什麼功能？
此版本加入網頁端通行密鑰登入、手機端 JPEG XL 解碼、伺服器端 JXL 輸出格式、手機標籤管理、備份整合，以及工作流的 OCR 觸發與篩選條件。
官方列出的重點集中在五個方向：通行密鑰、相機廠牌與型號顯示修正、工作流改進、安全修補與效能調整。社群長期反映的手機標籤管理亦在這個版本落地，行動端終於可以自行建立與整理標籤，不必回到網頁版操作。
發布說明把備份功能列為新特性之一，並在候選版本說明中提到與 FUTO Backups 的整合得到改善。對自行維護資料的人而言，備份路徑是否順暢，往往比介面功能更影響實際可用度。
通行密鑰如何在自託管相片庫運作？
使用者在個人設定建立通行密鑰後，登入頁會多出以密鑰登入的按鈕。管理員可像密碼或 OAuth 一樣，在後台統一開啟或關閉這項登入方式。
通行密鑰把驗證綁定到裝置上的金鑰，伺服器只保存公開部分，暴力猜測密碼的攻擊面因此縮小。Immich 的實作放在使用者設定與管理員設定兩處，前者負責登記，後者負責全站開關，這種分層讓家庭伺服器與多人共用的部署都能調整。
手機端暫時未能同步。官方說明指出，通行密鑰與網域綁定，自託管環境的網域配置差異較大，行動端登入因此排在較後位置。使用者在升級後可以先用網頁端體驗，再等待行動端跟進。
JPEG XL 與手機標籤解決什麼問題？
手機端可直接解碼 JPEG XL，伺服器亦可把 JXL 設為轉檔目標格式，相同畫質下檔案更小。手機標籤管理則讓行動端自行建立、指派與移除標籤。
JPEG XL 的價值在於同時支援無損與有損壓縮，並保留較高動態範圍。對長期累積的相片庫，這代表在相同儲存空間下可以保留更多細節，亦減少日後重新轉檔的需要。Immich 這次在解碼與輸出兩端同時支援，形成完整的處理路徑。
標籤一直是自託管相片庫的分歧點。支援者認為標籤比資料夾更貼近回憶的組織方式，反對者則擔心手動維護成本。行動端補上這項能力之後，整理工作的門檻明顯降低，實際效益仍取決於使用者是否願意持續投入。
工作流與 OCR 條件有什麼用途？
EXIF 篩選新增 missing 與 present 兩種比對方式，只判斷欄位是否存在。另有 OCR 完成觸發與 OCR 文字篩選，兩者串接後可自動把收據歸入指定相簿。
舊版比對需要填寫正規表達式，即使只想確認某個欄位有沒有值，也得先寫出模式。新的比對方式把這層負擔移走，規則因此更容易由非工程背景的家庭成員維護。
OCR 觸發的意義在於時序。文字辨識通常在檔案匯入後才完成，若工作流在匯入當下就執行，讀到的往往是空白欄位。改由辨識完成觸發之後，規則才拿得到可靠文字，官方舉的例子是依收據常見關鍵字自動歸檔。
這次修補了哪些安全問題？
安全清單超過十項，涵蓋共享連結的相簿成員外洩、重複檢查的權限校驗、郵件模板變數轉義與符號連結跟隨。內容安全政策亦不再包含 unsafe-inline。
修補集中在權限邊界。共享連結只應顯示相片，不應帶出相簿成員名單；重複檔案檢查不應讓沒有上傳權限的帳號探測伺服器內容；自訂郵件模板的變數若不轉義，就可能成為注入點。這些都屬於自託管部署較難自行發現的類型。
內容安全政策的調整屬於防禦縱深。移除 unsafe-inline 之後，即使某處輸出未正確轉義，瀏覽器也會阻擋內聯腳本的執行。代價是部分自訂主題或第三方嵌入需要改寫，升級前值得先檢查。
如何升級到 Immich 3.4？
把 .env 的 IMMICH_VERSION 改為 v3.4.0-rc.3，再執行 docker compose pull 與 up -d。升級前務必備份資料庫與相片庫。
官方對候選版本的說明相當直接：這不是穩定版，仍可能有錯誤或不相容變更。資料庫與媒體庫的備份應在升級前完成，官方文件長期提醒遵循三份備份、兩種媒介、一份異地的原則。
機器學習服務另有一個可調整的參數。把 MACHINE_LEARNING_MODEL_REVISION 設為 v2，可以取得這個版本在記憶體用量與效能上的改進。若硬體資源緊張，這項設定比任何介面功能都更直接影響實際體驗。
Immich 與商業雲端相片服務有何差異？
Immich 由使用者自備伺服器與儲存空間，資料不經過第三方雲端。商業服務提供代管、跨裝置同步與長期維運，兩者的差別在於資料控制權與維護責任的分配。
自託管的成本結構不同。授權免費，但硬體、電力、備份與時間都是支出；商業服務把這些成本包進訂閱費，使用者換取的是省心。資料量越大、對隱私越敏感，自託管的相對優勢越明顯。
授權條款也影響商業採用。AGPL 3.0 要求修改後的網路服務同樣開源，企業若打算把 Immich 包裝成對外服務，需先確認法務立場。純自用的家庭部署不受這層限制。
出處連結有哪些？
本文資訊來自 Immich 官方 v3.4 發布文章、GitHub 儲存庫與候選版本說明，數據取自 2026 年 11 月 7 日的儲存庫頁面。
- 專案儲存庫：immich-app/immich
- 官方 3.4 發布說明：v3.4.0 release notes
- 官方文件：docs.immich.app
總結：Immich 3.4 適合什麼團隊？
適合已自架伺服器、重視資料控制權，且能承擔升級與備份工作的團隊。需要開箱即用與代管維運的使用者，商業雲端服務仍然省事。
3.4 版的價值不在單一功能，而在把登入、格式與自動化三條線同時補強。通行密鑰處理帳號安全，JPEG XL 處理長期儲存效率，工作流處理日常整理的重複勞動，這三件事正好對應自託管相片庫最常被抱怨的環節。
風險也清楚。候選版本尚未完成驗證，發布說明仍標示待完成，行動端通行密鑰排在未來版本。急於升級的部署應先在測試環境演練備份與還原，確認流程可行後才動正式資料。
