发布于 2025-01-06 10:08

🤔 icloudpd：功能丰富的照片同步利器

icloudpd，全名iCloud Photos Downloader，是一个命令行工具，专门用来下载和同步iCloud上的照片。说白了，就是帮你把iCloud上的照片自动同步到本地的好帮手，如果你手里正好有一台NAS，那么搭配这款工具使用，简直不要太香。

它有这么几个特点和功能：

📱 跨平台：不管你用的是Linux、Windows还是macOS，它都能跑。

🔄 多种同步模式：

    📥 下载新照片：默认模式，只下载iCloud上新增的照片。

    🔄 同步模式：不仅下载新照片，还会删除本地已经在iCloud上删除的照片。

    🚚 搬运模式：下载新照片后，直接从iCloud上删除。慎用哦！

🎬 支持Live Photos：会把Live Photos的图片和视频分开下载。

📸 RAW图片支持：支持RAW格式，包括RAW+JPEG。

🕵️ 自动去重：防止重复下载同名照片。

👀 持续监控：可以设置定期检查iCloud变化。

🔧 灵活安装：可以直接下载可执行文件，也可以用Docker、PyPI等包管理器安装。

🚀 怎么用icloudpd？

使用icloudpd其实挺简单的，主要有这么几种方式：

直接下载可执行文件

可在文末获取下载方式，下载对应的平台可执行文件，并将文件改名为icloudpd（不改也行，就是比较长而已），然后执行以下命令开始同步：

chmod 777 icloudpd

./icloudpd --username your@email.address --directory /data/photos --domain cn --watch-with-interval 3600

参数说明：

your@email.address: 你的icloud账号邮箱

/data/photos：本地文件保存的目录，按你自己的实际情况修改

cn : 国区账号需添加此参数，外区不需要

interval 3600: 同步的间隔时间，可以自己修改

用包管理器安装

如果你喜欢用包管理器，可以试试这个：

pip install icloudpd

icloudpd --username your@email.address --directory /data/photos --domain cn --watch-with-interval 3600
3. Docker部署（推荐）

对于喜欢用Docker的朋友，我强烈推荐这种方式。既简单又好管理。
Docker CLI方式：

docker run -it --name icloudpd
--restart unless-stopped
-v $(pwd)/Photos:/data
-e TZ=Asia/Shanghai
icloudpd/icloudpd:latest
icloudpd --directory /data --username your@email.com --mfa-provider webui --domain cn --password-provider webui --watch-with-interval 3600

Docker Compose方式：

创建一个docker-compose.yml文件，内容如下：

services:
icloudpd:
image: docker.ifuck.me/icloudpd/icloudpd:latest
container_name: icloudpd
restart: unless-stopped
network_mode: bridge
tty: true
ports:
- "8080:8080"
volumes:
- ./Photos:/data
environment:
- TZ=Asia/Shanghai
command: icloudpd --directory /data --username your@email.com --mfa-provider webui --domain cn --password-provider webui --watch-with-interval 3600

然后运行：

docker-compose up -d
端口可以换
💡 使用小贴士