本篇文章更新時間：2026/01/12
如有資訊過時或語誤之處，歡迎使用 Contact 功能通知。
一介資男的 LINE 社群開站囉！歡迎入群聊聊～
如果本站內容對你有幫助，歡迎使用 BFX Pay 加密貨幣 或 新台幣 贊助支持。
內容目錄
iCloud 照片備份自動化：閱讀 icloudphotosdownloader 專案後的深度筆記
編輯前言：這篇筆記整理自 GitHub 專案 icloudphotosdownloader。如果你和我一樣，希望擺脫手動整理 iCloud 照片的痛苦，那這個 CLI 工具會是你值得認識的好朋友。
核心觀點 (Key Takeaways)
- icloudphotosdownloader 是完全開源、跨平台的 iCloud 照片下載工具，適用於 Linux、macOS、Windows。
- 提供 Copy、Sync、Move 三種模式，支援 Live Photos、RAW、EXIF 更新等進階功能。
- 使用前 一定 要調整兩項 iCloud 設定，否則會直接 ACCESS_DENIED。
深入解析
這個專案的定位非常單純：讓使用者能用命令列自動下載 iCloud 照片，甚至做到同步與自動監控。比起蘋果官方封閉式的匯出流程，這個工具給了使用者更多掌控權。
官方強調：「We aim to release new versions once a week (Friday), if there is something worth delivering.」
從這個更新節奏就可以看出社群維護的活力。
三種下載/同步模式是精華
- Copy（預設）：只下載 iCloud 中新增加的照片。
- Sync：下載新照片，並「刪除本機中 iCloud 已移除的照片」。
- Move：下載後從 iCloud 刪除照片，適合把 iCloud 當作暫存空間的人。
我覺得這三種模式對不同使用者的情境很有彈性。尤其 Sync，可以讓 NAS 或家中伺服器真正做到「完整鏡像 iCloud」。
使用前的兩個重要前置設定
作者直接點出兩個必須的 iCloud 設定：
- 開啟 Access iCloud Data on the Web（否則無法授權）
- 關閉 Advanced Data Protection（否則會 ACCESS_DENIED）
這部分我認為是最大坑點，因為很多人會忘記自己開啟 ADP 之後 API 會被擋掉。
支援完整影像格式、metadata、與增量優化
這個 CLI 工具支援：
- Live Photo（照片 + 動畫分開存）
- RAW / RAW+JPEG
- 去重複（避免相同檔名覆蓋）
- EXIF 日期修正
- 持續監控（--watch-with-interval）
可以看出它不只是下載器，更是半自動的照片管理器。
筆者心得與啟發
讀完這個專案後，我最大感想是：照片備份其實不需要依賴 Apple 的封閉系統，只要擁有 API session，就能實現更彈性的備份方式。
對於有家庭 NAS、備份需求、或不想讓照片只鎖在 iCloud 裡的使用者來說，這個工具幾乎是必備。
若你打算採用，我會建議：
- 先用
--auth-only建立一次 session，確認授權沒有問題。 - 若要長期同步，使用
--watch-with-interval每隔一小時跑一次。 - 在 NAS 上跑 Sync Mode，可以得到很乾淨、無重複、與 iCloud 內容一致的照片庫。
最後，專案目前正在尋找 maintainer。如果你本身熟 Python、熟命令列工具，或熱愛開源，這會是值得參與的專案。
這篇筆記就是希望讓更多人知道這個實用工具，尤其是那些為 iCloud 照片備份煩惱已久的人。