企业官网建设流程全解析

icloudpd 教程：5分钟把 iCloud 照片完整备份到本地

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

icloudpd 是一款把 iCloud 照片备份与下载一次搞定的开源命令行工具，它把整个照片库批量下载到你的电脑或 NAS。支持 Windows、macOS 和 Linux，自动跳过已下载的照片，一条命令就能开始。本文带你完成安装、认证、模式选择和常见故障排查。

它解决什么问题

• 照片全在云端，手机丢了、账号停了，回忆就没了。
• 网页端只能一张张另存为，几万张照片根本存不完。
• 本地备份希望跟着新照片自动更新，不想每次手动操作。

🚀 icloudpd 怎么装：5分钟跑起来

安装主推两种：本机有 Python 就用 pip；没有就拉 Docker 镜像，两者都很快。

pip install icloudpd

Docker 用户执行docker pull icloudpd/icloudpd即可，也可以直接下载对应平台的可执行文件运行。首次运行前，请在 iCloud 账户中开启"在网页上访问 iCloud 数据"并关闭"高级数据保护"，否则会直接报 ACCESS_DENIED。然后用--auth-only完成首次登录：

icloudpd --username your-email@example.com --password your-password --auth-only

认证成功后会保存会话文件，下次运行不再要求输入密码。

复制、同步、移动：三种模式怎么选

• 复制（默认）：只下载 iCloud 里的新照片，本地文件一律不动。适合：只想稳妥做本地备份的人。
• 同步：加--auto-delete，iCloud 里删掉的照片也会从本地删除。适合：要求本地和云端完全一致的人。
• 移动：加--keep-icloud-recent-days 30，下载后 iCloud 只保留最近 30 天，更早的从云端删除。适合：想腾出 iCloud 空间的人。

高频参数速查

• --auth-only：只做登录认证并保存会话，专门用来排查登录问题。
• --watch-with-interval 3600：持续运行，每 3600 秒检查一次 iCloud 新照片。
• --dry-run：模拟运行，只列出会下载什么，不写盘、不动 iCloud。
• --auto-delete：开启同步模式，让本地与云端双向一致。
• --recent 100：只下载最近 100 张，适合第一次小批量试跑。
• --threads-num：并发下载线程数，调大可加快批量下载速度。

去重默认开启：本地已有同名文件就跳过，像门卫看到已有门票的人，直接拦下不让进。

两个真实场景

iCloud 照片批量下载到 NAS

把下载目录指到 NAS 共享文件夹，然后让 icloudpd 以监控模式常驻：

icloudpd --directory /data/Photos --username your-email@example.com --watch-with-interval 3600

再配合 NAS 的定时任务（可参考 examples/cron_script.sh.example），全家人每天拍的照片都会自动落到 NAS，不需要任何手动操作。

摄影师团队素材同步

团队素材放进共享 iCloud 图库后，工作站用--size original拉取原始质量，RAW 照片会以 RAW+JPEG 成对落盘。加上定时监控，每个成员随时能拿到最新的原始素材。

⚠️ 出问题时先查这 4 件事

1. 首次运行报错：iCloud 还在准备你的照片数据，等约 30 分钟再试，别急着下结论。
2. 担心磁盘不够：先加--dry-run估算待下载的文件量，再决定是否扩容。
3. 下载太慢：用--threads-num加大并发线程数试试。
4. 认证失败：删掉主目录下.pyicloud文件夹里的会话文件，再跑一次--auth-only重新认证。

收尾

先跑通认证，再让它在后台常驻，备份就基本成型了。更多配置见 docs/，实现细节可翻 src/icloudpd/。今晚就把你的照片备份起来。

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