iCloud Photos Downloader：把 iCloud 照片全部搬回本地
文章目录
- iCloud Photos Downloader：把 iCloud 照片全部搬回本地
- 1、 这玩意儿是干嘛的
- 2、 三种工作模式
- 3、 安装和使用
- 4、 使用前的配置
- 5、 适合谁用
iCloud Photos Downloader：把 iCloud 照片全部搬回本地
icloudpd 在 GitHub 上已经拿到 12K Star。
这是一个命令行工具，专门干一件事——把 iCloud 里的照片和视频全部下载到本地。支持 Linux、Windows 和 macOS，不管是笔记本、台式机还是 NAS 都能跑。
1、 这玩意儿是干嘛的
一句话：把 iCloud 照片库里的所有东西拉到本地硬盘。
用过 iCloud 的人都知道，照片存在苹果的云上，想批量导出并不方便。网页端一张一张下，速度慢不说，还会压缩画质。icloudpd 直接走命令行，把整个照片库原样下载下来，包括 Live Photo 的图片和视频、RAW 文件、RAW+JPEG 组合，全部保留。
下载过程中自动去重，同名照片不会重复保存。
2、 三种工作模式
icloudpd 提供三种模式，对应不同的使用场景：
Copy 模式：只下载新照片，本地已有的不动。适合日常备份。
Sync 模式：下载新照片，同时删除本地那些在 iCloud 上已经被移除的文件。保持本地和云端一致。
Move 模式：下载新照片到本地，然后把 iCloud 上的照片删掉。适合做迁移，把照片从苹果生态彻底搬出来。
除了单次下载，还能设置持续监控。用--watch-with-interval参数指定轮询间隔，工具会定期检查 iCloud 有没有新照片，有就自动下载。
3、 安装和使用
安装方式有好几种，选适合自己的就行：
从 GitHub Release 页面下载对应平台的可执行文件，直接运行。
用包管理器装：Docker、PyPI、AUR、npm 都有。
或者从源码构建。
装好之后，同步整个照片库只需要一条命令：
icloudpd --directory /data --username my@email.address --watch-with-interval 3600注意可执行文件名是icloudpd，不是icloud。
首次运行需要完成两步验证。也可以单独跑一次授权流程，顺便确认 session 是否还有效：
icloudpd --username my@email.address --password my_password --auth-only4、 使用前的配置
用这个工具之前，需要在 iPhone 或 iPad 上调整两项 iCloud 设置：
打开「设置 > Apple ID > iCloud」，开启「在网页上访问 iCloud 数据」。
同一位置，关闭「高级数据保护」。
不改这两项的话，苹果服务器会返回 ACCESS_DENIED 错误。
5、 适合谁用
想把 iCloud 照片做本地备份的人，不想续费 iCloud 存储空间的人，从苹果换到安卓想把照片全部带走的人，或者需要在 NAS 上自动同步家庭照片库的场景，这个工具都能派上用场。
iCloud 存储空间的人，从苹果换到安卓想把照片全部带走的人，或者需要在 NAS 上自动同步家庭照片库的场景，这个工具都能派上用场。