tcousin/icloud-photo-utils Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

iCloud照片备份与相框网页视图工具镜像

镜像概述和主要用途

本镜像为一款针对iCloud照片管理的实用工具，主要用于备份iCloud中的照片数据，并提供适配相框设备的网页视图功能，方便用户通过浏览器查看和展示iCloud照片。

核心功能和特性

• iCloud照片备份：支持自动同步并备份iCloud中的照片至本地存储，防止数据丢失
• 相框网页视图：提供简洁的网页界面，适配各类相框设备，支持照片轮播展示
• 轻量级部署：基于Docker容器化封装，部署流程简单，支持跨平台运行
• 自动同步机制：可配置定时同步策略，保持本地备份与iCloud照片库实时一致

使用场景和适用范围

• 个人用户数据备份：需要将iCloud照片备份至本地存储的个人用户
• 家庭相框展示：家庭环境中通过相框设备展示iCloud家庭共享相册照片
• 轻量级照片管理：无需复杂配置即可实现iCloud照片的网页化查看与管理
• 嵌入式设备适配：适用于低配置嵌入式相框设备，通过网页方式访问照片

详细使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 拥有有效的iCloud账号（需开启iCloud照片同步功能）
• （可选）持久化存储需求：准备本地目录用于照片备份存储

Docker部署示例

基本运行命令

bash
docker run -d \
  --name icloud-photo-frame \
  -p 8080:80 \
  -v /path/to/local/backup:/app/backup \
  -e ICLOUD_USERNAME="***" \
  -e ICLOUD_PASSWORD="your_icloud_password" \
  [镜像名称]:latest

docker-compose配置示例

yaml
version: '3.8'
services:
  icloud-photo-service:
    image: [镜像名称]:latest
    container_name: icloud-photo-frame
    restart: unless-stopped
    ports:
      - "8080:80"  # 网页视图访问端口
    volumes:
      - ./local-backup:/app/backup  # 本地备份目录挂载
    environment:
      - ICLOUD_USERNAME=***  # iCloud账号***
      - ICLOUD_PASSWORD=your_icloud_password      # iCloud账号密码
      - SYNC_INTERVAL=12h                         # 同步间隔（默认24h）
      - PHOTO_SHOW_DURATION=10s                   # 照片展示时长（默认5s）

核心配置参数说明

网页视图访问

容器启动后，通过浏览器访问 http://<主机IP>:8080 即可打开相框网页视图，支持通过页面按钮切换照片或开启自动轮播模式。

注意事项

1. 敏感信息安全：iCloud账号密码建议通过Docker Secrets或环境变量文件传入，避免明文暴露
2. 存储容量规划：持久化备份目录需预留足够存储空间，建议根据照片数量规划至少10GB以上空间
3. 网络稳定性：同步过程需保持网络通畅，弱网环境可能导致同步失败或超时
4. 账号安全：频繁登录可能触发iCloud安全验证，建议提前在设备上信任登录环境