整体流程图下载安装 qshell → 配置密钥 → 列出符合条件的文件 → 生成批量转换清单 → 执行转换建议先看看不同类型有何区别选择适合自己的存储类型_产品简介_对象存储 - 七牛开发者中心https://developer.qiniu.com/kodo/3956/kodo-category第 1 步下载安装 qshellWindows 系统下载这个下载地址https://kodo-toolbox-new.qiniu.com/qshell-v2.19.2-windows-amd64.zip下载后解压你会得到一个qshell.exe文件。注意不要双击打开打开PowerShell或命令提示符WinR 输入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
