Rclone S3后端文档修复：恢复Glacier存储对象的关键说明

在Rclone项目的S3后端实现中，关于从AWS Glacier存储恢复对象的文档说明曾出现了一个重要的回归问题。这个问题最初在2023年通过PR #7077被修复，但在后续的代码变更中，关键的文档说明被意外移除。

问题背景

AWS Glacier是亚马逊提供的低成本长期存储服务，其特点是存储成本极低但检索时间较长。当用户需要访问存储在Glacier中的对象时，必须首先发起"恢复"操作，这通常需要数小时才能完成。Rclone作为一款强大的云存储同步工具，提供了通过backend restore命令来触发这一恢复过程的功能。

技术细节

文档中丢失的关键信息是关于rclone backend restore命令的一个重要行为特性：该命令实际上只能对目录进行操作，而不能直接作用于单个文件。当用户尝试对单个文件执行恢复操作时，会收到"is a file not a directory"的错误提示。

这一行为与AWS S3 API的设计有关。在底层实现上，Rclone的S3后端通过调用AWS的RestoreObject API来恢复Glacier存储的对象。虽然API本身支持对单个对象的操作，但Rclone出于一致性和易用性考虑，选择在命令行接口层面只支持目录级别的恢复操作。

影响范围

文档回归影响了所有使用Rclone v1.69.1及附近版本的用户。特别是那些尝试从Glacier Deep Archive恢复文件的用户会遇到困惑，因为错误信息没有明确解释为什么不能对单个文件执行恢复操作。

解决方案

项目维护者已经重新应用了修复，确保文档中明确说明：

1. backend restore命令只能用于目录路径
2. 用户需要指定包含目标文件的目录路径来恢复其中的对象
3. 恢复操作需要配合适当的Glacier恢复参数（如恢复模式、有效期等）

最佳实践

对于需要从Glacier恢复文件的用户，建议采用以下工作流程：

1. 首先确定文件所在的完整目录路径
2. 使用rclone backend restore remote:bucket/path/to/directory命令
3. 根据需要添加--restore-priority等参数控制恢复速度
4. 等待恢复完成（可能需要数小时）
5. 之后才能正常访问或下载文件

这一修复确保了Rclone文档的准确性，帮助用户更好地理解和使用Glacier存储恢复功能，避免因误解命令行行为而导致的操作失败。