icloudpd：一个可以把iCloud中的照片同步到NAS的极品工具！

大家好啊！最近在折腾NAS的时候，发现了一个超好用的工具，叫icloudpd。这玩意儿简直就是iCloud照片同步的神器，今天就来和大家聊聊它。

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

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

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

1. 📱 跨平台：不管你用的是Linux、Windows还是macOS，它都能跑。
2. 🔄 多种同步模式：

• 📥 下载新照片：默认模式，只下载iCloud上新增的照片。
• 🔄 同步模式：不仅下载新照片，还会删除本地已经在iCloud上删除的照片。
• 🚚 搬运模式：下载新照片后，直接从iCloud上删除。慎用哦！
• 🎬 支持Live Photos：会把Live Photos的图片和视频分开下载。
• 📸 RAW图片支持：支持RAW格式，包括RAW+JPEG。
• 🕵️ 自动去重：防止重复下载同名照片。
• 👀 持续监控：可以设置定期检查iCloud变化。
• 🔧 灵活安装：可以直接下载可执行文件，也可以用Docker、PyPI等包管理器安装。

🚀 怎么用icloudpd？

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

1. 直接下载可执行文件

可在文末获取下载方式，下载对应的平台可执行文件，并将文件改名为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: 同步的间隔时间，可以自己修改

2. 用包管理器安装

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

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

💡 使用小贴士

1. 可执行文件方式

如果你的账号开启了MFA的话，在首次使用时，设备会继续弹出验证码，把这个验证码输入到命令中：

如果你的账号开启了MFA的话，设备会继续弹出验证码，把这个验证码输入到命令中：

此后就会看到已经开始进行同步了：

2. Docker方式

启动Docker容器后，在浏览器输入ip:8080，输入你的iCloud账号密码：

输入密码后，同样也是允许登录并继续输入验证码：

最后可以看到工具已经在后台默默同步你的iCloud照片啦！

🎉 总结

总的来说，icloudpd这个工具真的挺好用的。特别是对于经常需要在iCloud和本地同步照片的朋友，简直就是福音。它不仅操作简单，而且功能强大，能满足大多数人的需求。