七牛云：批量将标准存储文件转为归档直读存储
📋 整体流程图
下载安装 qshell → 配置密钥 → 列出符合条件的文件 → 生成批量转换清单 → 执行转换建议先看看不同类型有何区别，选择适合自己的：存储类型_产品简介_对象存储 - 七牛开发者中心https://developer.qiniu.com/kodo/3956/kodo-category
第 1 步：下载安装 qshell
Windows 系统，下载这个：
👉下载地址：https://kodo-toolbox-new.qiniu.com/qshell-v2.19.2-windows-amd64.zip
下载后解压，你会得到一个qshell.exe文件。
注意，不要双击打开！打开PowerShell或命令提示符（Win+R 输入
powershell回车），然后cd到 qshell.exe 所在的目录，或者把 qshell.exe 的目录加到系统 PATH 环境变量里（这样在任何目录都能用）。
- 或者在文件目录栏中输入【cmd】，回车即可
第 2 步：配置你的七牛密钥
你需要从七牛后台拿到AccessKey和SecretKey：
- 打开 https://portal.qiniu.com/user/key
- 复制你的AK和SK
然后在命令行执行：
qshell.exe account <你的AK> <你的SK> <随便起个名字>举个例子：
qshell.exe account myAK123 mySK456 myAccount名字随便起（比如
myAccount），只是用来区分多账号的标签。
第 3 步：列出符合条件的文件
现在开始筛文件。我的需求是：
- ✅ 上传时间在2025 年 12 月 31 日 23:59:59 之前
- ✅ 存储类型是标准存储（类型编号 = 0）
执行这条命令（把你的空间名换成你实际的 bucket 名字）：
qshell.exe listbucket2 --end 2026-01-01 --file-types 0 --show-fields Key -o result.txt 你的空间名参数解释（小白版）：
| 参数 | 含义 |
|---|---|
--end 2026-01-01 | 只保留2026年1月1日之前上传的文件（半开区间，不包含 1 月 1 日本身） |
--file-types 0 | 只保留标准存储（0=标准，1=低频，2=归档，3=深度归档，4=归档直读，5=智能分层） |
--show-fields Key | 输出文件里只保留「文件名」这一列，方便下一步直接用 |
-o result.txt | 把结果保存到本地文件result.txt |
你的空间名 | 换成你七牛上那个 bucket 的名字 |
| --prefix images/ | 只保留指定的文件前缀（文件夹也算文件前缀） |
⚠️注意：如果你的空间文件非常多，这一步可能比较慢。因为--end和--file-types是在本地过滤的——qshell 会先把空间里所有文件都拉下来，再逐个筛。所以请耐心等待，看到命令行回到提示符就是完成了。
第 4 步：生成批量转换的输入文件
result.txt目前只有文件名（每行一个），而batchchtype需要的格式是：
文件名<Tab键>2其中4表示「归档直读存储」。在 PowerShell 里执行：
Get-Content result.txt | ForEach-Object { $_ + "`t4" } | Set-Content -Encoding UTF8 change_to_archive.txt这句的意思是：读取result.txt的每一行，在行末加上一个 Tab 和数字2，然后写入change_to_archive.txt。
你可以用记事本打开
change_to_archive.txt看看，每行大概是图片.jpg 2这样的格式。
第 5 步：执行批量转换
🔸 强烈建议：先小批量测试！
如果你的文件很多，先用--limit只拿前 100 个文件试一下（回到第 3 步加个--limit 100），确认没问题再跑全量。
🔸 正式执行：
qshell.exe batchchtype --force 你的空间名 -i change_to_archive.txt参数解释：
| 参数 | 含义 |
|---|---|
--force | 跳过确认提示，直接执行（不加的话会问你要不要继续） |
-i change_to_archive.txt | 指定输入文件 |
如果不想跳过确认（更安全），去掉--force，执行后会让你输验证码再继续。
第 6 步：验证结果
转换完成后，建议用batchstat抽查几个文件确认类型已经变为归档：
qshell.exe stat 你的空间名 文件名.jpg查看返回信息中的type字段，应该是2（归档存储）。
⚠️ 重要注意事项（一定要看！）
1. 归档文件访问前必须「解冻」
转为归档存储后，文件不能直接下载/访问。需要先解冻：
# 解冻单个文件 qshell.exe restorear 你的空间名 文件名.jpg # 批量解冻 qshell.exe batchrestorear 你的空间名 -i 文件列表.txt解冻需要一定时间（通常几分钟到几小时），解冻后的文件在一段时间内可以正常访问。
2. 最短存储期 = 60 天
归档存储有最短存储期限 60 天：
- 如果文件转归档后不满 60 天就被删除、覆盖、或再转回标准存储，七牛会收取剩余天数的存储费用作为提前删除费。
- 所以转之前想清楚：这些文件你确定短期内不会改动了。
3. 建议操作顺序
code复制
① 先列清单 → ② 人工检查一下清单有没有问题 → ③ 小批量测试 → ④ 全量转换千万不要跳步骤 ③！宁可慢一点，也别出错了没法回滚。
🔗 参考文档
- qshell 总览
- listbucket2 文档
- batchchtype 文档
- 七牛密钥管理
总结一下核心只需 3 条命令：
# 1️⃣ 列出 2025 年底前的标准存储文件 .\qshell.exe listbucket2 --end 2026-01-01 --file-types 0 --show-fields Key -o result.txt 你的空间名 # 2️⃣ 生成批处理输入文件（每行：文件名 + Tab + 4） Get-Content result.txt | ForEach-Object { $_ + "`t4" } | Set-Content -Encoding UTF8 change_to_archive.txt # 3️⃣ 批量转为归档直读存储 .\qshell.exe batchchtype --force 你的空间名 -i change_to_archive.txt