bushari/icloud_photos_downloader

iCloud Photos Downloader Docker镜像

镜像概述

本镜像将ndbroadbent开发的iCloud照片下载命令行工具打包为Docker镜像，方便用户在Docker环境中快速使用该工具，实现从iCloud下载照片到本地的功能。

核心功能

• 命令行方式下载所有iCloud照片；
• 支持跨平台运行（Mac、Linux、Windows）；
• 多次运行可自动下载新增照片；
• 可选择下载尺寸（original/medium/thumb），默认原始尺寸；
• 支持下载最近的若干张照片；
• 支持自动删除iCloud“最近删除”文件夹中的文件；
• 支持SMTP邮件通知双因素认证过期。

使用场景

• Mac用户开启“优化Mac存储”后，需将全分辨率照片备份到Linux PC；
• 希望将iCloud照片备份到本地硬盘，用于Plex等媒体服务器展示幻灯片；
• 需要定期自动下载iCloud照片以保持本地备份更新。

配置说明

认证

• 双因素认证：若账户开启双因素认证，运行时会提示输入验证码，有效期约2个月，过期需重新认证；
• 系统密钥环：可通过icloud命令将密码存储到系统密钥环，避免每次输入密码：

  bash
  icloud --username=your_email@apple.com
  

  若需删除密钥环中的密码：

  bash
  icloud --username=your_email@apple.com --delete-from-keyring
  

Docker部署示例

构建镜像

bash
git clone https://github.com/ndbroadbent/icloud_photos_downloader.git
cd icloud_photos_downloader/docker
docker build -t icloud_photos_downloader .

运行镜像

bash
docker run -it --rm --name icloud -v $(pwd)/Photos:/data docker.xuanyuan.run/icloud_photos_downloader ./download_photos.py \
    --username=your_email@apple.com \
    --password=your_password \
    --size=original \
    --recent 500 \
    --auto-delete \
    /data

常见问题

首次运行可能出现Bad Request (400)错误，通常是Apple服务器正在准备数据，等待5-10分钟后重试即可。 若30分钟后仍报错，建议在GitHub仓库提交issue反馈。