企业官网建设流程全解析

一条命令把 iCloud 照片批量下到本地：icloudpd 使用教程

【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader

换了新手机后，几千张照片还留在 iCloud 里。你想把它们存到本地硬盘，却找不到批量下载入口。icloudpd 是一个免费的开源命令行工具，专门做 iCloud 照片备份：执行一条命令，它自动登录账号，把照片、视频、Live Photo 全部落到本地。

它到底在做什么

你只负责执行一条命令。它会用你的 Apple ID 登录 iCloud，然后拿本地已有的文件和云端清单做比对：本地有的直接跳过，缺的才拉下来。跑完后还能定期复查新照片。整个过程不需要手动挑选，也不需要手动复制文件。

📥 三步完成第一次备份

第一步：准备

• 在 iPhone 上开启"在网页上访问 iCloud 数据"：设置 > Apple 账号 > iCloud。不开这个，苹果服务器会直接返回 ACCESS_DENIED。
• 关闭"高级数据保护"。开启后网页访问被禁用，icloudpd 无法工作。
• 预留足够的本地空间。照片库越大占的容量越多，开了 RAW 的会明显更大。

第二步：认证

先执行下面这条命令，完成 Apple ID 登录。如果开了两步验证，会提示你输入一次验证码：

icloudpd --username 你的邮箱 --password 你的密码 --auth-only

这一步只验证身份，不搬运任何文件。两步验证会话大约 2 个月内有效，过期后重新执行这条命令即可。详见认证文档。

第三步：启动下载

认证通过后，加上保存路径和检查间隔，正式开跑：

icloudpd --directory /data --username 你的邮箱 --watch-with-interval 3600

常用参数不用背，需要时查这张表就行：

想看具体实现，可以翻一翻核心下载逻辑。

⚖️ 三种模式怎么选

模式之外还有两个机制，日常用起来更省心。一是自动去重：同名文件会被识别出来，已经下过的照片直接跳过，不会重复占空间。二是按日期自动建目录：文件按年份、月份归类，找哪天的照片直接翻文件夹。全部参数见参考文档。

🎯 哪些人适合用它

• 普通家庭用户：照片库攒了好几年，担心手机丢失或套餐到期。用增量备份把全部照片落到家庭 NAS，每次有新照片都自动跟一次。
• 摄影师：客户用 RAW 格式经 iCloud 共享素材。用 icloudpd 把 RAW 和 JPEG 自动归档进工作目录，不用逐张翻找。
• NAS 玩家：把 icloudpd 部署在 NAS 上后台常驻，按固定间隔自动完成增量备份，不占主力机资源，参考NAS 文档。

⚠️ 第一次用会踩的坑

1. 首次运行报 ACCESS_DENIED→ 没开"在网页上访问 iCloud 数据"，或开着高级数据保护 → 按前面"准备"一节把两项设置改好，再重试。
2. 首次运行卡住或报错→ iCloud 服务器在为你整理照片清单，需要时间 → 等 30 分钟后再跑，通常就能恢复。
3. 担心本地磁盘不够用→ 照片库里混着 RAW、Live Photo，实际体积比预期大 → 先用--recent 20小批量试跑，或加--dry-run看看会下载什么。尺寸怎么选见大小文档。
4. 不知道监控间隔设多长→ 间隔太短可能触发苹果侧限流 → 日常使用设 3600 秒（1 小时）即可，不常更新设 86400 秒（24 小时）也够。
5. 用了一段时间突然认证失败→ 苹果两步验证会话约 2 个月到期 → 重跑icloudpd --auth-only刷新会话，详见认证文档。

收尾

把 iCloud 照片备份从手工活变成一条命令的事。下一步：先跑一遍icloudpd --auth-only，确认认证没问题再正式下载。

【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader