使用 Cyberduck 连接并同步 Drive

Cyberduck 是适用于 macOS 和 Windows 的免费开源文件传输工具。它原生支持 WebDAV，提供简洁的图形界面，处理大型上传时优于系统文件管理器。如果 Finder 或 Windows 文件资源管理器处理大文件较慢，建议使用 Cyberduck 桌面客户端。

连接信息

Cyberduck 的“打开连接”对话框需要以下信息，URL 会被拆分到两个字段：

如果尚未生成设备密码，请先前往同步设备创建。

开始之前

你需要一个设备密码。同步应用使用独立的一次性密码，与控制面板登录密码不同。

1. 在 TrekMail 控制面板打开同步设备。
2. 点击**+ 添加新设备**。
3. 输入名称，例如 Mac, Cyberduck。
4. 保持查看文件和编辑文件为选中状态。
5. 点击生成密码并复制密码 (dsync_...)。

安装 Cyberduck

• **macOS：**从 cyberduck.io 下载，或运行 brew install --cask cyberduck。
• **Windows：**从 cyberduck.io 下载并运行安装程序。

软件免费，捐赠提示可忽略。

连接 Drive

1. 打开 Cyberduck。
2. 点击工具栏中的打开连接，或选择文件 → 打开连接…。
3. 在协议列表中选择加密的 WebDAV (HTTP/SSL)。务必选择 HTTP/SSL，不要选择会以未加密方式发送密码的普通 HTTP。
4. 填写以下信息：
   • **服务器：**粘贴同步设备中的完整 Drive 服务器 URL，Cyberduck 会分离主机和路径。
   • 端口：443
   • **用户名：**TrekMail 账户电子邮件地址
   • **密码：**设备密码 (dsync_...)
   • **路径：**确认与复制的 URL 路径一致
5. 可选：勾选保存密码，将其保存在系统钥匙串 (macOS) 或凭据管理器 (Windows) 中。
6. 点击连接。

Cyberduck 随即显示 Drive 的顶层文件夹。

保存为书签

为避免重复输入设置：

1. 连接后选择书签 → 新建书签，macOS 快捷键为 Command + Shift + B，Windows 为 Ctrl + Shift + B。
2. Cyberduck 会填入当前连接的信息。
3. 输入易识别的名称，例如 TrekMail Drive。
4. 关闭书签编辑器。

以后双击书签即可重新连接。

处理文件

• 拖入文件可立即上传。
• 拖出文件可下载。
• 右键点击 → 新建文件夹可创建目录。
• 双击文件：Cyberduck 会将其下载到临时位置并用默认应用打开。若要更新 Drive 文件，请在本地保存新版本并将其作为新文件上传，或在 Drive 网页界面更新。WebDAV 不会通过直接保存替换现有文件。
• 右键点击 → 删除会将文件移至 Drive 回收站。

传输大文件前，请先用小文件测试连接。Drive 支持最大 10 TB 的文件，具体取决于可用存储空间和客户端能力。

将本地文件夹与 Drive 同步

Cyberduck 内置同步功能：

1. 选择文件 → 同步…。
2. 选择本地文件夹。
3. 选择方向：上传、下载或镜像，后者为双向。
4. 点击继续，Cyberduck 会在应用更改前显示差异。

对于无人值守的同步任务，rclone 更合适，因为 Cyberduck 只执行一次同步，不会定时运行。

问题排查

• “登录失败”：使用设备密码 (dsync_...)，而非控制面板密码。仍失败时，在同步设备中重新生成。
• “连接被拒绝”：重新复制完整 URL，并确认 Cyberduck 保留了主机和路径。
• 上传后部分文件未显示：Cyberduck 会缓存列表；在 macOS 按 Command + R，在 Windows 按 F5 刷新。
• 传输暂停并显示“insufficient_scope”：设备密码只有读取权限。创建新密码并勾选编辑文件。
• 长时间闲置后断开：下次点击时会自动重连。若要避免断开，请打开 Cyberduck → 偏好设置 → 连接并启用保持连接。

其他同步问题请参阅 Drive 同步问题排查。