iCloud照片下载器：一键备份你的珍贵回忆 ✨
【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/gh_mirrors/ic/icloud_photos_downloader
想要轻松备份iCloud中的所有照片和视频吗？iCloud照片下载器（icloudpd）正是你需要的专业工具。这款免费的开源软件支持Linux、Windows和macOS系统，让你轻松将iCloud中的珍贵回忆下载到本地存储。
🚀 快速上手：选择最适合你的安装方式
Docker安装（推荐）
Docker是最简单方便的安装方式，适合所有用户：
docker run -it --rm --name icloudpd \ -v $(pwd)/Photos:/data \ -e TZ=Asia/Shanghai \ icloudpd/icloudpd:latest \ icloudpd --directory /data --username 你的邮箱地址 --watch-with-interval 3600参数说明：
-v $(pwd)/Photos:/data：将当前目录下的Photos文件夹映射到容器内-e TZ=Asia/Shanghai：设置时区为上海--watch-with-interval 3600：每小时自动同步一次
Windows用户注意：
- 使用
%cd%替代$(pwd) - 或者直接使用完整路径，如
-v c:/photos/icloud:/data - 仅支持Linux容器
Python包安装
适合已有Python环境的用户：
pip install icloudpd安装完成后使用：
icloudpd --directory /data --username 你的邮箱地址 --watch-with-interval 3600各平台配置：
Windows：
pip install icloudpd --user安装完成后将提示的脚本目录添加到系统PATH环境变量中。
macOS：需要将/Users/用户名/Library/Python/版本/bin添加到PATH环境变量中。
其他安装选项
Arch Linux用户：
yay -S icloudpd-bin临时使用（npm方式）：
npx --yes icloudpd --directory /data --username 你的邮箱地址 --watch-with-interval 3600💡 核心功能亮点
智能同步模式
- 复制模式：下载iCloud中的新照片（默认模式）
- 同步模式：下载新照片并删除本地已移除的文件
- 移动模式：下载照片并从iCloud中删除
全面格式支持
- Live Photos（图片和视频分开保存）
- RAW图像（包括RAW+JPEG组合）
- 自动去重功能，避免重复下载
🔧 常见问题解决方案
首次运行报错400
首次使用时可能会遇到"Bad Request (400)"错误，这是因为：
- 你的iCloud账户首次使用API接口
- Apple服务器需要时间准备照片数据（通常5-10分钟）
解决方法：等待30分钟后重试。如果仍然报错，请提供完整的错误信息。
📋 使用建议
- 长期使用：推荐Docker方式，便于管理和更新
- 临时需求：可选择npm或直接下载二进制文件
- 合理间隔：设置适当的同步间隔，避免频繁请求
- 时区设置：确保照片按正确日期分类
通过以上简单的安装步骤，你就可以开始备份iCloud中的珍贵照片了。选择最适合你的方式，让数据备份变得简单高效！
【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/gh_mirrors/ic/icloud_photos_downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
