七牛云对象存储使用 qshell 批量管理文件存储类型（实战教程）

一、适用场景说明

本教程适用于以下典型场景：

• • 存储桶中存在 低频 / 智能分层 / 归档 / 归档直读 / 深度归档 文件

• • 需要 批量解冻深度归档文件

• • 解冻完成后，统一转回标准存储

• • 文件数量较多（几千～几十万）

• • 需要 可恢复、可记录、可重试 的 CLI 操作方案

二、前置条件

1️⃣ 准备 qshell

下载地址：https://github.com/qiniu/qshell/releases

chmod +x qshell

确认版本（建议记录）：

./qshell version

root@ubuntu:~# ./qshell version
v2.17.0
root@ubuntu:~# 

2️⃣ 七牛云 AccessKey / SecretKey

确保账号具备以下权限（至少）：

• • 对象存储 Bucket 管理权限

• • 文件解冻

• • 文件存储类型变更

三、qshell 鉴权配置

命令格式

./qshell account <AK> <SK> <AccountName>

成功后配置会写入：

~/.qshell/account.json

四、导出非标准存储对象清单

存储类型枚举值（非常重要）

导出所有非标准存储对象

./qshell listbucket2 <Bucket> \
  --file-types 1,2,3,4,5 \
  --show-fields Key,FileType \
  -o non_standard_objects.tsv

输出示例（TSV）：

1721127498013.0708.MOV	3
2024-07-05-6686ca2981a6d.jpg	3
xxx.pdf	2

五、筛选“深度归档”文件 Key 列表

只保留 FileType = 3（深度归档）

awk -F'\t' '$2==3 {print $1}' non_standard_objects.tsv > deep_archive_keys.txt

检查数量：

wc -l deep_archive_keys.txt

六、解冻深度归档存储（batchrestorear）

命令说明

qshell batchrestorear <Bucket> <FreezeAfterDays>

• • ​FreezeAfterDays​：解冻后保持可访问天数（1–7）

• • 输入文件：仅包含 Key，一行一个

• • 支持断点记录、失败重试

解冻命令（推荐生产参数）

./qshell batchrestorear <Bucket> 7 \
  -i deep_archive_keys.txt \
  -y \
  --enable-record \
  -s deep_restore_success.txt \
  -e deep_restore_failure.txt

⚠️ 解冻是异步的，通常需要：

• • 归档：分钟级

• • 深度归档：数小时

七、确认解冻状态

单文件验证（可选）

./qshell stat <Bucket> 1721127498013.0708.MOV

是否“真的可转标准”，以控制台是否允许修改为准

八、解冻后 → 转换为标准存储（关键步骤）

⚠️ 重要说明（本次问题核心）

你当前 qshell 版本中：

​batchchtype​ 的输入文件必须是：Key + 目标 FileType 的映射文件

而不是只写 Key。

1️⃣ 构造 Key → 标准存储（0）映射文件

awk '{print $0 "\t0"}' deep_archive_keys.txt > deep_archive_to_standard.tsv

文件示例：

1721127498013.0708.MOV	0
2024-07-05-6686ca2981a6d.jpg	0

分隔符必须是 TAB

2️⃣ 执行批量转换存储类型

./qshell batchchtype <Bucket> \
  -i deep_archive_to_standard.tsv \
  -y \
  --enable-record \
  -s ch_type_success.txt \
  -e ch_type_failure.txt

九、验证转换结果

./qshell stat <Bucket> 1721127498013.0708.MOV

期望结果：

FileType: 0 -> 标准存储

控制台中“存储类型”显示为：标准存储

十、常见错误与排查

❌ 报错：need more than one param​

原因：

• • ​batchchtype​ 输入文件中只有 Key

• • 缺少目标 FileType 列

解决：

Key<TAB>0

❌ batchrestorear 卡住 / Total=0

原因：

• • 输入文件方式错误

• • 未使用 -i​

• • 误用 stdin

解决：

始终使用：

-i file.txt

十一、推荐生产实践

• • ✔ 使用 –enable-record​

• • ✔ 保留 success / failure 文件

• • ✔ 转换完成后调整生命周期规则，避免再次转归档

• • ✔ 大批量（>10 万）建议拆批执行

十二、流程总结（一句话版）

listbucket2 → 筛选深度归档 → batchrestorear 解冻 →构造 Key+0 映射 → batchchtype 转标准 → stat 校验