icloudpd 使用教程iCloud 照片视频如何备份到本地【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloadericloudpd 是一个开源的命令行工具能把 iCloud 账户里的照片和视频库批量下载到本地磁盘支持 Windows、macOS 和 Linux。它的仓库名为 icloud_photos_downloader本文面向零基础的新手按安装、认证、定时同步的顺序讲清 icloudpd 的完整用法。 它解决什么问题云端照片没有本地副本账户异常或订阅到期后照片可能无法访问icloudpd 下载后的文件完全属于自己释放 iCloud 空间支持移动模式旧照片下载完成后从 iCloud 删除只保留近几天的照片开源且运行在本地照片不经过任何第三方服务器Windows、macOS、Linux 乃至 NAS 都能跑增量同步重复运行时只下载新照片已存在的文件自动跳过 安装三种方式按人群任选其一装完后命令都叫icloudpdpip机器上已有 Python 环境的人pip install icloudpd装完终端直接就能用Docker想装在 NAS、服务器或不想污染系统环境的人docker run -it --rm --name icloudpd -v $(pwd)/Photos:/data icloudpd/icloudpd:latest icloudpd --directory /data --username youexample.com把本地文件夹挂载进容器即可npm前端开发者免安装直接跑npx --yes icloudpd --directory /data --username youexample.comnpx 会自动拉取最新版执行 首次运行前置条件在 iPhone 或 iPad 上开启设置 Apple ID iCloud 在网页上访问 iCloud 数据并关闭高级数据保护Advanced Data Protection一种端到端加密模式否则 Apple 服务器会返回 ACCESS_DENIED 错误。认证测试icloudpd --username youexample.com --password your-password --auth-only该命令只做登录并把会话信息保存到~/.pyicloud不下载任何文件账户开启双重认证时会提示输入验证码。认证成功后后续运行不再需要输入密码双重认证约两个月过期一次。小批量验证icloudpd --directory ~/iCloudPhotos --username youexample.com --recent 10--recent 10只检查最近加入 iCloud 的 10 个资产用来确认目录结构和文件能正常打开再开始完整备份。首次运行若报 Bad Request (400)等 5~10 分钟重试即可那是 Apple 服务端在为你的图库准备数据。 参数速查参数作用什么时候用--directory指定下载根目录每次运行必写--recent N只处理最近加入 iCloud 的 N 个资产初次试跑、控制下载量--watch-with-interval N常驻运行每 N 秒检查一次 iCloud 变化想要持续自动同步--size选择下载的文件尺寸如original要原图或想省空间时--dry-run试算只报告差异不下载、不修改任何文件正式跑之前验证参数其余参数RAW 格式、文件夹结构、多账号等完整列表见 docs/reference.md也可以在终端执行icloudpd --help查看。 按需求选方案家庭多账号一条命令依次处理多个账户每个账户的照片落到各自文件夹icloudpd --cookie-directory ./cookies \ --username dadapple.com --directory ./dad \ --username kidapple.com --directory ./kid会话文件按账户名区分所以共用一个 cookie 目录不会冲突。摄影师原图icloudpd --directory ~/Work/Originals \ --username proapple.com --size original \ --set-exif-datetime --threads-num 8--size original下载原始尺寸文件--set-exif-datetime把拍摄时间写进图片 EXIF--threads-num 8用 8 个线程并行下载加快速度。RAW 文件的处理规则见 docs/raw.md。轻量备份icloudpd --directory ~/Photos/Backup \ --username youexample.com --recent 100 --skip-videos只取最近 100 个资产并跳过视频几分钟内就能完成一轮适合先建立日常小批量备份的习惯。 排障手册认证失败现象报 ACCESS_DENIED或反复要求重新登录处理先确认在网页上访问 iCloud 数据已开启、高级数据保护已关闭仍失败则删除主目录下的.pyicloud会话缓存重新执行认证测试下载速度慢现象大图库进度条推进缓慢处理把并行度提高到--threads-num 8日常增量同步可加--until-found 10连续 10 个文件本地已存在就提前停止省去全量核对存储空间不足现象下载中途因磁盘写满而中断处理先加--dry-run跑一遍统计待下载资产的数量和体积再把--directory指向外置硬盘或 NAS 上的大目录⏰ 自动化推荐用 cron 定时任务仓库已附示例脚本 examples/cron_script.sh.example内容如下pgrep -f icloudpd exit 0 icloudpd /data/photos \ --username youexample.com \ --recent 500 --auto-deletepgrep那一行防止上一轮还没跑完时重复启动--recent 500每轮只核对最近 500 个资产--auto-delete让本地文件跟随 iCloud最近删除相册同步删掉。用crontab -e加入一行0 3 * * * /path/to/script.sh即每天凌晨 3 点自动执行。如果选择 Docker 部署则把--watch-with-interval 3600放进容器命令常驻运行每小时自查一次无需系统级定时。邮件通知只需加一组参数即可在双重认证到期时收到提醒icloudpd --username youexample.com \ --smtp-username smtpexample.com --smtp-password app-password \ --smtp-host smtp.example.com --smtp-port 587 \ --notification-email receiveexample.com 继续深入文档docs/install.md 安装细节含 macOS 二进制的放行步骤、docs/authentication.md 认证与多因子细节、docs/mode.md Copy/Sync/Move 三种模式、docs/reference.md 全部参数源码src/icloudpd/cli.py 命令行参数定义、src/icloudpd/download.py 下载主流程、src/pyicloud_ipd/ 与 iCloud 服务通信的接口层最小可行第一步先跑--auth-only确认账户能登录再加--recent 10下载 10 个最近资产并确认文件可打开。这两步通过后再决定目录规划和定时策略整条备份链路就算跑通了。【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考