下载整个 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 照片备份与下载支持 Linux、macOS 和 Windows。能力与边界支持项限制前置条件✅ 批量下载照片与视频含 RAW、Live Photos--threads-num已弃用实际单线程运行开启「在网页上访问 iCloud 数据」⚠️ Copy / Sync / Move 三种模式--auto-delete与--delete-after-download不能共用已完成首次认证✅ 多账号、多配置并行下载同一--username后的选项只对该账号生效为每个账号指定独立--directory⚠️ 中国大陆账号--domain cn效果因账号而异网络可达 iCloud 服务⚠️ 长期监控运行MFA 约 2 个月过期需重新认证会话文件存放于~/.pyicloud❌ FIDO 硬件密钥账号此类账号无法登录— 获取按你的运行环境选一条路径Python 环境pip install icloudpd容器环境docker pull icloudpd/icloudpd # 运行时用 docker run -v 把本地目录挂载到 /data源码环境git clone https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader详见仓库 README 构建章节。▶️ 第一次跑通已开启「在网页上访问 iCloud 数据」iPhone设置 Apple 账号 iCloud已关闭「高级数据保护」ADPicloudpd --version能输出版本号说明命令已在 PATH 中icloudpd --username youremail.com --password yourpassword --directory ~/Photos/icloud--usernameApple ID 邮箱开启一组新的用户配置--passwordiCloud 密码可省略默认按 参数 → keyring → 控制台 顺序取密码--directory照片下载到的本地目录不存在会自动创建确认认证与下载成功日志先出现Authentication completed successfully随后每个文件依次打印Downloading ...与Downloaded ...运行结束后~/Photos/icloud下会按日期子目录排列出照片文件默认--folder-structure为{:%Y/%m/%d}年/月/日。首次运行若报Bad Request (400)通常是 Apple 服务端在准备你的照片数据等待 5–10 分钟再试即可。 按目标分轨轨道 A一次性全量拉取命令目标把整个库一次性落到本地。icloudpd --username youremail.com --directory ~/Photos/full --folder-structure {:%Y/%m}--folder-structure子目录格式{:%Y/%m}表示按年/月建目录设为none则全部平铺在单一目录默认下载original尺寸只想要编辑后的版本可加--size adjusted轨道 B日常增量同步参数目标机器常驻新照片出现即拉取。icloudpd --username youremail.com --directory ~/Photos/icloud --watch-with-interval 3600 --until-found 5--watch-with-interval无限循环运行每 3600 秒跑一轮--until-found连续发现 5 张已下载照片即结束本轮加速增量默认 Copy 模式只下载新文件要同步 iCloud「最近删除」中的删除动作加--auto-delete轨道 C按尺寸、数量与类型筛选目标只取一部分文件。icloudpd --username youremail.com --directory ~/Photos/preview --skip-videos --recent 500 --size medium--skip-videos跳过全部视频与--skip-photos互斥--recent只下载最近 500 张--size尺寸取值 original / medium / thumb / adjusted / alternative可重复指定 故障速查现象最可能原因处置首次运行报Bad Request (400)Apple 服务端在准备照片数据需 5–10 分钟等待后重跑30 分钟仍未恢复见项目 issuesACCESS_DENIED/ 认证失败未开启网页访问或 ADP 仍开启设备上关闭 ADP、开启网页访问详见docs/authentication.md停在Two-factor authentication is required (2fa)MFA 验证码未提供或已过期控制台输入设备验证码或改用--mfa-provider webui反复出现认证错误过期的 cookie / 会话状态删除~/.pyicloud目录后重跑--auth-only大陆网络下登录失败iCloud.com 被阻断追加--domain cn详见docs/authentication.md⚙️ 调优与自动化两条最实用的调优参数--until-found 5增量运行时连续发现 5 张已下载照片即提前结束缩短列表遍历时间--recent 500照片库很大时每次只拉 500 张避免单次运行过长定时运行crontab -e添加一行每天凌晨 3 点做一次增量拉取0 3 * * * icloudpd --username youexample.com --directory ~/Photos/icloud️ 源码地图src/icloudpd/cli.py— 解析全部命令行参数组装每个用户的配置src/icloudpd/base.py— 逐张照片的过滤、下载、去重编排src/icloudpd/download.py— 把单个资源写入本地文件并创建目录树src/icloudpd/authentication.py— 密码、2FA、2SA 的交互流程src/pyicloud_ipd/— 与 iCloud Photos API 的通信层 延伸入口docs/install.md— Docker / PyPI / AUR / npm 完整安装说明docs/authentication.md— 认证流程、多因素认证与大陆访问docs/mode.md— Copy / Sync / Move 三种模式定义docs/size.md— 尺寸选择与 RAW 处理规则下次要换机或退订存储前先跑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），仅供参考