icloudpd iCloud照片备份完整指南：3步跑通，零基础也能上手

icloudpd iCloud照片备份完整指南3步跑通零基础也能上手【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader换机或者清理空间时你多半发现 iCloud 相册里的照片没法一次性导出来官方网页只能一张一张下载。icloudpd 是一款命令行工具能把整个 iCloud 照片库照片、视频、RAW、实况照片批量下载到你的电脑或 NAS并且自动跳过已经下载过的文件。 什么是 icloudpd为什么用它做照片备份一句话它帮你把只存在云端的照片重新变成本地可控的文件。适合照片库很大、又不想逐张折腾的人——换手机、腾 iCloud 空间、给 NAS 留一份本地备份这几个诉求它都覆盖。上手之前先扫一眼它的能力边界三种工作模式复制默认只往本地补新照片、同步跟随云端删除本地文件、移动下载后从云端删掉腾出空间格式覆盖全JPEG、各类视频、RAW 以及 RAWJPEG 组合实况照片会拆成图片和视频两个文件内置去重与断点续传本地已有的文件自动跳过中断后重新运行不会重复下载可以只跑一次也可以常驻监控发现新照片自动下载 动手之前前置条件与环境检查装工具之前先确认这几件事。前两项不满足的话Apple 服务器会直接拒绝请求检查项怎么确认开启在网页上访问 iCloud 数据iPhone/iPad 上进入 设置 Apple 账户 iCloud确认开关已打开关闭高级数据保护同一菜单下确认该选项是关闭状态本地剩余空间照片库通常几十到几百 GB先确认目标磁盘装得下网络环境大陆网络可能需指定 .cn 域名细节见官方文档 docs/ 安装与首次运行两条命令跑起来不想折腾环境的话Docker 是最省事的路线本地已有 Python 的话一条 pip 命令就够了。下面按 pip 路线演示pip install icloudpd然后直接发起第一次下载首次运行会提示输入密码和两步验证代码icloudpd --directory Photos --username youremail.com验证代码输入通过后会话信息会保存到本地会话文件之后运行就不用再输密码了。如果你只是想确认账号能正常登录加--auth-only参数认证完成后它就直接退出。除此之外官方还提供对应平台的独立可执行文件下载或者通过 npm 安装、从源码构建按需选择即可。 典型场景拆解全量备份、持续监控、腾出云端空间下面三个场景覆盖了绝大多数用法看完基本不用查别的资料。全量备份如果你正准备换新电脑或 NAS把整个照片库迁到一台新机器上。--directory指一个空间充足的目录直接运行即可。第一次跑建议先加--recent 10只处理最近 10 个文件确认文件夹结构和命名符合预期再去掉参数跑全量想进一步确认范围可以加--dry-run做模拟运行它只汇报哪些文件会被下载不写任何文件。持续监控如果你想设置完就不用管了在命令里加上--watch-with-interval 3600它会常驻运行每小时检查一次云端发现新文件就下载没有就安静待着。这种模式很适合跑在家里服务器或 NAS 上配合 examples/ 里的定时任务示例可以进一步自动化。腾出云端空间如果你的 iCloud 快满了加上--keep-icloud-recent-days 30照片下载完成后会从云端删掉已存在的部分但保留最近 30 天的照片腾空间的同时留了余地。如果你希望本地文件也跟随云端一起删除比如你在云端整理时删过照片改用--auto-delete参数。常用参数速查参数作用--directory本地保存目录--watch-with-interval监控间隔单位秒--recent N只处理最近 N 个文件适合试跑--dry-run模拟运行不实际写入文件--keep-icloud-recent-days N移动模式下载后删除云端副本保留最近 N 天--threads-num并发下载线程数速度不满意时调大️ 排错手册首次运行报错怎么办跑起来之后最容易遇到的就是下面这几个问题对策都整理好了。首次运行报 Bad Request (400)这属于正常现象。你的账号第一次通过 API 访问 iCloudApple 服务器需要先整理照片数据可以理解为档案馆先翻一遍档案柜急不得。等 5 到 30 分钟后重新运行一般就能过半小时后仍报错先回头检查前面两个账户设置项。出现 ACCESS_DENIED 错误说明账户设置不达标要么在网页上访问 iCloud 数据没开要么高级数据保护没关。在手机上把这两个开关处理好再重试即可。之前正常突然认证失败了多数是会话文件过期导致。删除~/.local/share/icloudpd下的会话文件重新用--auth-only完成一次认证就能恢复。下载速度明显低于带宽速度受 Apple 服务器负载和网络质量影响。可以用--threads-num调大并发线程数另外错开网络高峰时段通常比高峰期快不少。⚙️ 进阶与延伸定时自动化结合 cronLinux/macOS或 Windows 任务计划程序每天凌晨自动跑一次示例脚本在 examples/cron_script.sh.example。容器化部署官方 Docker 镜像自带完整环境一条命令即可作为长期运行的备份服务NAS 上挂载目录同样适用。邮件通知配置 SMTP 后每次备份结束会收到通知邮件适合长期无人值守的场景。先用--recent 10把流程完整跑一遍确认目录结构和命名没问题再启动全量备份。全部参数说明和高级用法都可以查官方文档 docs/想研究实现原理的话核心源码在 src/icloudpd/ 目录。【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考