企业官网建设流程全解析

iCloud 照片批量下载指南：3 步用 icloudpd 建立本地备份

【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader

icloudpd 是一个跨平台的命令行工具，用于把 iCloud 照片库批量下载到本地。一条命令即可将全部照片、视频和 Live Photo 拉到本地，建立起一份自己可控的照片备份。下面从环境准备到首次下载，把完整流程走一遍。

项目定位

icloudpd 模拟网页端访问 iCloud，把整个照片库批量拉到本地，解决"照片只在云端、本地只有压缩版"的问题。与常见的下载方式相比，它的差异点：

• 提供复制、同步、移动三种同步模式，对应不同备份策略
• Live Photo、RAW、编辑版本均可按原始规格保存
• 支持长驻监控，定时自动抓取 iCloud 中的新增照片

跑起来

环境准备：iCloud 照片备份的前置条件

• Apple ID 已开启"在网页上访问 iCloud 数据"（设置 > Apple ID > iCloud > 在网页上访问 iCloud 数据）
• 同账户关闭"高级数据保护"，否则服务器会返回 ACCESS_DENIED
• 准备好 Python 环境或直接使用平台可执行文件，各方式见安装指南
• 本地磁盘可用空间大于 iCloud 照片库体积

认证与首次下载：icloudpd 认证命令

先做一次认证测试，账户若开启两步验证，验证环节会在这个阶段出现：

# 仅测试认证，不下载 icloudpd --username 你的邮箱@example.com --password 你的密码 --auth-only

认证通过后开始正式下载，照片存入指定目录，并每隔一小时自动拉取新增照片：

# 全量下载 + 每 3600 秒增量一次 icloudpd --directory /data/photos --username 你的邮箱@example.com --watch-with-interval 3600

注意可执行文件名是icloudpd而不是icloud；完整参数列表可用icloudpd --help查看。

功能深潜

同步策略怎么选：iCloud 照片同步模式选择

• 场景是想留档、本地只增不删、不动已有文件 → 用 Copy 模式，默认无需任何参数
• 场景是本地要与 iCloud 完全一致，云端删了本地也要跟着删 → 加--auto-delete，进入 Sync 模式
• 场景是想把原片落到本地、腾出 iCloud 空间 → 加--keep-icloud-recent-days，进入 Move 模式，数值如 7 表示云端保留最近 7 天

三种模式的完整定义见操作模式文档。

格式与文件支持

• JPEG/HEIC 照片
• 各类视频文件
• Live Photo（图+视频）
• RAW 及 RAW+JPEG
• 编辑版本（adjusted）

智能去重

大照片库中重名文件很常见，icloudpd 默认给第二个同名文件追加文件大小后缀（如IMG_1234-67890.JPG）避免覆盖，重复运行时直接跳过已下载文件。希望保留云端唯一标识时，改用--file-match-policy name-id7。

典型场景

• 家庭用户：在 NAS 上部署 icloudpd 并设置每日定时任务，全家照片永久落在 NAS 上，成员随时可查。
• 摄影师：用 Move 模式把客户经 iCloud 共享的原片下载到工作目录，iCloud 空间随之持续释放。
• 设计团队：将共享素材库同步到公共目录，成员随时取到最新素材。

高频问题

问：首次运行报错怎么办？iCloud 服务器需要先为你账户准备照片数据，等待 5 到 30 分钟再重试通常即可解决。

问：两步验证能保持多久？验证有效期约两个月，到期需要重新认证；可配置 SMTP 在到期前收到邮件提醒。

问：同步间隔选多少合适？照片更新频繁的账户选 1 到 2 小时，个人备份每天一次或手动运行即可。

落地建议

• 先测试认证再跑全量
• 小目录试跑验证命名
• 开启 watch 参数做增量
• 预留磁盘空间再开始

用一条命令，把只存在于云端的 iCloud 照片库变成可管理的本地档案。今天就安装 icloudpd，跑起第一次备份。

【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader