跳到主要内容

修复 Box 同步错误 — 使用 RcloneView 解决

· 阅读需 5 分钟
Kai
Junior Engineer

一份实用的检查清单,帮助你使用 RcloneView 内置的工具诊断失败的 Box 传输。

Box 同步作业失败通常源于几个反复出现的原因:登录过期、账户类型不对、API 调用被限流,或是 Box 对待方式与普通文档不同的文件。RcloneView 提供作业历史记录、日志和内置终端,帮助你快速区分这些原因。此外,RcloneView 可以在一个窗口中挂载并同步 90 多个提供商,支持 Windows、macOS 和 Linux,因此你也可以用另一个远程来测试同样的文件。

RcloneView 应用预览

在一个地方管理和同步所有云端

RcloneView 是 rclone 的跨平台 GUI。通过清爽的可视化界面比较文件夹、传输或同步文件,并自动化多云工作流。

  • 一键作业:复制 · 同步 · 比较
  • 调度器与历史记录,实现可靠的自动化
  • 支持 Google Drive、OneDrive、Dropbox、S3、WebDAV、SFTP 等
WindowsmacOSLinux
免费开始使用 →

核心功能免费。Plus 提供自动化功能。

从作业历史记录和日志选项卡开始​

打开作业历史记录(Job History),查看失败运行的状态(Completed、Errored 或 Canceled),以及已传输的大小和文件数量。部分传输通常说明是单个文件的问题;如果作业立即失败,则通常是身份验证或配置问题。

要查看详细信息,请切换到底部的日志(Log)选项卡。若要记录更多内容,请在 Embedded Rclone 设置中启用 rclone 日志,将级别设置为 DEBUG,重启内置 rclone,然后重现该故障。

在 RcloneView 中查看失败的作业历史记录

重新验证并检查账户类型​

如果所有请求都失败,可能是 OAuth 令牌已过期或被撤销。打开远程管理器(Remote Manager),编辑 Box 远程,并通过浏览器重新登录。

如果可以登录,但文件夹缺失或出现权限错误,请检查账户类型。Box for Business 需要在远程上设置 box_sub_type = enterprise。对企业账户使用个人账户的配置,是造成结果令人困惑的常见原因。

在 RcloneView 中编辑 Box 远程配置

处理限流和大型作业​

当一次处理数千个小文件时,Box 可能会限制请求。在作业的高级设置(Advanced Settings)中,降低文件传输数量和相等性检查器(equality checkers)的数量(对于较慢的后端,建议不超过 4)。将重试次数保留为默认值 3,以便临时性故障可以自动恢复。

在 Transferring 选项卡中监控传输

过滤有问题的文件​

Box Notes 等仅限在线的项目并不是普通文件。过滤步骤中预定义的 Box Docs 过滤器会将它们排除,使其不再导致作业失败。你还可以添加自定义规则、设置最大文件大小,或在排查期间排除有问题的文件夹。之后运行 Dry Run 来确认将要复制的内容。

比较文件夹以找出同步失败的文件

开始使用​

  1. 从 rcloneview.com 下载 RcloneView。
  2. 查看作业历史记录和日志选项卡,找到确切的错误。
  3. 重新验证 Box 远程,如适用,请确认 Box for Business 设置。
  4. 降低并发数,应用 Box Docs 过滤器,然后执行 Dry Run 并重新运行。

大多数 Box 失败都是配置问题,花几分钟查看日志就能发现。


相关指南:

支持的云服务商

Local Files
WebDAV
FTP
SFTP
HTTP
SMB / CIFS
Google Drive
Google Photos
Google Cloud Storage
OneDrive
Dropbox
Box
MS Azure Blob
MS File Storage
S3 Compatible
Amazon S3
pCloud
Wasabi
Mega
Backblaze B2
Cloudflare R2
Alibaba OSS
Ceph
Swift (OpenStack)
IBM Cloud Object Storage
Oracle Cloud Object Storage
IDrive e2
MinIO
Storj
DigitalOcean Spaces