存储系统
QingStor

QingStor

路径指定为 remote:bucket（对于 lsd 命令，可使用 remote:）。你也可以指定子目录，例如 remote:bucket/path/to/dir。

配置

以下是一个配置 QingStor 的示例。首先运行：

rclone config

这将引导你完成一个交互式的设置过程。

No remotes found, make a new one?
n) New remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
n/r/c/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / QingStor Object Storage
   \ "qingstor"
[snip]
Storage> qingstor
Get QingStor credentials from runtime. Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own value
 1 / Enter QingStor credentials in the next step
   \ "false"
 2 / Get QingStor credentials from the environment (env vars or IAM)
   \ "true"
env_auth> 1
QingStor Access Key ID - leave blank for anonymous access or runtime credentials.
access_key_id> access_key
QingStor Secret Access Key (password) - leave blank for anonymous access or runtime credentials.
secret_access_key> secret_key
Enter an endpoint URL to connection QingStor API.
Leave blank will use the default value "https://qingstor.com:443"
endpoint>
Zone connect to. Default is "pek3a".
Choose a number from below, or type in your own value
   / The Beijing (China) Three Zone
 1 | Needs location constraint pek3a.
   \ "pek3a"
   / The Shanghai (China) First Zone
 2 | Needs location constraint sh1a.
   \ "sh1a"
zone> 1
Number of connection retry.
Leave blank will use the default value "3".
connection_retries>
Remote config
Configuration complete.
Options:
- type: qingstor
- env_auth: false
- access_key_id: access_key
- secret_access_key: secret_key
- endpoint:
- zone: pek3a
- connection_retries:
Keep this "remote" remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y

这个远程存储名为 remote，现在可以像这样使用它。

查看所有存储桶

rclone lsd remote:

创建一个新的存储桶

rclone mkdir remote:bucket

列出存储桶的内容

rclone ls remote:bucket

将 /home/local/directory 同步到远程存储桶，并删除存储桶中多余的文件。

rclone sync --interactive /home/local/directory remote:bucket

–fast-list

此远程存储支持 --fast-list，这允许你以使用更多内存为代价来减少事务数量。有关更多详细信息，请参阅 rclone 文档。

多部分上传

rclone 支持与 QingStor 进行多部分上传，这意味着它可以上传大于 5 GiB 的文件。请注意，使用多部分上传的文件没有 MD5SUM。

请注意，超过 24 小时的未完成多部分上传可以使用 rclone cleanup remote:bucket 仅清理一个存储桶，使用 rclone cleanup remote: 清理所有存储桶。QingStor 不会自动删除未完成的多部分上传，因此可能需要不时运行此命令。

存储桶和区域

使用 QingStor，你可以使用任何区域列出存储桶（rclone lsd），但你只能从存储桶创建所在的区域访问其内容。如果你尝试从错误的区域访问存储桶，你将收到错误信息 incorrect zone, the bucket is not in 'XXX' zone。

认证

有两种方法可以为 rclone 提供一组 QingStor 凭据。按优先级顺序如下：

  • 直接在 rclone 配置文件中（通过 rclone config 进行配置）
    • 设置 access_key_id 和 secret_access_key
  • 运行时配置：
    • 在配置文件中将 env_auth 设置为 true
    • 在运行 rclone 之前导出以下环境变量
      • 访问密钥 ID：QS_ACCESS_KEY_ID 或 QS_ACCESS_KEY
      • 秘密访问密钥：QS_SECRET_ACCESS_KEY 或 QS_SECRET_KEY

受限文件名字符

控制字符 0x00 - 0x1F 和 / 会按照 默认受限字符集 进行替换。请注意，0x7F 不会被替换。

无效的 UTF-8 字节也会被 替换，因为它们不能用于 JSON 字符串。

标准选项

以下是 QingStor（青云对象存储）特定的标准选项。

–qingstor-env-auth

从运行时获取 QingStor 凭据。

仅在 access_key_id 和 secret_access_key 为空时适用。

属性：

  • 配置项：env_auth
  • 环境变量：RCLONE_QINGSTOR_ENV_AUTH
  • 类型：布尔值
  • 默认值：false
  • 示例：
    • “false”
      • 在下一个步骤中输入 QingStor 凭据。
    • “true”
      • 从环境（环境变量或 IAM）获取 QingStor 凭据。

