B2 Command Line Tool 高级文件操作隐藏文件、法律保留、保留策略与服务器端复制实战指南【免费下载链接】B2_Command_Line_ToolThe command-line tool that gives easy access to all of the capabilities of B2 Cloud Storage项目地址: https://gitcode.com/gh_mirrors/b2/B2_Command_Line_ToolB2 Command Line Tool是 Backblaze B2 云存储的官方命令行工具一条命令即可管理桶、文件与复制策略。本文面向新手带你快速掌握 4 个高级文件操作隐藏文件hide、法律保留legal hold、保留策略retention与服务器端复制server-side copy让 B2 文件管理更专业、更安全。 一分钟了解4 个高级操作各解决什么问题操作对应命令解决的问题隐藏文件b2 file hide让文件“逻辑消失”不真正删除数据法律保留b2 file update --legal-hold on司法调查中冻结文件禁止删除保留策略b2 file update --file-retention-mode到期前强制保留防止误删服务器端复制b2 file server-side-copy零流量成本云端直接复制文件这些命令都实现在 b2/_internal/console_tool.py 中并在 b2/_internal/b2v4/registry.py 统一注册命令帮助文档见 doc/source/commands.rst。 隐藏文件比删除更优雅的“逻辑删除”B2 是版本化存储直接rm会真正删除文件版本。而file hide只是为该文件写一个“隐藏标记”让它在列表中消失历史版本依然可恢复。典型场景临时下线某个对象、覆盖“错误”的文件名、配合生命周期规则做延迟清理。# 隐藏桶中某个文件新版命令 b2 file hide b2://my-bucket/photos/old.jpg如果后悔了还可以用b2 file unhide删除这个隐藏标记把文件“变回来”b2 file unhide b2://my-bucket/photos/old.jpg对应源码是console_tool.py中的FileHideBase与FileUnhideBase类旧命令b2 hide-file已被标记为替代CmdReplacedByMixin建议直接使用file hide新语法。⚖️ 法律保留一键冻结任何人都删不掉如果你的账号开启了合规功能桶属性fileLockEnabledtrue就可以给文件加法律保留。开启后文件在解除之前无法被删除或覆盖非常适合司法取证、审计留痕等场景。# 为文件开启法律保留 b2 file update --legal-hold on b2://my-bucket/contract.pdf # 解除法律保留 b2 file update --legal-hold off b2://my-bucket/contract.pdf⚠️ 注意操作需要writeFileLegalHolds权限。相关实现见UpdateFileLegalHoldBase类通过update_file_legal_holdAPI 生效。⏳ 保留策略compliance 与 governance 怎么选保留策略File Retention让文件在指定时间之前不可修改、不可删除。B2 提供两种模式file update一条命令即可设置模式权限要求到期前能否取消/缩短适用场景compliance任何 Key 都不能解除❌ 绝对不可法规强制合规如医疗、金融governance需bypassGovernance权限✅ 可绕过解除企业内部控制留有余地# 设置 1000 天保留期时间戳为“毫秒级 epoch” b2 file update --file-retention-mode governance \ --retain-until 1767225600 b2://my-bucket/data.bin # 取消保留governance 模式需加 --bypass-governance b2 file update --file-retention-mode none \ --bypass-governance b2://my-bucket/data.bin记忆口诀compliance 是“锁死”governance 是“高级锁”。延长保留期、或从 governance 升级为 compliance随时都可以。⚡ 服务器端复制不下载、不上传秒级完成跨桶搬迁文件最笨的办法是“先下载再上传”而file server-side-copy直接在 B2 云端完成复制——不消耗你的下行/上行流量速度极快。# 从源文件复制到目标桶 b2 file server-side-copy \ b2://src-bucket/report_2026.pdf \ b2://archive-bucket/backups/report_2026.pdf几个进阶用法只复制一段内容--range参数支持按字节范围截取例如只复制前 10MB重写元数据默认复制源文件的 content-type 与 fileInfo可用--info keyvalue覆盖--no-info则清空复制时直接加锁配合--legal-hold on或--file-retention-mode复制落地的同时设置保留策略SSE-C 客户密钥场景源或目标使用 SSE-C 加密时需加--fetch-metadata先获取源文件元数据。命令支持最大 5GB新版 b2sdk 可达 10TB的单次复制实现位于FileServerSideCopyBase类旧命令copy-file-by-id同样已被file server-side-copy取代。 小结如何快速上手日常清理→b2 file hide/b2 file unhide可逆又安全法务取证→--legal-hold on冻结到调查结束合规归档→--file-retention-mode compliance到期前谁也动不了跨桶搬迁→b2 file server-side-copy省时省流量。更多命令细节可查阅源码 b2/_internal/console_tool.py、命令注册表 b2/_internal/b2v4/registry.py以及官方文档 doc/source/commands.rst 和快速上手指南 doc/source/quick_start.rst。【免费下载链接】B2_Command_Line_ToolThe command-line tool that gives easy access to all of the capabilities of B2 Cloud Storage项目地址: https://gitcode.com/gh_mirrors/b2/B2_Command_Line_Tool创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考