你是否担心珍贵的iCloud照片会意外丢失？或者想要将多年的照片回忆安全地存储在本地设备上？icloudpd是一个强大的命令行工具，专门用于从iCloud批量下载照片和视频，支持多种格式和智能同步功能，让你轻松实现自动化备份管理。

iCloud照片下载器icloudpd是保护数字记忆的完美解决方案。这个开源工具能够高效、可靠地将你的iCloud照片库完整备份到本地存储，支持Windows、macOS和Linux系统，无论是个人电脑、服务器还是NAS设备都能完美运行。

与其他备份方案相比，icloudpd具有独特优势：

🚀 核心功能亮点

三种智能工作模式满足不同需求：

• 复制模式：只下载iCloud中的新照片，不删除任何本地文件
• 同步模式：下载新照片同时删除本地已不存在于iCloud的文件
• 移动模式：下载后从iCloud删除，配合保留天数选项智能管理空间

全面格式支持：

• 普通照片（JPEG、PNG、HEIC等）
• Live Photo（图片和视频分别保存）
• RAW格式图片（包括RAW+JPEG组合）
• 各种视频文件格式

环境准备

首先确保你的iCloud账户满足以下条件：

• 在iPhone/iPad上启用"在网页上访问iCloud数据"功能
• 关闭"高级数据保护"选项

安装方式选择

icloudpd提供多种安装方式，适合不同用户需求：

1. 直接下载可执行文件 - 最简单快捷
2. 使用包管理器安装 - 支持Docker、PyPI、AUR、npm
3. 从源码构建 - 适合开发者定制

基本使用命令

开始备份你的iCloud照片只需一行命令：

icloudpd --directory /你的照片目录 --username 你的邮箱地址 --watch-with-interval 3600

这个命令会：

• 将照片下载到指定目录
• 每3600秒（1小时）检查一次iCloud更新
• 自动处理认证和同步

认证测试与验证

在开始完整下载前，建议先进行认证测试：

icloudpd --username 你的邮箱地址 --password 你的密码 --auth-only

这个功能可以验证会话是否有效，避免下载过程中断。

文件夹结构定制

icloudpd支持灵活的文件夹组织方式：

icloudpd --directory /照片备份 --folder-structure {:%Y/%m/%d}

这会将照片按年/月/日自动分类，便于管理和查找。

增量同步优化

对于大型照片库，使用增量同步选项提高效率：

icloudpd --directory /备份目录 --recent 100 --until-found 1000

• --recent 100：只处理最近的100张照片
• --until-found 1000：从最新照片开始，直到找到1000个已存在的文件

家庭照片永久保存

王先生使用icloudpd将家庭10年的照片全部备份到家庭NAS中。他设置了每天凌晨自动同步，现在全家人都可以随时访问这些珍贵回忆，再也不用担心iCloud空间不足或照片意外丢失。

摄影师工作流优化

专业摄影师张小姐利用icloudpd将客户通过iCloud共享的原始照片自动下载到工作目录。配合RAW格式支持，她可以直接处理高质量原始文件，大大提高了工作效率。

企业团队协作

某设计公司使用icloudpd同步团队的创意素材库。通过Docker容器部署在服务器上，确保所有设计师都能及时获取最新资源，同时保持本地备份安全。

❓ 首次运行遇到错误怎么办？

首次使用时可能出现"ACCESS_DENIED"错误，这通常是正常的。iCloud服务器需要时间准备照片数据，建议等待30分钟后重试。

❓ 如何选择合适的同步间隔？

根据你的使用频率合理设置：

• 频繁更新：1-2小时（--watch-with-interval 3600）
• 日常使用：6-12小时（--watch-with-interval 21600）
• 偶尔备份：24小时或手动运行

❓ 存储空间如何规划？

在开始下载前，建议：

1. 登录iCloud.com查看照片库总大小
2. 确保本地存储有足够空间（建议预留20%余量）
3. 考虑使用外部硬盘或NAS进行长期存储

❓ 如何处理两步验证？

icloudpd完全支持Apple的两步验证（2FA）：

• 首次使用时需要输入验证码
• 会话信息会保存在cookie目录中
• 后续运行无需重复验证

1. 循序渐进开始

首次使用建议先小批量测试：

icloudpd --directory /测试目录 --username 你的邮箱 --recent 50

2. 网络环境优化

• 使用有线网络连接提高稳定性
• 避免在高峰时段进行全量下载
• 考虑使用--skip-videos参数先下载照片

3. 文件组织策略

利用文件夹结构参数自动整理：

• {:%Y} - 按年分类
• {:%Y/%m} - 按年月分类
• {:%Y/%m/%d} - 按年月日分类

4. 定期检查维护

设置日志监控和定期检查：

• 查看运行日志确认同步状态
• 定期验证备份完整性
• 更新到最新版本获取新功能

完全开源免费：无需支付任何费用，社区活跃维护 持续更新：每周发布新版本，功能不断完善 专业可靠：经过大量用户验证，稳定可靠 灵活定制：丰富的命令行参数满足个性化需求

无论你是想要备份家庭珍贵回忆，还是优化工作照片管理流程，icloudpd都能为你提供专业、可靠的解决方案。现在就开始使用这个强大的工具，让你的数字记忆得到最好的保护！

官方文档：docs/install.md | 操作模式说明：docs/mode.md | 配置文件源码：src/icloudpd/config.py