icloudpd 完整安装教程5 种方式快速备份 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 都适用。你该选哪种安装方式先花 10 秒判断自己属于哪一类能少走弯路想长期定时同步、或跑在 NAS 上→ 用 Docker环境完全隔离升级最省心。机器上已经装了 Python→ 直接pip装最快。只是临时拉一次照片→ 用npx装完即走不留残留。只装了 Arch Linux→ 走 AUR一条命令搞定。macOS 上不想折腾依赖→ 下原生二进制加个执行权限就能跑。对照表如下按你的环境对号入座安装方式适合人群覆盖平台Docker长期定时同步、跑在 NAS 上Windows / macOS / LinuxPyPIpip已有 Python 环境全平台npmnpx临时用一次全平台AURArch Linux 用户Arch / Manjaro原生二进制macOS 不想装依赖macOS含 Intel / Apple 芯片主推路径Docker 一行命令持续同步Docker 方式把工具、依赖、运行环境全打包进一个容器你本机装不装 Python 都无所谓也是 NAS 用户的首选。下面按装 → 配参数 → 跑起来 → 验证四步走。第 1 步准备容器运行时。Windows 和 macOS 直接装 Docker Desktop 即可Linux 用系统自带包管理器装 docker 引擎和客户端NAS 则按厂商文档装 Docker 并起容器。第 2 步理解这条命令里每个参数在干什么。下面这条命令做三件事把你本机的Photos文件夹映射进容器、把照片按东八区时区归类、每小时自动检查一次新增照片。docker run -it --rm --name icloudpd \ -v $(pwd)/Photos:/data \ -e TZAsia/Shanghai \ icloudpd/icloudpd:latest \ icloudpd --directory /data --username 你的邮箱 --watch-with-interval 3600逐个参数说明-v $(pwd)/Photos:/data把当前目录下的Photos文件夹挂进容器的/data下载结果就落在这里。-e TZAsia/Shanghai指定时区决定照片按哪个时区建年/月文件夹跨时区归档很重要。--directory /data告诉工具在容器内往哪个目录存。--username 你的邮箱换成你的 Apple ID 邮箱。--watch-with-interval 3600保持进程常驻每 3600 秒1 小时检查一次新照片只拉增量避免高频请求。第 3 步跑起来。回车后会进入交互流程按提示输入 Apple ID、密码必要时完成双重验证。看到日志里开始列出并下载照片就说明连上了。第 4 步验证结果。回到本机Photos文件夹确认出现了按日期命名的子目录和图片文件再执行下面这条能打印出完整参数列表即代表安装无误docker run -it --rm icloudpd/icloudpd:latest icloudpd --help其他平台最快上手不想用容器下面各给一条最短可用命令挑你的平台照抄即可。macOSpip 或原生二进制有 Python 的话一条命令装完直接跑pip install icloudpd icloudpd --directory ~/icloud-photos --username 你的邮箱 --watch-with-interval 3600装完若提示command not found把安装输出里给出的那个bin路径加进 PATH 即可。更零依赖的做法是下原生二进制Intel 版Apple 芯片也能跑从 Release 页面下载后给它执行权限再运行。chmod x icloudpd-版本号-macos-amd64 ./icloudpd-版本号-macos-amd64 --helpmacOS 第一次运行会拦你去系统设置 → 隐私与安全性里点仍要允许再跑一次点打开之后就能正常用了。Windowspip --user 装一次在cmd或 PowerShell 里执行--user表示装到当前用户目录、不污染系统pip install icloudpd --user icloudpd --directory C:\Photos\iCloud --username 你的邮箱 --watch-with-interval 3600若提示找不到命令把安装结束时打印的...\Scripts目录加进系统 PATH再新开一个终端窗口即可。提示执行入口是icloudpd不是icloud敲错会报不是内部或外部命令。Arch LinuxAUR 一条命令用 AUR 助手如 yay一行装好预编译包yay -S icloudpd-bin icloudpd --directory ~/icloud-photos --username 你的邮箱 --watch-with-interval 3600不装助手的话手动构建的最后一步是makepkg -sirc先拿到对应的 AUR 源码包再执行。装完不会用3 类常见报错与处理报错不可怕把症状对到原因基本一步就能解决。① 首次运行报Bad Request (400)意味着什么你的账户是头一次通过 API 访问Apple 服务器还没把照片清单准备好。怎么办等 5–10 分钟后重跑超过 30 分钟仍报错再带上完整日志去提 issue。②icloudpd找不到命令 / 不是内部或外部命令意味着什么命令目录不在 PATH或你敲成了icloud。怎么办确认二进制名叫icloudpd并把 pip 输出里给的ScriptsWindows或Library/Python/.../binmacOS目录加进 PATH 后新开终端。③ACCESS_DENIED拒绝访问意味着什么iCloud 侧的权限开关没打开Apple 直接拒了连接。怎么办在 iPhone/iPad 上打开设置 → Apple ID → iCloud开启在网页上访问 iCloud 数据并关闭高级数据保护然后重试。让照片持续留在本地装好之后--watch-with-interval会让它常驻并只拉新增配合定时任务就是你自己的照片自动备份机。想改同步行为、目录结构或认证方式直接看对应模块核心下载逻辑在 src/icloudpd/download.py命令行入口在 src/icloudpd/cli.py配置管理在 src/icloudpd/config.py认证流程在 src/icloudpd/authentication.py。更多参数跑icloudpd --help就能查到。【免费下载链接】icloud_photos_downloaderA command-line tool to download photos from iCloud项目地址: https://gitcode.com/GitHub_Trending/ic/icloud_photos_downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考