You need to enable JavaScript to run this app.
导航
在 Windows 系统挂载 TOS 存储桶
最近更新时间:2023.06.25 16:03:56首次发布时间:2023.06.02 10:58:08

TOS 支持将存储桶作为磁盘挂载到 Windows 系统。本文以 64 位 的 Windows10 系统为例,介绍在 Windows 系统挂载 TOS 存储桶的相关操作和常见问题。

前提条件

注意事项

使用 Rclone 工具挂载存储桶适用于小量测试等场景,不建议生产环境使用此方式。生产环境建议使用 S3 、TOS API 或 TOS SDK。

步骤一:安装 Rclone 和 Winfsp 工具

  1. 安装依赖工具 Winfsp。

    1. 下载依赖工具 Winfsp 至本地。

    2. 双击安装程序 winfsp-2.0.23075.msi,根据界面提示完成 Winfsp 的安装。

  2. 安装挂载工具 Rclone。

    下载并解压 Rclone 至本地,本文以解压 Rclone 至 C:\Tools 为例。更多信息,请参见 Rclone 论坛

  3. 为 Rclone 配置环境变量。

    1. 在桌面,右键单击此电脑,选择属性

    2. 关于页面底部,单击高级系统设置

    3. 系统属性对话框,单击环境变量

    4. 环境变量对话框系统变量区域,双击 Path。

    5. 编辑环境变量对话框,单击新建,输入 Rclone 解压后在本地的路径,本文为 C:\Tools\rclone-v1.57.0-windows-amd64,单击确定。

    6. 环境变量对话框,单击确定

  4. 验证 Rclone 是否安装成功。

    1. 在桌面,搜索中输入 cmd,打开命令提示符面板。

    2. 输入以下命令,验证 Rclone 是否安装成功。

      rclone -version
      

      返回类似如下内容,说明 Rclone 安装成功。

      Usage:
        rclone [flags]
        rclone [command]
      

步骤二:配置 TOS 连接信息

  1. 命令提示符面板,输入 rclone config,按 enter,开始配置 Rclone。

  2. 依次选择如下选项,并输入相关信息,配置 Rclone 信息。

    说明

    Rclone 版本不同,配置选项的数字编号可能会不同,请您根据选项的文字描述进行选择。

    n) New remote  //新建远程连接。
    
    name> volces-tos  //输入连接名称,本文中以 volces-tos 为例。
    
    5 / Amazon S3 Compliant Storage Providers including AWS, Alibaba, Ceph, Digital Ocean, Dreamhost, IBM COS, Minio, SeaweedFS, and Tencent COS
    \ "s3"   //选择兼容 S3 协议的存储类型。
    
    25 / Any other S3 compatible provider
    \ "Other"   //选择其他 S3 兼容的存储提供商。
    
    1 / Enter AWS credentials in the next step
    \ "false"   //在下一步输入密钥。
    
    access_key_id> AKLTYTBjY*******  //输入AK。
    
    secret_access_key> TVdaaFkyRTNNa*****  //输入SK。
    
    region> cn-beijing  //输入 Region ID。
    
    endpoint> https://tos-s3-cn-beijing.volces.com //输入 S3 Endpoint。
    
    location_constraint>    //按 Enter 键置空,保持默认即可。
    
    acl>  //按 Enter 键置空,保持默认即可。
    
    n) No (default) //不编辑高级配置,保持默认即可。
    
    y) Yes this is OK (default)  //查看配置预览信息,然后选择 y。
    
    q) Quit config  //退出配置界面。
    
  3. 修改 Rclone 配置信息。

    注意

    • 配置完成后,Rclone 默认会使用 Path 模式访问对象存储,在访问 TOS 时需要您修改为虚拟主机模式。

    • Rclone 默认会使用 HTTP2 访问 TOS,在访问 TOS 时需要禁用 HTTP2 模式。

    1. 输入以下命令,获取配置文件的详细路径。

      rclone config file
      
    2. 打开配置文件,在连接配置的末尾增加如下内容。

      参数是否必选说明
      force_path_style = false必选禁用 Path 模式访问对象存储。
      disable_http2 = true必选禁用 HTTP2 模式访问对象存储。

      list_version = 2

      可选

      使用 V2 版本的接口列举对象。与 V1 接口相比,V2 接口调用参数更全面,优化了 V1 接口存在的超时问题。

      说明

      如果您未在配置文件中添加该参数,您也可以在使用列举命令时添加 --s3-list-version 2参数。具体示例,请参见查看桶或目录

      修改后的配置文件如下所示。

      [volces-tos]
      type = s3
      provider = Other
      access_key_id = AKLTYTBjY*******
      secret_access_key = TVdaaFkyRTNNa*****
      region = cn-beijing
      endpoint = https://tos-s3-cn-beijing.volces.com
      force_path_style = false
      disable_http2 = true
      list_version = 2
      

步骤三:挂载存储桶到本地

  1. 输入以下命令,按 Enter

    rclone mount <远程连接的名称>:/ <盘符>: --cache-dir <缓存目录> --vfs-cache-mode writes
    
    参数说明
    远程连接的名称步骤二:配置 TOS 连接信息创建的远程连接名称相对应,本文为 volces-tos。
    盘符磁盘的标识符。本文设置为 F。
    缓存目录用于存放 Rclone 的缓存信息。本文设置为 C:\TOS_Cache

    示例:

    rclone mount volces-tos:/ F: --cache-dir C:\TOS_Cache --vfs-cache-mode writes
    

    返回类似如下内容:

    The service rclone has been started.
    
  2. 在桌面双击此电脑,单击上一步骤设置的盘符,本文为 F 盘。

    在 F 盘可以看到存储桶,说明挂载存储桶到本地成功。
    alt

相关命令

ctrl -c,可以取消挂载存储桶。

注意

取消挂载存储桶之前,请确保已完成上传文件等操作。

常见问题

Q:挂载存储桶到本地后,访问磁盘,提示 Dir.Stat error: BadRequest 怎么办?
A:该报错有可能是 Access Key ID 和 Secret Access Key 错误引起的。您需要在 rclone 配置文件中正确修改 Access Key ID 和 Secret Access Key,然后再挂载存储桶。