icloudpd 使用指南一条命令完整备份你的 iCloud 照片库【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader照片只存在 iCloud 里就像把鸡蛋全放一个篮子里——账号受限、存储涨价、服务调整都可能让你被动。icloudpdiCloud Photos Downloader是一个开源命令行工具把 iCloud 照片库完整地下载到本地硬盘、NAS 或任何 Linux/Windows/macOS 设备上让你真正拥有自己的照片。全程只需要会敲一条命令。它适合什么样的你icloudpd 解决的是一件很具体的事把 iCloud 照片库变成你自己的本地副本。它由志愿者维护MIT 协议特点是跨平台Linux、Windows、macOS 都能跑笔记本、桌面机、NAS 均可不挑格式Live Photos 会拆成图片视频两个文件RAW 照片连同配套 JPEG 一起下载自动去重同名重复文件自动跳过重复运行不会浪费时间元数据完整拍摄时间等 EXIF 信息完整保留还可以按需补齐如果你只是想在网盘里存一份那网盘工具就够了但如果你想把照片当作真正属于自己的数字资产本地副本才是答案。三种方式把工具跑起来不需要懂编程任选一种最顺手的方式即可。方式一Docker最省心适合 NAS 用户docker run -it --rm --name icloudpd -v $(pwd)/Photos:/data icloudpd/icloudpd:latest icloudpd --directory /data --username myemail.address人话把当前目录下的Photos文件夹挂载进容器容器里直接开始下载依赖问题一概不用管。方式二PyPI适合已有 Python 环境的人pip install icloudpd装完直接在终端敲icloudpd就能用。方式三从源码构建适合想改一改的开发者git clone https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader另外还有 npm 途径npx --yes icloudpd和 AUR 包可选详细步骤见 docs/install.md。三种工作模式复制、同步、移动这是 icloudpd 最核心的设计决定了它在下载之后动手动脚的程度务必分清再上生产模式怎么开启它会做什么复制默认不加参数只把 iCloud 里新增的照片下载到本地谁都不删同步--auto-delete下载新照片的同时把 iCloud 中已删除进了最近删除相册的文件从本地也删掉本地与云端完全一致移动--keep-icloud-recent-days 30下载后把 30 天以前的老照片从 iCloud 中删除只留最近的释放云端空间注意同步和移动模式都会删除文件。第一次用请只用默认复制模式。定时自动同步与归档整理一次性备份之后你可能希望它永远保持最新。加上一个参数就能变成常驻任务icloudpd --directory /data --username myemail.address --watch-with-interval 3600人话每小时检查一次 iCloud有新照片就下载程序自己循环不退出。配合系统定时任务cron / Windows 任务计划程序即可实现全自动归档。照片落盘后的组织方式由--folder-structure控制默认就是{:%Y/%m/%d}即按年/月/日三层文件夹存放改成{:%Y/%m}只按年月分或设为none全部平铺在一个目录里。常用的精细化参数一览参数作用人话版--recent 10只下载最近 10 张用来先试水--until-found 5遇到 5 张连续已下载的照片就停止让增量运行更快--size medium下载中等尺寸而非原图省空间--skip-videos视频一概不碰只下照片--set-exif-datetime缺拍摄时间的照片用文件创建时间补上 EXIF--xmp-sidecar额外导出 XMP 旁车文件保存更多元数据--dry-run预演只打印将要做什么不实际下载或删除任何东西--mfa-provider webui在浏览器8080 端口输入密码和验证码而不是在终端里全部参数跑icloudpd --help即可看到完整清单。避坑指南先做这两件事再谈下载绝大多数连不上都不是 icloudpd 的问题而是 iCloud 账号配置没对齐开启网页访问iPhone/iPad 上进入设置 Apple ID iCloud 通过网页访问 iCloud 数据并开启关闭高级数据保护在设置 Apple ID iCloud 高级数据保护中禁用——icloudpd 模拟的是网页访问高级数据保护开启时网页通道是被禁止的Apple 服务器会直接返回 ACCESS_DENIED另外几个高频坑首次运行报Bad Request (400)通常是该账号从没通过 API 访问过Apple 服务器需要 5~10 分钟准备数据稍后再试即可超过 30 分钟仍报错才需要排查双因素验证码默认在终端输入Apple 的 MFA 授权约两个月过期过期后要重新验证。可以配--smtp-username/--smtp-password让验证过期时给你发邮件提醒认证反复失败尝试清空主目录下的.pyicloud缓存文件夹重来可执行文件名是icloudpd不是icloud后者是另一个小工具用于管理存在系统钥匙串里的密码中国大陆网络可用--domain cn参数但社区反馈效果参差不齐详见 docs/authentication.md想深入了解实现的话认证、下载、文件命名策略等核心逻辑都在 src/icloudpd/ 目录下iCloud API 封装在 src/pyicloud_ipd/。建议的起步路线别一上来就全库下载。推荐顺序先跑icloudpd --directory /data --username 你的邮箱 --recent 10只拉 10 张验证配置确认无误后加--dry-run看一眼完整库会怎么落盘最后才是正式全量备份并挂上--watch-with-interval让它长期值守。走完这三步你的照片就有了一个云端之外的、完全属于你的家。【免费下载链接】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_downloader照片只存在 iCloud 里就像把鸡蛋全放一个篮子里——账号受限、存储涨价、服务调整都可能让你被动。icloudpdiCloud Photos Downloader是一个开源命令行工具把 iCloud 照片库完整地下载到本地硬盘、NAS 或任何 Linux/Windows/macOS 设备上让你真正拥有自己的照片。全程只需要会敲一条命令。它适合什么样的你icloudpd 解决的是一件很具体的事把 iCloud 照片库变成你自己的本地副本。它由志愿者维护MIT 协议特点是跨平台Linux、Windows、macOS 都能跑笔记本、桌面机、NAS 均可不挑格式Live Photos 会拆成图片视频两个文件RAW 照片连同配套 JPEG 一起下载自动去重同名重复文件自动跳过重复运行不会浪费时间元数据完整拍摄时间等 EXIF 信息完整保留还可以按需补齐如果你只是想在网盘里存一份那网盘工具就够了但如果你想把照片当作真正属于自己的数字资产本地副本才是答案。三种方式把工具跑起来不需要懂编程任选一种最顺手的方式即可。方式一Docker最省心适合 NAS 用户docker run -it --rm --name icloudpd -v $(pwd)/Photos:/data icloudpd/icloudpd:latest icloudpd --directory /data --username myemail.address人话把当前目录下的Photos文件夹挂载进容器容器里直接开始下载依赖问题一概不用管。方式二PyPI适合已有 Python 环境的人pip install icloudpd装完直接在终端敲icloudpd就能用。方式三从源码构建适合想改一改的开发者git clone https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader另外还有 npm 途径npx --yes icloudpd和 AUR 包可选详细步骤见 docs/install.md。三种工作模式复制、同步、移动这是 icloudpd 最核心的设计决定了它在下载之后动手动脚的程度务必分清再上生产模式怎么开启它会做什么复制默认不加参数只把 iCloud 里新增的照片下载到本地谁都不删同步--auto-delete下载新照片的同时把 iCloud 中已删除进了最近删除相册的文件从本地也删掉本地与云端完全一致移动--keep-icloud-recent-days 30下载后把 30 天以前的老照片从 iCloud 中删除只留最近的释放云端空间注意同步和移动模式都会删除文件。第一次用请只用默认复制模式。定时自动同步与归档整理一次性备份之后你可能希望它永远保持最新。加上一个参数就能变成常驻任务icloudpd --directory /data --username myemail.address --watch-with-interval 3600人话每小时检查一次 iCloud有新照片就下载程序自己循环不退出。配合系统定时任务cron / Windows 任务计划程序即可实现全自动归档。照片落盘后的组织方式由--folder-structure控制默认就是{:%Y/%m/%d}即按年/月/日三层文件夹存放改成{:%Y/%m}只按年月分或设为none全部平铺在一个目录里。常用的精细化参数一览参数作用人话版--recent 10只下载最近 10 张用来先试水--until-found 5遇到 5 张连续已下载的照片就停止让增量运行更快--size medium下载中等尺寸而非原图省空间--skip-videos视频一概不碰只下照片--set-exif-datetime缺拍摄时间的照片用文件创建时间补上 EXIF--xmp-sidecar额外导出 XMP 旁车文件保存更多元数据--dry-run预演只打印将要做什么不实际下载或删除任何东西--mfa-provider webui在浏览器8080 端口输入密码和验证码而不是在终端里全部参数跑icloudpd --help即可看到完整清单。避坑指南先做这两件事再谈下载绝大多数连不上都不是 icloudpd 的问题而是 iCloud 账号配置没对齐开启网页访问iPhone/iPad 上进入设置 Apple ID iCloud 通过网页访问 iCloud 数据并开启关闭高级数据保护在设置 Apple ID iCloud 高级数据保护中禁用——icloudpd 模拟的是网页访问高级数据保护开启时网页通道是被禁止的Apple 服务器会直接返回 ACCESS_DENIED另外几个高频坑首次运行报Bad Request (400)通常是该账号从没通过 API 访问过Apple 服务器需要 5~10 分钟准备数据稍后再试即可超过 30 分钟仍报错才需要排查双因素验证码默认在终端输入Apple 的 MFA 授权约两个月过期过期后要重新验证。可以配--smtp-username/--smtp-password让验证过期时给你发邮件提醒认证反复失败尝试清空主目录下的.pyicloud缓存文件夹重来可执行文件名是icloudpd不是icloud后者是另一个小工具用于管理存在系统钥匙串里的密码中国大陆网络可用--domain cn参数但社区反馈效果参差不齐详见 docs/authentication.md想深入了解实现的话认证、下载、文件命名策略等核心逻辑都在 src/icloudpd/ 目录下iCloud API 封装在 src/pyicloud_ipd/。建议的起步路线别一上来就全库下载。推荐顺序先跑icloudpd --directory /data --username 你的邮箱 --recent 10只拉 10 张验证配置确认无误后加--dry-run看一眼完整库会怎么落盘最后才是正式全量备份并挂上--watch-with-interval让它长期值守。走完这三步你的照片就有了一个云端之外的、完全属于你的家。【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
