Cyberduck与Backblaze B2存储的兼容性问题分析

问题背景

Cyberduck是一款流行的跨平台文件传输客户端，支持多种云存储协议。近期用户反馈在使用Cyberduck 8.8.2版本连接Backblaze B2存储时遇到了上传和创建文件夹失败的问题，错误提示为"Unsupported header x-amz-checksum-sha256"。

问题现象

用户在Windows 11系统上使用Cyberduck 8.8.2版本时，尝试执行以下操作均失败：

• 创建新文件夹
• 上传文件
• 上传done.txt文件

系统弹出错误提示，表明Backblaze B2服务不支持x-amz-checksum-sha256校验头。类似问题也出现在Windows 10系统上，用户能够删除文件但不能上传或创建文件夹。

技术分析

根本原因

此问题源于Cyberduck 8.8.2版本中实现的S3协议校验机制与Backblaze B2的S3兼容API存在不兼容性。具体来说：

1. Cyberduck在8.8.2版本中增加了对S3校验头的支持（如x-amz-checksum-sha256）
2. Backblaze B2的S3兼容API明确不支持以下校验头：
   • x-amz-checksum-crc32
   • x-amz-checksum-crc32c
   • x-amz-checksum-sha1
   • x-amz-checksum-sha256
   • x-amz-checksum-algorithm
   • x-amz-checksum-mode

兼容性差异

Backblaze B2虽然提供了S3兼容API，但并非完全实现所有S3特性。在数据校验方面，B2采用了不同的实现方式，导致与标准S3客户端存在兼容性问题。

解决方案

临时解决方案

1. 降级使用Cyberduck 8.7.3版本（40979），该版本尚未引入校验头支持
2. 对于开发者，可以在S3客户端配置中禁用校验头计算

长期建议

1. Cyberduck团队应考虑为Backblaze B2连接添加特殊处理逻辑
2. 用户可向Backblaze反馈此兼容性问题，促使其完善S3 API实现

技术建议

对于需要使用Cyberduck连接Backblaze B2的用户，建议：

1. 暂时使用8.7.3版本
2. 关注Cyberduck更新日志，等待官方修复
3. 考虑使用Backblaze官方推荐的B2 CLI工具作为替代方案

总结

此问题凸显了云存储服务S3兼容API实现差异带来的挑战。用户在选用客户端工具时，需要关注特定服务提供商的API限制。Cyberduck团队和Backblaze都有责任改善这一兼容性问题，为用户提供更流畅的跨平台文件传输体验。