iCloud Photos Downloader如何把整库 iCloud 照片下载到本地备份【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloaderiCloud Photos Downloader命令行程序名为icloudpd是一个开源的 iCloud 照片备份工具它把 iCloud 里的照片、视频完整下载到本地磁盘。如果你担心云端数据丢失或者想把照片存到自己的 NAS 上这类 iCloud 照片备份工具就是为此设计的。准备工作账户设置与两种安装方式先完成 iCloud 账户侧的两项设置否则工具无法登录在 iPhone 或 iPad 上打开「设置 Apple ID iCloud 通过网页访问 iCloud 数据」。工具本质上是模拟网页登录所以这项必须开启。关闭「高级数据保护」。开启该功能后网页访问会被禁用icloudpd因此无法工作。安装方式挑一个即可pip install icloudpd如果你不熟悉 Python 环境用 Docker 更省事依赖全部打包在容器里docker run -it --rm --name icloudpd -v $(pwd)/Photos:/data icloudpd/icloudpd:latest icloudpd --directory /data --username youremail.address第一次完整备份一条命令下载整库icloudpd --directory ~/Photos --username youremail.address第一次运行会提示输入密码如果账号开了两步验证还会要求输入一次验证码。下载完成后用ls ~/Photos和du -sh ~/Photos确认照片数量和总大小是否合理。建议正式整库下载前先加--recent 10参数只取最近 10 张试跑确认认证、路径都没问题再跑全量。照片会保留 EXIF 元数据拍摄时间、地理位置等Live Photo 会拆成照片加视频两个文件RAW 图也会完整下载。同步策略按你的目的选模式icloudpd有三种运行模式详见 docs/mode.md选择依据不是功能清单而是你希望本地和云端保持什么关系只想备份不动任何东西默认就是复制模式。只下载本地没有的照片已下载的会自动跳过重复运行不会产生重复文件。本地要和云端保持一致加--auto-delete。云端移到「最近删除」相册里的文件本地对应文件也会被删掉。注意这会真实删除本地文件先想清楚再开。想给 iCloud 腾空间加--keep-icloud-recent-days 30。下载过的照片会从 iCloud 中删除但最近 30 天的保留在云端。这是三种模式里唯一会修改云端数据的。想按日期分文件夹可加--folder-structure {:%Y/%m}把 2024 年的照片放进 2024/01 这样的目录不想下视频就加--skip-videos。无人值守定时任务与 NAS 部署加--watch-with-interval 3600后工具不会跑完就退出而是每 3600 秒重新检查一次 iCloud有新增照片就自动下载适合常驻后台。配合系统定时任务可以做到全自动。Linux/macOS 的 crontab 里加一行项目也提供了 examples/cron_script.sh.example 参考脚本0 2 * * * icloudpd --directory ~/Photos --username youremail.address --watch-with-interval 3600Windows 用户用任务计划程序做同样配置即可。NAS 场景推荐 Docker 部署TrueNAS、群晖均可把宿主机磁盘挂载为/data。从 1.21.0 版开始还带一个 Web 界面在浏览器里输入密码和 MFA 验证码不用敲命令行具体用法见 docs/webui.md。避坑指南常见问题速查认证失败确认已开启网页访问、关闭高级数据保护仍失败时删除用户主目录下的.pyicloud缓存文件夹后重试。登录过期两步验证令牌约两个月失效需要重新输入验证码。下载频繁中断先查网络稳定性可加大并发--threads-num或降低线程数缓解。空间不足用du -sh查目录占用配合--skip-videos跳过体积最大的视频。想看详细报错加--log-level debug输出完整日志核心逻辑在 src/icloudpd/ 目录排查参数行为时可对照源码。iCloud Photos Downloader 把整库备份这件事压缩成了几条命令行装好、跑一次、配个定时任务剩下的交给它。【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考