mandarons/icloud-drive

icloud-docker 镜像文档

概述

icloud-docker是一个Docker化的iCloud客户端/服务镜像，旨在提供便捷的容器化方式运行iCloud相关功能。该镜像封装了iCloud客户端核心组件，支持在各类Docker环境中部署，简化iCloud服务的配置与管理流程，适用于需要容器化iCloud访问的个人用户或开发环境。

核心功能与特性

• 容器化部署：基于轻量级基础镜像构建，资源占用低，部署便捷
• 数据持久化：支持通过卷挂载保存配置文件与同步数据，确保容器重启后数据不丢失
• Web界面访问：部分版本可能集成Web管理界面，便于通过浏览器配置和监控iCloud服务
• 灵活配置：通过环境变量和配置文件支持自定义同步规则、账户信息等参数
• 跨平台兼容：可在Linux、Windows（WSL2）、macOS等支持Docker的系统中运行

使用场景

• 个人用户在服务器或NAS设备上通过Docker容器运行iCloud客户端，实现文件同步
• 开发/测试环境中快速部署iCloud服务依赖组件
• 多环境一致性部署，避免本地安装iCloud客户端带来的系统依赖问题

使用方法

快速启动（docker run）

通过以下命令快速启动容器，需替换<your-icloud-email>等占位符为实际信息：

bash
docker run -d \
  --name icloud-client \
  -e ICLOUD_EMAIL=<your-icloud-email> \
  -e ICLOUD_PASSWORD=<your-icloud-app-specific-password> \
  -v /path/to/local/data:/app/data \
  -v /path/to/local/config:/app/config \
  docker.xuanyuan.run/mandarons/icloud-docker:latest

参数说明：

• -d：后台运行容器
• --name icloud-client：指定容器名称
• -e：设置环境变量（账户信息等）
• -v：挂载本地目录至容器，分别用于数据持久化和配置存储

Docker Compose配置

创建docker-compose.yml文件，配置如下：

yaml
version: '3'
services:
  icloud:
    image: docker.xuanyuan.run/mandarons/icloud-docker:latest
    container_name: icloud-client
    environment:
      - ICLOUD_EMAIL=your-icloud-email@example.com
      - ICLOUD_PASSWORD=your-app-specific-password
      - SYNC_INTERVAL=300  # 同步间隔（秒），默认300
    volumes:
      - ./local/data:/app/data
      - ./local/config:/app/config
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置参数

环境变量

卷挂载路径

注意事项

• 安全提示：iCloud密码建议使用应用专用密码（需在Apple ID设置中生成），避免直接使用主密码
• 网络要求：容器需联网访问Apple iCloud服务，确保网络环境允许访问相关域名
• 数据备份：本地挂载目录需定期备份，以防数据丢失
• 版本更新：升级镜像前建议备份配置文件，避免配置不兼容问题
• Web界面访问：若启用Web UI，需通过-p 8080:8080映射端口（如docker run命令中添加-p 8080:8080），并通过http://localhost:8080访问

故障排除

• 容器启动失败：检查环境变量是否正确设置，尤其是***和密码
• 同步异常：查看容器日志（docker logs icloud-client）定位问题，确认网络连接和账户权限
• Web界面无法访问：检查端口映射是否正确，以及WEB_UI_ENABLED是否设为true