Drive Sync 常见错误排查与解决方法

Drive Sync 是 TrekMail Drive 的 WebDAV 接口，任何支持 WebDAV 的客户端都可以连接。大多数问题都属于少数几种模式。当功能失效但原因不明时，请使用本页进行排查。

登录立即失败

几乎总是由以下原因之一造成：

• 密码类型错误：你使用了 Dashboard 密码，或者 webmail 或邮箱密码。同步应用需要单独的设备密码，可从 Dashboard 的 Sync devices 中生成，也可以在 webmail 中通过 Drive → Sync devices 按钮生成。密码以 dsync_ 开头。
• 密码已撤销或过期：在创建密码的界面中打开 Sync devices，并检查状态栏。状态为 Revoked 或 Expired 的密码已无法使用。请生成新密码。注意：账号所有者可以撤销从 webmail 创建的密码，而从 Dashboard 撤销会使密码失效，无论密码最初从哪里创建。
• 粘贴时带有尾随空格：有些应用会添加不可见的换行或空格。请仔细重新复制并粘贴。
• 用户名错误：Dashboard 提供的同步 URL 指向账号目录树（/dav/files/account/）；webmail 提供的 URL 指向邮箱目录树（/dav/files/mailbox-N/）。用户名必须匹配：账号密码使用账号电子邮件地址，邮箱范围密码使用邮箱地址。混用会导致 401。
• 账号已暂停：如果 TrekMail 账号因账单、滥用或欺诈被暂停，同步访问会被阻止。请先在 Dashboard 中解决问题。

上传时出现 "Insufficient scope" 或 "permission denied"

设备密码为只读，但应用正尝试上传。可以采用两种解决方法：

1. **建议：**在 Sync devices 中生成新的设备密码，并选中 Edit files。如果不再需要旧密码，请将其撤销。
2. 或者编辑现有密码的权限范围，但出于安全考虑，TrekMail 不允许这样做。撤销后重新创建是唯一途径。

只读权限适用于从 Drive 拉取备份、在 Photos 或 Lightroom 中以只读方式挂载，或使用 iPhone 上的 Documents 应用浏览文件。

上传、同步、删除或移动文件的任何操作都需要写入权限。

上传缓慢或停滞

原因取决于客户端：

• macOS Finder / Windows Explorer：传输大型文件时，请保持连接，并先用较小的文件测试。Drive 支持最大 10 TB 的文件，但实际能否完成取决于客户端和可用存储空间。如果传输反复失败，请尝试 Cyberduck 或 rclone。
• rclone：将 --transfers 8 提高到该值或更高，并设置 --multi-thread-streams 4。如果出现 429 Too Many Requests，请调低这些值。
• Windows 自身的注册表上限，并非我们的限制：Windows 默认会在操作系统层面拒绝大于 50 MB 的 WebDAV 上传。请参阅使用 Windows Explorer 连接 Drive，通过注册表调整将 Windows 上限提高到 4 GB。对于更大的文件，rclone 会完全绕过 Windows WebClient。

"Insufficient storage" 和 507 错误

你的 Drive 存储池已满。可以：

• 清空回收站：Trash 中的文件会占用配额 30 天。请前往 Drive → Trash → Empty。
• 删除不再需要的文件：通过 Drive 界面的大小栏查找大型文件。
• 调整 Drive 附加服务容量：请参阅调整 Drive 附加服务容量。确认付款后即可使用新增容量。

文件显示在 Drive 中，但同步客户端中没有

反过来也可能发生。原因几乎总是客户端缓存：

• Finder：在侧边栏中推出 Drive 挂载，然后重新连接。
• Windows Explorer：在 Drive 窗口中按 F5。如果文件仍然缺失，请断开连接并重新映射。
• Cyberduck：在 macOS 中按 Command + R，或在 Windows 中按 F5 刷新。
• rclone mount：使用 --vfs-cache-mode writes --dir-cache-time 1m 重新启动挂载。
• DAVx⁵ / Documents：在文件管理器中下拉刷新。

如果刷新不能解决问题，文件可能已在另一个会话中移动或删除。请从 Dashboard 查看 Drive 的 Trash。

空闲后连接中断

有些客户端会主动关闭空闲的 WebDAV 套接字，尤其是在移动网络中：

• Cyberduck：打开 Preferences → Connection → Keep Alive。
• Finder / Explorer：操作系统会在下次访问文件时自动重新连接，无需修复。
• rclone：对于长期运行的挂载，请添加 --http-no-head 和 --retries 5 标志。

429 Too Many Requests

服务设置了请求频率限制，防止单个客户端独占 Drive。请短暂暂停客户端后重试。如果错误再次出现，请先减少并行传输或请求频率，再考虑创建额外的设备密码。

创建设备时出现 "Name already exists"

Sync devices 表单不允许有效设备使用重复名称。如果已有名为 "MacBook" 的有效设备，而你尝试创建另一个同名设备，系统会提示选择其他名称或先撤销旧设备。

已撤销的名称会立即释放。因此，旧笔记本停用后若要再次使用 "MacBook"，只需撤销旧记录，再用相同标签创建新记录。

不同界面的唯一性范围不同：webmail 记录按邮箱唯一；Dashboard 记录按（账号、邮箱）组合唯一。因此，账号范围的 "MacBook" 与邮箱范围的 "MacBook" 可以同时存在。

文件名因无效而被拒绝

TrekMail Drive 会执行严格的文件名规则，确保跨操作系统的列表安全。名称不能：

• 为空或仅含空白字符。
• 包含正斜杠 /、反斜杠 \ 或空字节。
• 包含 CR 或 LF，即换行字符。
• 使用从右到左覆盖或其他双向控制字符，这是出于安全考虑。
• 以句点或空格结尾，这是 Windows 的特殊限制。
• 以空白字符开头。

请在本地重命名文件后重试。

某些操作出现 "Method not allowed" 或 405

Drive 的 WebDAV 接口只支持以下有限的方法：GET, HEAD, OPTIONS, PROPFIND, REPORT, PUT, POST, PROPPATCH, MKCOL, MOVE, COPY, DELETE, LOCK, UNLOCK。有些客户端会尝试特殊方法，例如使用 COPY 覆盖到不存在的目标，或使用 PROPPATCH 设置自定义服务器端属性。这些操作按设计返回 405。没有可用修复，客户端必须采用备用方式。

仍未解决？

检查 Sync devices 页面。Last used 栏显示密码上次成功完成身份验证的时间。如果始终没有近期活动，则请求没有到达服务器，通常是网络或防火墙问题；请尝试其他网络。

如果同步之前正常但突然停止：

• 设备密码最近是否被撤销或已经到期？
• TrekMail 账号账单是否逾期？请检查 Dashboard 中的警告。
• 同步客户端最近是否自行更新？尝试回退版本。

仍无法解决？请创建支持工单，提供客户端名称、操作系统版本和故障开始时间。请按显示内容准确附上所有错误消息。