icloudpd 保姆级教程：iCloud 照片备份到本地的 5 个实操要点

icloudpd 保姆级教程iCloud 照片备份到本地的 5 个实操要点【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader照片视频全堆在 iCloud一旦断网、换机或账号临时出问题翻老照片就得干等。icloudpd 是一个跨平台的命令行工具只做一件事把 iCloud 里的照片和视频批量备份到本地磁盘适合想把家庭照片、工作底稿都存进硬盘或 NAS 的你。 能力速览它能替你解决什么你卡住的点icloudpd 的解法全库几万张太大不知道从哪下手增量模式只补云端新增的文件本地已有的自动跳过同名文件反复下载、互相覆盖内置去重策略冲突文件用尺寸或资产 ID 区分下完想腾出 iCloud 空间Move 模式确认后从云端删除可保留最近 N 天只想要原图或修图版--size可选 original / medium / adjusted也支持 RAW长任务不想守着--watch-with-interval常驻轮询自动抓新照片 跑通之前账户设置与安装工具能连上 Apple 服务器前提是你的账户满足两条设置在 iPhone/iPad 的 设置 Apple ID iCloud 里开启在网页上访问 iCloud 数据Access iCloud Data on the Web关闭高级数据保护icloudpd 模拟的是网页访问高级数据保护会直接挡住它返回 ACCESS_DENIED环境依赖三选一装过 Python 的走 pip装了 Docker 的走容器习惯 Node 的走 npx。任选其一复制即可跑第一条命令。pip install icloudpddocker run -it --rm --name icloudpd -v $(pwd)/Photos:/data icloudpd/icloudpd:latest icloudpd --directory /data --username 你的邮箱example.comnpx --yes icloudpd --directory ./Photos --username 你的邮箱example.com 五分钟跑通首次备份先验证登录。它只负责认证并把会话保存到本地不碰任何照片icloudpd --username 你的邮箱example.com --password 你的密码 --auth-only若开了两步验证按提示输入收到的验证码即可。只备份最近几张快速看效果。--recent按加入 iCloud 的时间取最新的 X 张icloudpd --directory ./Photos --username 你的邮箱example.com --recent 10打开./Photos文件默认按年/月/日分层存放。看到文件名和图片能正常打开说明整条链路通了。 按角色抄作业家庭多账号一台机器统管。把每个家庭成员的账户依次挂在--username后面各自落到独立目录一次命令全部拉取icloudpd --username 爸爸example.com --directory ./家人/爸爸 --username 妈妈example.com --directory ./家人/妈妈--username后紧跟的--directory只对该账户生效。摄影师要原图和拍摄时间。原图尺寸 回写 EXIF 拍摄时间 多线程序icloudpd --directory ./工作底片 --username 你的邮箱example.com --size original --set-exif-datetime --threads-num 6--size original默认就是原图--set-exif-datetime只在文件缺拍摄时间时补写--threads-num用来提高并发下载线程数。只想先存最近的图个省心。跳过视频、限定最近数量icloudpd --directory ./照片备份 --username 你的邮箱example.com --recent 200 --skip-videos 报错对号入座现象首次运行报Bad Request (400)。原因该账户此前没用过 iCloud APIApple 需要先在服务端准备照片信息。处理等 5–10 分钟再试超过 30 分钟仍报错就带着完整输出提 issue。现象返回ACCESS_DENIED。原因没开在网页上访问 iCloud 数据或高级数据保护仍开着。处理回账户设置开启前者、关闭后者再重跑。现象反复认证失败、会话异常。原因本地缓存的旧会话/ cookie 冲突。处理删掉用户主目录下的.pyicloud文件夹重新--auth-only认证。现象跑着跑着要重新输验证码。原因两步验证令牌约两个月过期属正常。处理重新认证即可或配置邮件通知见下节提前收到过期提醒。 让它自动干活定时轮询加上--watch-with-interval常驻运行工具会按秒数间隔反复检查 iCloud 变化适合 NAS 上长期挂着跑。配一条 cron每天固定时间拉起0 3 * * * icloudpd --directory /备份/照片 --username 你的邮箱example.com --watch-with-interval 3600适合不想手动管、让机器自己盯着的人。邮件通知认证过期时不想靠肉眼看日志配好 SMTP 就能收到提醒。参数有--smtp-username、--smtp-password、--smtp-host、--smtp-port收件地址用--notification-email默认发给 SMTP 账户本人。适合长期挂机、但希望异常能第一时间知道的人。 文档与源码坐标docs/install.md各平台安装与运行方式docs/authentication.md认证、两步验证、密码与多因子提供方docs/mode.mdCopy / Sync / Move 三种工作模式docs/size.md尺寸参数 original / medium / adjusted 说明src/icloudpd/download.py下载主流程实现src/icloudpd/cli.py全部命令行参数定义落地清单账户设置已开启网页访问、关闭高级数据保护--auth-only通过认证--recent小批量下载并核对目录按需加--watch-with-interval或邮件通知先把最小链路跑通再决定要不要上定时或常驻一步步来不会错。【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考