iCloud照片下载工具icloud_photos_downloader安装指南
【免费下载链接】icloud_photos_downloader A command-line tool to download photos from iCloud 项目地址: https://gitcode.com/gh_mirrors/ic/icloud_photos_downloader
工具简介
icloud_photos_downloader（简称icloudpd）是一个专业的命令行工具，用于从iCloud照片库中批量下载照片和视频。该工具支持多种安装方式，可以满足不同操作系统用户的需求。
安装方式概览
icloudpd提供了以下几种安装方式：
直接下载预编译的可执行文件使用各平台的包管理器安装从源代码构建
各平台详细安装方法
Docker方式安装
Docker是最推荐的安装方式，具有环境隔离、依赖管理简单等优点。
基本命令示例：
docker run -it --rm --name icloudpd \
-v $(pwd)/Photos:/data \
-e TZ=Asia/Shanghai \
icloudpd/icloudpd:latest \
icloudpd --directory /data --username 你的邮箱地址 --watch-with-interval 3600
参数说明：
-v $(pwd)/Photos:/data：将当前目录下的Photos文件夹映射到容器内的/data目录-e TZ=Asia/Shanghai：设置时区为上海（可根据需要修改）--watch-with-interval 3600：每小时自动同步一次
Windows用户注意：
使用%cd%替代$(pwd)或者直接使用完整路径，如-v c:/photos/icloud:/data仅支持Linux容器
PyPI方式安装（Python包）
适合已经配置Python环境的用户。
安装命令：
pip install icloudpd
使用命令：
icloudpd --directory /data --username 你的邮箱地址 --watch-with-interval 3600
各平台特殊配置：
Windows用户：
pip install icloudpd --user
安装完成后，需要将提示的脚本目录（类似C:\Users\用户名\AppData\Roaming\Python\Python版本\Scripts）添加到系统PATH环境变量中。
macOS用户： 需要将/Users/用户名/Library/Python/版本/bin添加到PATH环境变量中。
AUR方式安装（Arch Linux）
Arch Linux用户可以通过AUR仓库安装。
手动安装步骤：
git clone AUR仓库地址
cd icloudpd-bin
makepkg -sirc
使用yay等AUR助手安装：
yay -S icloudpd-bin
npm方式安装
适合Node.js用户临时使用：
npx --yes icloudpd --directory /data --username 你的邮箱地址 --watch-with-interval 3600
macOS原生二进制文件
macOS用户可以直接下载预编译的二进制文件：
下载适用于macOS的二进制文件到本地目录添加可执行权限：chmod +x icloudpd-版本号-macos-amd64首次运行时，macOS会阻止执行，需要在"系统设置"-"隐私与安全"中手动允许再次运行时点击"打开"确认之后即可正常使用
常见问题解决
首次运行报错400
首次运行时可能会遇到"Bad Request (400)"错误，这是因为：
你的iCloud账户首次使用API接口Apple服务器需要时间准备照片数据（通常5-10分钟）
解决方法： 等待30分钟后重试。如果仍然报错，请提供完整的错误信息寻求技术支持。
使用建议
对于长期使用的用户，推荐Docker方式，便于管理和更新临时使用的用户可以选择npm或直接下载二进制文件设置合理的同步间隔（--watch-with-interval参数），避免频繁请求注意时区设置，确保照片按正确日期分类
通过以上安装方式，你可以轻松地将iCloud中的照片和视频下载到本地，实现数据备份和管理的需求。
【免费下载链接】icloud_photos_downloader A command-line tool to download photos from iCloud 项目地址: https://gitcode.com/gh_mirrors/ic/icloud_photos_downloader