icloudpd 五分钟完成 iCloud 照片完整备份从首次跑通到定时自动同步【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloadericloudpdiCloud Photos Downloader是一个命令行工具能把 iCloud 账户里的照片和视频全量下载到本地硬盘或 NAS适合想把苹果照片库真正掌握在自己手里、而不是长期留在云上的人。照片全在云端、Mac 存储却总告急NAS 已经跑起来了想顺手把全家 iCloud 照片库归档一份本地副本这两件事 icloudpd 都能解决——一条命令完成全量备份之后再运行只拉取增量挂上去就不用管。账户前置先在 iPhone 设置里开两个开关这两步不做Apple 服务器会直接返回 ACCESS_DENIED下载根本起不来。iPhone 上打开「设置 Apple ID iCloud 通过网页访问 iCloud 数据」把它开启在同一页面把「高级数据保护」关掉就这两个开关。前者是开启网页方式访问的钥匙后者和第三方下载工具不兼容。一次操作永久生效。 五分钟装好并跑起来主流安装方式有两种任选其一。已有 Python 环境的话一条 pip 搞定装完终端里就有icloudpd命令pip install icloudpd icloudpd --directory ~/Photos --username youexample.com在 NAS 上跑、或者不想动系统环境用 Docker 挂载目录即可。注意容器里执行的也是icloudpd这个命令不是iclouddocker run -it --rm --name icloudpd -v $(pwd)/Photos:/data \ icloudpd/icloudpd:latest icloudpd --directory /data --username youexample.com首次运行会提示输入密码开了双重认证的还会要手机上那串 6 位验证码。会话会缓存下来之后运行直接免密登录。✅ 首次验证先只下载最近 10 张第一次别直接全量备份。照片库动辄几万张先跑小批量确认账户没问题icloudpd --directory ~/Photos --username youexample.com --recent 10跑通后目录里会出现最近的 10 张照片和视频。默认目录结构按年/月/日归档会形成2024/03/15这样的层级EXIF 里的拍摄时间都会保留。 最高频的两个用法增量备份与定时同步全量备份跑完后把用法换成增量同一条命令加上--watch-with-interval 3600它会每小时检查一次 iCloud有新人照片就自动拉下来进程常驻icloudpd --directory ~/Photos --username youexample.com --watch-with-interval 3600更省事的是交给系统定时任务一天跑一次通常就够。工具是幂等的下载过的文件会自动跳过同一命令反复执行也安全0 3 * * * /usr/local/bin/icloudpd --directory /data --username youexample.com第一种适合常年开机的服务器第二种适合普通电脑。两者的底气都来自「只下载新文件」的增量逻辑。三个值得知道的进阶功能Web 登录页1.21.0 起加--password-provider webui --mfa-provider webui会在 8080 端口起一个内置网页密码和 MFA 验证码都能用浏览器填无头 NAS 上不用对着终端盲打Live Photos 拆分实况照片的图片和视频部分存成两个独立文件本地相册里能直接当普通照片用RAW 格式也原样保留自定义归档规则--folder-structure改成{:%Y}就只按年分目录设成none则全部扔进一个文件夹其中 Web 登录页最实用——很多场景下终端不方便输密码有浏览器就能完成认证。 踩坑排障三个高频现象与解法现象一输完密码报 ACCESS_DENIED大概率是开头那两个开关没开。回 iPhone 检查「通过网页访问 iCloud 数据」是否开启、「高级数据保护」是否关闭这是最高频的原因。现象二下载中途断掉、卡住不动多为网络不稳或默认超时偏短。加--http-timeout 60放宽等待时间中断后不用手动处理直接重跑同一条命令即可续传。现象三不确定会话是否还有效单独跑一条命令验证icloudpd --username youexample.com --auth-only它只建立并校验会话不下载任何文件。报错就重新走一遍认证没报错说明随时可以接着跑。今晚花五分钟把命令配好全量备份让它整晚静悄悄跑完剩下的交给每天一次的定时任务。参数细节想再深挖可以看 官方文档 和 下载引擎源码。【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
icloudpd 五分钟完成 iCloud 照片完整备份：从首次跑通到定时自动同步
icloudpd 五分钟完成 iCloud 照片完整备份从首次跑通到定时自动同步【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloadericloudpdiCloud Photos Downloader是一个命令行工具能把 iCloud 账户里的照片和视频全量下载到本地硬盘或 NAS适合想把苹果照片库真正掌握在自己手里、而不是长期留在云上的人。照片全在云端、Mac 存储却总告急NAS 已经跑起来了想顺手把全家 iCloud 照片库归档一份本地副本这两件事 icloudpd 都能解决——一条命令完成全量备份之后再运行只拉取增量挂上去就不用管。账户前置先在 iPhone 设置里开两个开关这两步不做Apple 服务器会直接返回 ACCESS_DENIED下载根本起不来。iPhone 上打开「设置 Apple ID iCloud 通过网页访问 iCloud 数据」把它开启在同一页面把「高级数据保护」关掉就这两个开关。前者是开启网页方式访问的钥匙后者和第三方下载工具不兼容。一次操作永久生效。 五分钟装好并跑起来主流安装方式有两种任选其一。已有 Python 环境的话一条 pip 搞定装完终端里就有icloudpd命令pip install icloudpd icloudpd --directory ~/Photos --username youexample.com在 NAS 上跑、或者不想动系统环境用 Docker 挂载目录即可。注意容器里执行的也是icloudpd这个命令不是iclouddocker run -it --rm --name icloudpd -v $(pwd)/Photos:/data \ icloudpd/icloudpd:latest icloudpd --directory /data --username youexample.com首次运行会提示输入密码开了双重认证的还会要手机上那串 6 位验证码。会话会缓存下来之后运行直接免密登录。✅ 首次验证先只下载最近 10 张第一次别直接全量备份。照片库动辄几万张先跑小批量确认账户没问题icloudpd --directory ~/Photos --username youexample.com --recent 10跑通后目录里会出现最近的 10 张照片和视频。默认目录结构按年/月/日归档会形成2024/03/15这样的层级EXIF 里的拍摄时间都会保留。 最高频的两个用法增量备份与定时同步全量备份跑完后把用法换成增量同一条命令加上--watch-with-interval 3600它会每小时检查一次 iCloud有新人照片就自动拉下来进程常驻icloudpd --directory ~/Photos --username youexample.com --watch-with-interval 3600更省事的是交给系统定时任务一天跑一次通常就够。工具是幂等的下载过的文件会自动跳过同一命令反复执行也安全0 3 * * * /usr/local/bin/icloudpd --directory /data --username youexample.com第一种适合常年开机的服务器第二种适合普通电脑。两者的底气都来自「只下载新文件」的增量逻辑。三个值得知道的进阶功能Web 登录页1.21.0 起加--password-provider webui --mfa-provider webui会在 8080 端口起一个内置网页密码和 MFA 验证码都能用浏览器填无头 NAS 上不用对着终端盲打Live Photos 拆分实况照片的图片和视频部分存成两个独立文件本地相册里能直接当普通照片用RAW 格式也原样保留自定义归档规则--folder-structure改成{:%Y}就只按年分目录设成none则全部扔进一个文件夹其中 Web 登录页最实用——很多场景下终端不方便输密码有浏览器就能完成认证。 踩坑排障三个高频现象与解法现象一输完密码报 ACCESS_DENIED大概率是开头那两个开关没开。回 iPhone 检查「通过网页访问 iCloud 数据」是否开启、「高级数据保护」是否关闭这是最高频的原因。现象二下载中途断掉、卡住不动多为网络不稳或默认超时偏短。加--http-timeout 60放宽等待时间中断后不用手动处理直接重跑同一条命令即可续传。现象三不确定会话是否还有效单独跑一条命令验证icloudpd --username youexample.com --auth-only它只建立并校验会话不下载任何文件。报错就重新走一遍认证没报错说明随时可以接着跑。今晚花五分钟把命令配好全量备份让它整晚静悄悄跑完剩下的交给每天一次的定时任务。参数细节想再深挖可以看 官方文档 和 下载引擎源码。【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
