3 步完成 iCloud 照片备份icloudpd 完整使用指南【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloadericloudpd 是一个开源命令行工具专门用于把 iCloud 照片库完整下载到本地完成 iCloud 照片备份。如果你希望把手机里的照片导出到本地硬盘或 NAS而不是逐张手动挑选这份指南会带你从账户设置、安装验证到日常自动运行走一遍完整流程。一、iCloud 备份前置设置开工前先把开关调好icloudpd 的工作原理是模拟浏览器访问 iCloud所以账户有两项设置必须先确认否则 Apple 服务器会直接返回 ACCESS_DENIED在 iPhone / iPad 上进入设置 Apple ID iCloud 通过网页访问 iCloud 数据开启该选项。在同一页面找到高级数据保护将其关闭。该功能开启后网页访问被禁用icloudpd 无法读取照片。确认当前网络可以正常打开 iCloud 网站网络不稳会导致下载反复中断。这两项开关不满足时任何命令都会失败所以建议先调开关再装工具。二、三步装好并跑通iCloud 照片下载命令三种安装方式任选其一各只需一条最简命令。方式一Docker 容器适合 NAS 和不想配置 Python 环境的用户docker run -it --rm --name icloudpd -v $(pwd)/Photos:/data icloudpd/icloudpd:latest icloudpd --directory /data --username youremail.address方式二pip 安装需要本机已装 Pythonpip install icloudpd方式三从源码构建git clone https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader cd icloud_photos_downloader pip install -e .装好后先用--recent参数做小批量验证只处理最近 10 条素材icloudpd --directory /data --username youremail.address --recent 10跑通的判断标准终端走完认证流程首次需输入密码开启双重验证的账户还要输入验证码/data目录下出现按日期命名的子文件夹文件数量与--recent指定值一致。另外首次运行若报Bad Request (400)通常只是 Apple 服务器尚未为该账户准备好照片数据等 5~10 分钟重试即可。三、按需求选一种用法三种同步模式三种模式的区别在于本地与 iCloud 不一致时如何处理分别对应三类使用场景。只备份不同步Copy默认模式适用首次完整备份或只想把 iCloud 新增照片同步到本地两边互不干扰。icloudpd --directory /data --username youremail.address风险提示该模式从不删除任何文件基本没有误操作风险。本地与云端严格一致Sync 模式适用把本地硬盘当作 iCloud 照片库的镜像云端移入最近删除的素材本地也要删除。icloudpd --directory /data --username youremail.address --auto-delete风险提示--auto-delete会同步删除本地文件开启前请先确认本地另有备份。下载并释放 iCloud 空间Move 模式适用iCloud 容量不够想把老照片搬回本地云端只保留最近 30 天。icloudpd --directory /data --username youremail.address --keep-icloud-recent-days 30风险提示下载成功或确认本地已存在的素材会从 iCloud 删除建议先用小范围跑一轮再放开天数。四、让它自己一直跑定时任务与断点续传持续监控最省心的方式是让 icloudpd 常驻运行按固定间隔检查 iCloud 变化icloudpd --directory /data --username youremail.address --watch-with-interval 3600上例表示每小时检查一次。间隔不宜设得太短文档提示过短的间隔可能触发 Apple 侧限流。如果不想维持常驻进程可用系统定时任务代替。以 Linux 的 cron 为例仓库 examples/ 目录提供了参考脚本下面这条规则每天凌晨 2 点运行只处理最近 500 条素材单次开销很小0 2 * * * icloudpd --directory /data --username youremail.address --recent 500关于断点续传icloudpd 每次运行都会先比对本地已有文件只下载缺失的部分。因此长任务中断后不必重头开始把中断前的命令原样再跑一遍即可想进一步减少重复检查的 I/O 开销可以加--until-found参数。文件夹层级用--folder-structure调整。默认按{:%Y/%m/%d}以年/月/日建目录改成{:%Y/%m}则只到月份设为none表示所有文件放在同一目录。五、出错时按这个顺序查按症状 → 最可能原因 → 对应处理的顺序排查效率最高认证失败ACCESS_DENIED 或反复要求输密码→ 最可能是前置设置未到位先回第一节核对网页访问开关和高级数据保护偶发的认证错误可尝试清除~/.pyicloud目录后重试。下面这条命令可单独验证会话是否正常icloudpd --username youremail.address --auth-only下载中断、速度骤降→ 最可能是网络波动。把中断前的命令原样重跑已完成文件会自动跳过重跑前可加--dry-run参数只检查、不下载确认配置无误后再正式执行。空间不足→ 先用系统命令确认目录实际占用du -sh /data确需腾空间时加--skip-videos跳过视频能显著缩小下载量。全部参数的准确说明见 docs/reference.md。六、进阶下载策略与元数据下载内容和元数据处理都可用参数裁剪按需组合即可只要照片不要视频--skip-videos控制尺寸--size original默认、--size medium、--size thumb指定尺寸在 iCloud 不存在时会回落到 original时间戳缺失的照片--set-exif-datetime将拍摄时间写入 EXIF需要额外元数据--xmp-sidecar为每张照片生成 XMP 侧车文件两个实用细节密码默认在终端交互式输入不建议直接写在命令行里账户开启双重验证时可加--mfa-provider webui让 icloudpd 在本机 8080 端口启动网页改用浏览器输入密码和验证码NAS 远程场景下尤其方便。核心源码位于 src/icloudpd/ 目录想理解或修改行为可从那里入手。七、现在就可以做的第一步如果你只有 5 分钟就做两件事在 iPhone 上确认通过网页访问 iCloud 数据已开启、高级数据保护已关闭然后任选一种方式装好 icloudpd用--recent 10跑一次最小验证看到/data目录里出现第一张下载下来的照片整条 iCloud 照片备份链路就算打通了。【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
3 步完成 iCloud 照片备份：icloudpd 完整使用指南
3 步完成 iCloud 照片备份icloudpd 完整使用指南【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloadericloudpd 是一个开源命令行工具专门用于把 iCloud 照片库完整下载到本地完成 iCloud 照片备份。如果你希望把手机里的照片导出到本地硬盘或 NAS而不是逐张手动挑选这份指南会带你从账户设置、安装验证到日常自动运行走一遍完整流程。一、iCloud 备份前置设置开工前先把开关调好icloudpd 的工作原理是模拟浏览器访问 iCloud所以账户有两项设置必须先确认否则 Apple 服务器会直接返回 ACCESS_DENIED在 iPhone / iPad 上进入设置 Apple ID iCloud 通过网页访问 iCloud 数据开启该选项。在同一页面找到高级数据保护将其关闭。该功能开启后网页访问被禁用icloudpd 无法读取照片。确认当前网络可以正常打开 iCloud 网站网络不稳会导致下载反复中断。这两项开关不满足时任何命令都会失败所以建议先调开关再装工具。二、三步装好并跑通iCloud 照片下载命令三种安装方式任选其一各只需一条最简命令。方式一Docker 容器适合 NAS 和不想配置 Python 环境的用户docker run -it --rm --name icloudpd -v $(pwd)/Photos:/data icloudpd/icloudpd:latest icloudpd --directory /data --username youremail.address方式二pip 安装需要本机已装 Pythonpip install icloudpd方式三从源码构建git clone https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader cd icloud_photos_downloader pip install -e .装好后先用--recent参数做小批量验证只处理最近 10 条素材icloudpd --directory /data --username youremail.address --recent 10跑通的判断标准终端走完认证流程首次需输入密码开启双重验证的账户还要输入验证码/data目录下出现按日期命名的子文件夹文件数量与--recent指定值一致。另外首次运行若报Bad Request (400)通常只是 Apple 服务器尚未为该账户准备好照片数据等 5~10 分钟重试即可。三、按需求选一种用法三种同步模式三种模式的区别在于本地与 iCloud 不一致时如何处理分别对应三类使用场景。只备份不同步Copy默认模式适用首次完整备份或只想把 iCloud 新增照片同步到本地两边互不干扰。icloudpd --directory /data --username youremail.address风险提示该模式从不删除任何文件基本没有误操作风险。本地与云端严格一致Sync 模式适用把本地硬盘当作 iCloud 照片库的镜像云端移入最近删除的素材本地也要删除。icloudpd --directory /data --username youremail.address --auto-delete风险提示--auto-delete会同步删除本地文件开启前请先确认本地另有备份。下载并释放 iCloud 空间Move 模式适用iCloud 容量不够想把老照片搬回本地云端只保留最近 30 天。icloudpd --directory /data --username youremail.address --keep-icloud-recent-days 30风险提示下载成功或确认本地已存在的素材会从 iCloud 删除建议先用小范围跑一轮再放开天数。四、让它自己一直跑定时任务与断点续传持续监控最省心的方式是让 icloudpd 常驻运行按固定间隔检查 iCloud 变化icloudpd --directory /data --username youremail.address --watch-with-interval 3600上例表示每小时检查一次。间隔不宜设得太短文档提示过短的间隔可能触发 Apple 侧限流。如果不想维持常驻进程可用系统定时任务代替。以 Linux 的 cron 为例仓库 examples/ 目录提供了参考脚本下面这条规则每天凌晨 2 点运行只处理最近 500 条素材单次开销很小0 2 * * * icloudpd --directory /data --username youremail.address --recent 500关于断点续传icloudpd 每次运行都会先比对本地已有文件只下载缺失的部分。因此长任务中断后不必重头开始把中断前的命令原样再跑一遍即可想进一步减少重复检查的 I/O 开销可以加--until-found参数。文件夹层级用--folder-structure调整。默认按{:%Y/%m/%d}以年/月/日建目录改成{:%Y/%m}则只到月份设为none表示所有文件放在同一目录。五、出错时按这个顺序查按症状 → 最可能原因 → 对应处理的顺序排查效率最高认证失败ACCESS_DENIED 或反复要求输密码→ 最可能是前置设置未到位先回第一节核对网页访问开关和高级数据保护偶发的认证错误可尝试清除~/.pyicloud目录后重试。下面这条命令可单独验证会话是否正常icloudpd --username youremail.address --auth-only下载中断、速度骤降→ 最可能是网络波动。把中断前的命令原样重跑已完成文件会自动跳过重跑前可加--dry-run参数只检查、不下载确认配置无误后再正式执行。空间不足→ 先用系统命令确认目录实际占用du -sh /data确需腾空间时加--skip-videos跳过视频能显著缩小下载量。全部参数的准确说明见 docs/reference.md。六、进阶下载策略与元数据下载内容和元数据处理都可用参数裁剪按需组合即可只要照片不要视频--skip-videos控制尺寸--size original默认、--size medium、--size thumb指定尺寸在 iCloud 不存在时会回落到 original时间戳缺失的照片--set-exif-datetime将拍摄时间写入 EXIF需要额外元数据--xmp-sidecar为每张照片生成 XMP 侧车文件两个实用细节密码默认在终端交互式输入不建议直接写在命令行里账户开启双重验证时可加--mfa-provider webui让 icloudpd 在本机 8080 端口启动网页改用浏览器输入密码和验证码NAS 远程场景下尤其方便。核心源码位于 src/icloudpd/ 目录想理解或修改行为可从那里入手。七、现在就可以做的第一步如果你只有 5 分钟就做两件事在 iPhone 上确认通过网页访问 iCloud 数据已开启、高级数据保护已关闭然后任选一种方式装好 icloudpd用--recent 10跑一次最小验证看到/data目录里出现第一张下载下来的照片整条 iCloud 照片备份链路就算打通了。【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
