用 rclone 连接 TrekMail Drive

rclone 是一款支持 WebDAV 的命令行工具，适合通过脚本执行上传、下载、文件列表查询和定时备份。正式执行大型任务前，请先测试小文件的上传和下载。TrekMail Drive 接受最大 10 TB 的文件，但还受可用存储、rclone 版本和所用计算机的限制。

连接信息

rclone 配置需要以下内容：

rclone 字段	值
Storage / Type	WebDAV
URL	从 Sync devices 复制完整的 Drive 服务器 URL，包括末尾的斜杠。该 URL 对应在此页面选择的 Drive 范围。
Vendor	other
User	Sync devices 上显示的用户名。Account Drive 通常使用账户所有者的邮箱地址，邮箱范围则使用该邮箱的地址。
Password	Sync devices 生成的 `dsync_…` 设备密码，不是控制面板密码
Bearer token	留空

手动将密码写入配置文件时，请使用 rclone obscure dsync_…。rclone 只会混淆密码，不会加密，任何能读取文件的人仍可使用这些凭据。

如果尚未生成设备密码，请先按照 Sync devices 的说明操作。

开始之前

你需要一个设备密码。同步应用会获得各自的一次性密码，因此可以单独撤销 rclone 的访问，而不影响控制面板登录。

在 TrekMail 控制面板中打开 Sync devices。
点击 + Add new device。
为设备命名，例如 Laptop, rclone。
如果 rclone 需要上传、移动或删除文件，请保留 View files 和 Edit files。如果只需下载，请仅选择 View files。
点击 Generate password 并复制密码 (dsync_...)。

要将备份保存到 Drive，需要 Edit files。如果仅从 Drive 下载进行恢复，只需 View files。

安装 rclone

macOS: brew install rclone
Linux: curl https://rclone.org/install.sh | sudo bash
Windows: 从 rclone.org/downloads 下载，并添加到 PATH。

配置远程存储

运行交互式配置程序：

rclone config

然后按以下步骤操作：

输入 n，新建远程存储。
将其命名为 trekmail-drive，也可以使用其他名称。
从列表中选择 WebDAV。编号会随版本变化，请查找 "Webdav"。
URL：粘贴 Sync devices 页面中的 Drive server URL，保留末尾的斜杠。
Vendor：选择 other。
User：粘贴同一页面显示的用户名。
Password：选择 y (yes, type my own password)，然后粘贴 dsync_... 设备密码。
Bearer token：留空。
Edit advanced config：输入 n。
Confirm：输入 y。

也可以直接写入配置文件。打开 ~/.config/rclone/rclone.conf 并添加：

[trekmail-drive]
type = webdav
url = <copy the Drive server URL from Sync devices>
vendor = other
user = you@example.com
pass = <obscured-password>

使用 rclone obscure dsync_... 生成混淆后的密码。

日常命令

列出文件

rclone ls trekmail-drive:
rclone lsd trekmail-drive:        # directories only

上传文件

rclone copy ./backup.zip trekmail-drive:Backups/

此端点特意禁止 rclone 原位替换现有 Drive 文件。上传时请使用新的目标名称或文件夹，例如带日期的备份文件夹。如果命令需要覆盖文件，请先下载当前副本，或通过 Drive 界面上传替代文件。

单向上传文件夹并显示进度

rclone copy ./Documents trekmail-drive:Documents \
  --progress --transfers 8

--transfers 8 要求 rclone 最多并行上传八个文件。请从较小的值开始，只有在测试成功后再提高。

镜像命令需要格外谨慎

rclone sync ./Documents trekmail-drive:Documents --progress

注意： sync 会删除远程存在但本地不存在的文件，并且通常需要更新已有文件。在一次性测试文件夹中验证确切行为之前，请勿对生产 Drive 数据使用该命令。普通备份应优先使用 copy，写入新的带日期文件夹。

挂载为文件夹

mkdir ~/trekmail
rclone mount trekmail-drive: ~/trekmail \
  --vfs-cache-mode writes --daemon

Drive 随后会显示为 ~/trekmail。Photos、Lightroom 等不支持 WebDAV 的工具可以像使用普通本地文件夹一样使用它。

卸载

fusermount -u ~/trekmail           # Linux
umount ~/trekmail                  # macOS

定时备份

在 Linux 或 macOS 上，将任务添加到 crontab (crontab -e)：

# Back up ~/Documents nightly at 2 AM
0 2 * * * /usr/local/bin/rclone copy ~/Documents trekmail-drive:Documents --quiet

在 Windows 上，使用 Task Scheduler 运行同一个 rclone copy 命令。

调整大型传输

对于多 GB 视频、数据集等大型文件：

rclone copy ./big.iso trekmail-drive:ISOs/ \
  --transfers 4 \
  --multi-thread-streams 4 \
  --buffer-size 64M \
  --progress

这些是 rclone 客户端选项，不是 TrekMail 的必需设置。请从默认值开始，保留命令输出，并在安排大型传输前测试一个具有代表性的文件。

故障排除

401 Unauthorized：密码错误或已撤销。请在 Sync devices 中生成新密码。
403 或权限错误：上传或更改文件时，请确认设备密码拥有 Edit files 权限。必要时创建新密码。
429 Too Many Requests 或反复出现连接错误：降低 --transfers，稍等片刻，并先重试一条小型命令，再继续任务。
507 Insufficient Storage：Drive 存储池已满。请调整 Add-on 容量或清空 Trash。
挂载文件夹显示过期内容：使用 rclone mount 选项 --vfs-cache-mode writes --dir-cache-time 1m 清除 rclone 缓存。

有关更广泛的同步问题，请参阅 Drive Sync 故障排除。