–qingstor-access-key-id

QingStor 访问密钥 ID。

留空以进行匿名访问或使用运行时凭据。

属性：

  • 配置项：access_key_id
  • 环境变量：RCLONE_QINGSTOR_ACCESS_KEY_ID
  • 类型：字符串
  • 是否必需：否

–qingstor-secret-access-key

QingStor 秘密访问密钥（密码）。

留空以进行匿名访问或使用运行时凭据。

属性：

  • 配置项：secret_access_key
  • 环境变量：RCLONE_QINGSTOR_SECRET_ACCESS_KEY
  • 类型：字符串
  • 是否必需：否

–qingstor-endpoint

输入连接 QingStor API 的端点 URL。

留空将使用默认值 “https://qingstor.com:443”。

属性：

  • 配置项：endpoint
  • 环境变量：RCLONE_QINGSTOR_ENDPOINT
  • 类型：字符串
  • 是否必需：否

–qingstor-zone

要连接的区域。

默认值为 “pek3a”。

属性：

  • 配置项：zone
  • 环境变量：RCLONE_QINGSTOR_ZONE
  • 类型：字符串
  • 是否必需：否
  • 示例：
    • “pek3a”
      • 中国北京三区。
      • 需要位置约束 pek3a。
    • “sh1a”
      • 中国上海一区。
      • 需要位置约束 sh1a。
    • “gd2a”
      • 中国广东二区。
      • 需要位置约束 gd2a。

高级选项

以下是 QingStor（青云对象存储）特定的高级选项。

–qingstor-connection-retries

连接重试次数。

属性：

  • 配置项：connection_retries
  • 环境变量：RCLONE_QINGSTOR_CONNECTION_RETRIES
  • 类型：整数
  • 默认值：3

–qingstor-upload-cutoff

切换到分块上传的阈值。

任何大于此大小的文件将以 chunk_size 为块进行上传。 最小值为 0，最大值为 5 GiB。

属性：

  • 配置项：upload_cutoff
  • 环境变量：RCLONE_QINGSTOR_UPLOAD_CUTOFF
  • 类型：SizeSuffix
  • 默认值：200Mi

–qingstor-chunk-size

上传时使用的块大小。

当上传大于 upload_cutoff 的文件时，将使用此块大小进行多部分上传。

请注意，每次传输时，内存中会缓冲 “–qingstor-upload-concurrency” 个此大小的块。

如果你通过高速链接传输大文件，并且有足够的内存，那么增加此值将加快传输速度。

属性：

  • 配置项：chunk_size
  • 环境变量：RCLONE_QINGSTOR_CHUNK_SIZE
  • 类型：SizeSuffix
  • 默认值：4Mi

–qingstor-upload-concurrency

多部分上传的并发数。

这是同一文件的多个块同时上传的数量。

请注意，如果你将此值设置为大于 1，则多部分上传的校验和将损坏（但上传本身不会损坏）。

如果你通过高速链接上传少量大文件，并且这些上传没有充分利用你的带宽，那么增加此值可能有助于加快传输速度。

属性：

  • 配置项：upload_concurrency
  • 环境变量：RCLONE_QINGSTOR_UPLOAD_CONCURRENCY
  • 类型：整数
  • 默认值：1

–qingstor-encoding

后端的编码方式。

有关更多信息，请参阅 概述中的编码部分。

属性：

  • 配置项：encoding
  • 环境变量：RCLONE_QINGSTOR_ENCODING
  • 类型：Encoding
  • 默认值：Slash,Ctl,InvalidUtf8

–qingstor-description

远程存储的描述。

属性：

  • 配置项：description
  • 环境变量：RCLONE_QINGSTOR_DESCRIPTION
  • 类型：字符串
  • 是否必需：否

限制

qingstor 后端不支持 rclone about 命令。不具备此功能的后端无法确定 rclone 挂载的可用空间，也不能在 rclone 联合远程存储中使用 mfs（最大可用空间）策略。

请参阅 不支持 rclone about 的后端列表 和 rclone about

put.ioQuatrix