怎么把 iCloud 里的照片批量下载到本地icloudpd 完整指南【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloadericloudpd 是一款免费的开源命令行工具能把你的 iCloud 照片库批量下载到本地——照片、视频、Live Photo、RAW 原片一次带走还支持按小时自动检查、同步 iCloud 新增内容到 NAS让iCloud 照片备份这件事从此不用你动手。它能帮你解决什么问题手动在 iCloud 网页上挑、下、存上万张根本做不完。icloudpd 把整件事压缩成一条命令换到你手里的实际好处是一次命令搬空整个图库登录授权后所有照片视频按年/月/日目录结构整齐落盘同名文件自动去重不会下两遍新照片自动补进来设置一个检查间隔以后每次新增的照片、视频都会被自动同步到本地或 NAS等效于一个 7×24 小时在线的 iCloud 照片同步备份本地与 iCloud 保持一致支持三种模式——只下载Copy、删除本地已删文件Sync、甚至下完从 iCloud 删掉腾空间Move详见 docs/mode.md原片不缩水默认下载原始尺寸RAW、RAWJPEG、Live Photo 都完整保留想要更小的版本也可以指定跨平台Windows、macOS、Linux笔记本、台式机、NAS 上都能跑最快上手两条命令完成首次批量下载推荐路径是 pip 安装一条命令装好之后升级也只需重复同一行pip install icloudpd icloudpd --directory ~/iCloud_Backup \ --username 你的邮箱 \ --password 你的应用专用密码 \ --watch-with-interval 3600首次运行会进入 Apple 的登录校验如果开了双重认证终端会提示你输入手机上收到的验证码完成后会话信息会缓存在本机之后每次运行就不用再输。如果你更习惯容器化部署比如跑在 NAS 上项目提供官方 Docker 镜像配合挂载目录即可docs/nas.md 里有 TrueNAS、Synology 的逐字段配置示例偶尔用一次的话也可以直接用npx --yes icloudpd临时调用。关键参数拆解真正会用到的 5 个icloudpd --help全部参数都能查到这里但日常 90% 的场景只需要下面几个参数作用备注--directory照片下载到哪个本地目录不填默认当前目录--username/--password你的 Apple ID 和应用专用密码应用专用密码在 Apple 账户的登录与安全性里生成不是账号密码--watch-with-interval持续运行每隔 N 秒检查一次新增3600 每小时不加则下载完一次即退出--recent只下载最近 N 张首次试跑、空间规划时非常好用--until-found从最新往前下直到遇到连续 N 张已下载过的增量补档比全量扫描快得多另外两个偶尔会用到--folder-structure控制目录结构默认年/月/日设成none就全部平铺--auto-delete开启 Sync 模式把 iCloud 里已删除的照片从本地一并清掉。按你的场景选玩法场景一一次性把老照片全部迁到本地第一次跑之前先用小批量验证配置icloudpd --username 你的邮箱 --directory ~/iCloud_Backup --recent 2020 张确认目录、命名、画质都符合预期后去掉--recent跑全量即可。全量过程中断网、断电都不怕——再次运行会跳过已存在的文件从断点继续。场景二iCloud 自动备份到 NAS带上--watch-with-interval 3600工具进入常驻模式每小时自动把新增内容同步进 NAS。想更进一步加上--auto-delete就是严格镜像iCloud 里删掉的本地也删掉或者用--keep-icloud-recent-days让已下载的旧照片从 iCloud 删除、只保留最近 N 天的直接省出宝贵的 50GB 空间。场景三定时任务代替常驻不喜欢进程一直挂着可以交给 cron 每天跑一次配合--until-found让增量运行尽量快icloudpd --username 你的邮箱 --directory /mnt/photos \ --recent 500 --until-found 100仓库里有一份可直接参考的脚本examples/cron_script.sh.example。场景四空间规划视频往往是体积大头。可以先只下图片看看总量加--skip-videos或者用--size medium先拉中档版本文件名会带-medium后缀原始文件不受影响大小选择逻辑见 docs/size.md。建议给目标磁盘留出图库 1.2 倍以上的余量。常见卡点速解登录时报 ACCESS_DENIED这是 iCloud 侧的两个开关问题——iPhone 上开启设置 Apple ID iCloud 在 Web 上访问 iCloud 数据并关闭高级数据保护。改完再试。认证失败 / 会话失效确认用的是应用专用密码而非主密码双因素认证按终端提示输入验证码即可。单独运行icloudpd --username 你的邮箱 --auth-only可以只刷新登录态、验证会话是否有效完整流程见 docs/authentication.md。首次运行报 400 或等待很久新会话首次访问 Apple 服务器需要时间准备数据等 30 分钟左右再重试一般会自动恢复。现在就动手备份这件事最好的时机是读完这篇的此刻。先在终端里敲一条--recent 20的测试命令看着自己前二十张照片落进本地目录的那一刻剩下的就是交给--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），仅供参考