# rclone 错误、校验和与修改时间

了解 rclone 为何重复复制相同文件、忽略校验和或修改时间、拒绝某些文件名或大型流式上传，以及如何解决登录 Drime 时的错误。

更新于：2026-10-20  
来源：https://drime.cloud/zh-cn/support/integrations-and-api/rclone-troubleshooting

本文介绍 rclone 在 Drime 上的特有行为，以及 rclone 报错时的处理方法。如需设置 rclone，请参阅 [Rclone、Drime CLI 和 WebDAV](https://drime.cloud/zh-cn/support/integrations-and-api/rclone-cli-and-webdav)。

## Drime 后端支持的功能

Drime 是 rclone 的官方后端（Tier 1），从 rclone 1.73 起可用。它支持服务器端复制和移动、移动文件夹、清除整个文件夹（purge）、显示配额（`rclone about`）、空文件夹以及分段上传。

与许多其他存储服务相比，有两点不同：

- **不提供校验和**：Drime 不向 rclone 提供每个文件的哈希值。
- **无法设置修改时间**：rclone 无法将文件的修改日期写入 Drime。

以下问题大多源于这两点。

## 同步时重复复制文件，或遗漏已更改的文件

由于 Drime 不支持设置修改时间，rclone 通过比较大小来判断文件是否有更改。

| 发生的情况 | 处理方法 |
| --- | --- |
| 您更改过的文件没有被再次复制 | 该文件的大小没有变化。请使用 `--update`（改为比较上传时间），或单独再次复制该文件。 |
| `--checksum` 不起任何作用 | Drime 不提供校验和，因此 rclone 无法通过哈希值比较文件。请使用 `--size-only` 或 `--update`。 |

## 部分文件被拒绝或被重命名

| 发生的情况 | 原因及处理方法 |
| --- | --- |
| 文件名很长的文件上传失败 | Drime 接受的文件名最长为 255 字节（UTF-8 编码）。带重音的字母和其他非 ASCII 字符（例如汉字）会占用多个字节。请缩短文件名。 |
| 名称中含有反斜杠，或以空格开头或结尾，在 Drime 中看起来不一样 | rclone 会将这些字符替换为外观相似的字符，以便名称能被接受。 |

## 大型流式上传失败

当 rclone 在事先不知道数据大小的情况下上传（例如使用 `rclone rcat`）时，在默认分块大小下，单次上传上限为 48 GiB。如需上传更多数据，请在远程存储的高级设置中调大 `chunk_size`。

## 已删除的文件仍占用存储空间

默认情况下，rclone 删除的文件会移至 Drime 垃圾桶，在那里仍会占用您的存储空间。如需永久删除，请在远程存储的高级设置中将 `hard_delete` 设为 `true`，或在 Drime 中清空垃圾桶。

## rclone 使用了错误的工作区或文件夹

- 如需在工作区而不是您的个人云盘中操作，请在远程存储的高级设置中设置 `workspace_id`。
- 如需将远程存储限制在某个文件夹内，请设置 `root_folder_id`。

## rclone 无法登录

rclone 使用 API 令牌。Drime API 会返回以下信息，rclone 会在其错误中显示这些信息：

| 您看到的情况 | 处理方法 |
| --- | --- |
| `Unauthenticated.`（HTTP 401） | 令牌有误或已被删除。请创建新令牌，然后使用 `rclone config` 替换远程存储的 `access_token`。 |
| `This API key is missing the required scope: files.write`（HTTP 403） | 该令牌无法写入文件。请创建**全部**令牌，或文件权限为**写入**的令牌。 |
| `This endpoint cannot be accessed with a restricted API key.`（HTTP 403） | 此命令需要**全部**令牌。 |

在**设置** \> **开发人员**中创建令牌时，请选择令牌可以执行的操作：

![“创建新令牌”对话框，已填写令牌名称，并选中了“受限”访问](https://drime.cloud/media/01M59T977CYEFV0EGJSEE6Y0F7/1767ae179cc0-web-settings-developers-token-dialog.png)

请参阅[创建 API 令牌](https://drime.cloud/zh-cn/support/integrations-and-api/api-tokens)。

## 仍然无法解决时

| 您看到的情况 | 处理方法 |
| --- | --- |
| 在 `rclone config` 的 **Storage**（存储类型）提示处没有 `drime` 选项 | 您的 rclone 低于 1.73 版本。请更新 rclone，然后重新运行 `rclone config`。 |
| 您的 Vault 文件没有出现在 rclone 中 | 这是正常现象：rclone 以及其他通过 API 令牌连接的工具都无法访问您的 Vault。Vault 文件只能在 Drime 自己的应用中使用。请参阅[什么是 Vault？](https://drime.cloud/zh-cn/support/vault/what-is-vault) |
| 工作区的文件没有出现 | 该远程存储访问的是您的个人云盘。请在其高级设置中设置 `workspace_id`。 |
| 本页未列出的错误 | 请[联系 Drime 客服](https://drime.cloud/zh-cn/support/getting-started/contact-drime-support)，并提供您运行的命令以及 rclone 显示的错误。切勿发送您的 API 令牌：请将其从您复制的所有内容中删除。 |

## 后续步骤

- [Rclone、Drime CLI 和 WebDAV](https://drime.cloud/zh-cn/support/integrations-and-api/rclone-cli-and-webdav)
- [创建 API 令牌](https://drime.cloud/zh-cn/support/integrations-and-api/api-tokens)
- [使用 rclone 将 Synology NAS 备份到 Drime](https://drime.cloud/zh-cn/support/integrations-and-api/synology-with-rclone)