文章目录iCloud Photos Downloader把云端照片搬回本地的命令行工具iCloud Photos Downloader把云端照片搬回本地的命令行工具iCloud 是苹果生态里用得最多的云服务之一照片存在上面方便归方便但想批量下载到本地就没那么顺畅了。网页端只能一张张勾选官方也没有提供好用的批量导出方案。iCloud Photos Downloader 就是为解决这个问题而生的一个开源的命令行工具专门用来把 iCloud 照片库完整下载到本地。这个项目在 GitHub 上拿到了 12000 多个 star说明需求确实存在。它能做什么核心功能就一个从 iCloud 下载照片到本地磁盘。但围绕这个核心工具提供了三种工作模式Copy 模式是默认行为只下载 iCloud 上有但本地没有的新照片。Sync 模式更进一步除了下载新照片还会把本地那些在 iCloud 上已经被删除的文件也一并清理掉。Move 模式则反过来下载完成后会把 iCloud 端的照片删除相当于把照片从云端搬到本地。除了普通的 JPEG 和 HEIC工具对 Live Photos 的处理比较到位会把图片和视频拆成两个独立文件保存。RAW 格式也在支持范围内包括 RAWJPEG 这种组合。照片重名的问题也考虑到了工具会自动去重不会因为文件名相同就重复下载。跨平台和安装方式工具支持 Linux、Windows 和 macOS 三个平台。安装方式有四种选择直接从 GitHub Release 页面下载对应平台的可执行文件通过 PyPI 用 pip 安装通过 AUR 在 Arch Linux 上安装或者用 Docker 容器运行。npm 也支持前端开发者会比较熟悉这个渠道。对于 NAS 用户来说Docker 方式可能是最省心的拉个镜像挂上目录就能跑。使用方式工具的命令行参数比较直观。最基本的用法指定下载目录、用户名和密码就行。如果想让它持续监控 iCloud 的变化可以加上 watch-with-interval 参数设置一个检查间隔工具会定期拉取新增照片。对于增量下载有两个实用参数until-found 会在找到指定数量的已下载文件后停止recent 则只下载最近 N 天的照片。这两个参数在首次全量下载后的日常同步场景下很有用能避免每次都扫描整个照片库。工具还支持只做认证不下载方便验证账号登录状态是否正常或者在另一台机器上先完成两步验证的流程。使用前的准备工具能正常工作的前提是 iCloud 账号做了相应设置。需要在 iPhone 或 iPad 上开启通过网页访问 iCloud 数据这个选项同时关闭高级数据保护。如果这两个设置没配好苹果服务器会返回 ACCESS_DENIED 错误。这个限制来自苹果的服务端工具本身没法绕过。适合谁用这个工具的典型用户画像很清晰照片存在 iCloud 上但想要一份本地备份或者想把照片迁移到其他存储方案的人。命令行的方式决定了它的目标用户偏技术向普通消费者可能更习惯图形界面的操作。不过对于有自动化需求的场景比如定时备份到 NAS命令行工具反而是最合适的选择。配合 cron 或者系统的定时任务完全可以实现无人值守的定期同步。项目目前在寻找新的维护者代码仓库的活跃度还在但长期来看需要有人接手持续开发。对于想参与开源项目的开发者来说这是一个规模适中、功能明确的项目上手门槛不算高。手持续开发。对于想参与开源项目的开发者来说这是一个规模适中、功能明确的项目上手门槛不算高。