修复 iCloud Drive 同步错误——如何使用 RcloneView 解决
rclone 中的 iCloud Drive 支持需要特定的设置。以下介绍如何诊断在 RcloneView 中使用 iCloud 时出现的身份验证失败、版本不匹配和连接错误问题。
iCloud Drive 是使用 rclone 配置时较为复杂的云存储提供商之一，因为 Apple 的身份验证依赖于 Apple ID 凭据，并且可能涉及双重身份验证挑战。RcloneView 通过内置的 rclone 后端处理此问题，但要让 iCloud 正常工作，需要满足一些前提条件。本指南将带你了解最常见的故障点。
在一个地方管理和同步所有云端
RcloneView 是 rclone 的跨平台 GUI。通过清爽的可视化界面比较文件夹、传输或同步文件，并自动化多云工作流。
- 一键作业：复制 · 同步 · 比较
- 调度器与历史记录，实现可靠的自动化
- 支持 Google Drive、OneDrive、Dropbox、S3、WebDAV、SFTP 等
核心功能免费。Plus 提供自动化功能。
前提条件：需要 rclone v1.69 或更高版本
iCloud Drive 支持是在 rclone v1.69 中引入的。如果你看到类似 unknown provider type: iclouddrive 或 remote type not found 的错误，说明你内置的 rclone 版本过旧。在 RcloneView 中，可以在窗口底部的页脚栏查看当前的 rclone 版本。如果显示的版本低于 v1.69.1，请使用帮助标签页 → 检查更新来更新到最新的内置 rclone。
RcloneView 内置了较新的 rclone 二进制文件，但如果你运行的是较旧的 安装版本，触发一次自我更新即可完全解决此类错误。
身份验证失败与 Apple ID 双重验证
通过远程标签页 → 新建远程添加 iCloud Drive 时，RcloneView 会提示你输入 Apple ID（邮箱）和密码。如果你启用了双重身份验证——Apple 现在对大多数账户都要求启用——系统还会提示你输入出现在受信任 Apple 设备上的双重验证代码。请在远程配置向导中出现提示时输入该代码。
此阶段常见的错误包括 INVALID_EMAIL（请确认你的 Apple ID 邮箱地址是否正确）、AUTHENTICATION_FAILED（如果你的 Apple 账户启用了增强安全性，可能需要使用专用密码），以及在双重验证提示未及时响应时出现的超时错误。如果 Apple 对你的账户强制要求使用专用密码，请前往 appleid.apple.com 生成一个，并用它代替常规密码。
列表加载缓慢或文件显示不完整
iCloud Drive 使用按需存储机制，这意味着文件可能仅存储在 iCloud 中，而未下载到本地。通过 rclone 浏览时，尚未在 Mac 上本地缓存的文件可能显示元数据有限，或加载耗时更长。这是正常现象——iCloud 必须从 Apple 的服务器检索文件元数据。
如果文件夹列表显示不完整，请尝试刷新面板（按 F5 或从右键菜单中选择重新加载）。对于较大的 iCloud 资料库，可在任务设置中将相等性检查器数量设置为较低的值（2–4），以降低 rclone 在比较操作期间对 iCloud API 的请求频率。
快速上手
- 从 rcloneview.com 下载 RcloneView。
- 通过页脚栏确认你内置的 rclone 版本为 v1.69.1 或更高。
- 配置远程时使用你的 Apple ID 和双重验证代码（或专用密码）。
- 如果遇到列表加载缓慢或超时问题，请降低检查器并发数。
正确配置后，iCloud Drive 便可顺畅地融入你的 RcloneView 工作流程，用于备份和跨云传输。
相关指南：
- 使用 RcloneView 管理 iCloud Drive 云同步
- 修复 RcloneView 中 macOS 打开文件过多的错误
- RcloneView 在 macOS Sonoma 上的云同步与备份
支持的云服务商
