需要什麼協助？

• 一支執行 iOS 17 或以上版本的 iPhone。離開 App 後要讓同步在背景繼續，需要 iOS 26。
• 你自己的 Immich 伺服器，版本 3.3 或以上，能從 iPhone 連線，並在上面有一個 Immich 帳號。
• 完整取用照片圖庫的權限（下文說明為何有限取用不夠）。

1. 輸入你的 Immich 伺服器位址（例如 https://immich.example.com）、Immich 電子郵件和密碼，然後點一下 登入。
2. 點一下 允許取用，並允許完整取用你的照片。
3. 點一下 開始試執行。試執行預設為開啟：它不會做任何更改，只會顯示有多少新照片、預估上傳大小，以及已有多少照片在你的 Immich 伺服器上。
4. 結果沒問題後，在 設定 中關閉 試執行，然後點一下 立即同步。如果想先少量開始，可先將 每次執行的上傳上限 設為 25 或 100 張照片。

iCloud 照片是唯一的標準。Photo Mirror Sync 會將新照片和影片以未經更動的原始檔上傳（HEIC、ProRAW、影片、含動態效果的原況照片），以目前版本取代編輯過的照片，讓喜好項目保持同步，並鏡像你的一般 iCloud 相簿，包括檔案夾中的相簿。

已逐位元組相同地存在於 Immich 中的照片（例如來自官方 Immich App 的）會透過總和檢查碼辨識，並直接連結，而不會上傳兩次。

你在 iCloud 中刪除的照片，會在下次同步時移到 Immich 的垃圾桶。Photo Mirror Sync 從不永久刪除任何內容，也從不清空垃圾桶；Immich 預設在 30 天後清空，在此之前你可以復原照片。

如果一次執行中會有超過 5 % 的圖庫（至少 25 張照片）移到垃圾桶，App 會停下來，請你 檢視並確認⋯。背景同步絕不會自行確認。圖庫為空或照片取用受限時，絕不會刪除任何內容。

只有 Photo Mirror Sync 自己上傳或連結的照片和相簿才會被更改。透過官方 Immich App、網頁介面或 CLI 上傳的照片、外部圖庫、其他使用者的照片，以及你自己在 Immich 中建立的相簿，都不會被更動。

在 iOS 26 上，你在 App 中開始的同步在切換到其他 App 後仍會繼續，進度顯示在鎖定畫面上。你也可以開啟在 iPhone 充電時執行的夜間同步；通知會告訴你有哪些變化。背景工作何時執行由 iOS 決定，因此夜間同步可能會延後或被略過。

停止、中斷或被關閉了？每張照片一到你的 Immich 伺服器就會被記錄，所以下次執行會從上次停下的地方精確地繼續，不會產生重複。

• 無法登入： 請確認在同一支 iPhone 的 Safari 中，該伺服器位址（包括 https:// 和連接埠）能打開 Immich 網頁介面，並確認伺服器執行的是 Immich 3.3 或以上版本。
• 照片取用受限： 打開 iOS 的「設定」App，選擇 Photo Mirror › 照片，並允許完整取用。在有限取用下，每張未選取的照片看起來都像被刪除了，所以 App 不會同步。
• 照片在等待 iCloud： 開啟「最佳化 iPhone 儲存空間」時，原始檔需先從 iCloud 下載。請讓 iPhone 保持連接 Wi-Fi；停滯一分鐘的下載會被略過，並在下次執行時重試。
• 背景同步停止了： 打開 App 並再點一下 立即同步，它會從停下的地方繼續。主畫面上的記錄會顯示某次執行結束的原因。
• Immich 中少了某張照片： 執行一次試執行，它會針對樣本說明照片為何尚未上傳到伺服器；也可以查看 已鏡像的照片 › 最近鏡像，其中每張照片都直接連結到 Immich。

你的照片和 Immich 帳號只會傳送到你自己的 Immich 伺服器。沒有我們的帳號，沒有其他雲端，也沒有追蹤。請參閱隱私權政策。

有問題、遇到狀況或有想法？請寫信至 [email protected]，並註明你的 iOS 版本和 Immich 伺服器版本。Immich 伺服器本身的問題，請洽 Immich 專案。