IT博客汇 | 独立IT博客导航

诺多发表于 2024-12-26 23:00:01

icloudpd

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

🤔 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其实挺简单的，主要有这么几种方式：

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

然后运行：