B2命令行工具Docker镜像

镜像概述

B2命令行工具Docker镜像是Backblaze B2云存储的官方容器化解决方案，提供跨平台、无依赖的B2服务访问能力。通过该镜像，用户可在任何支持Docker的环境中便捷使用B2的所有命令行功能，无需单独配置系统依赖。

核心功能与特性

• 跨平台兼容：基于Docker实现真正的平台无关性，支持Linux、Windows、macOS等所有Docker兼容系统
• 完整功能访问：提供B2云存储的全部命令行能力，包括账户管理、桶操作、文件上传/下载/同步、复制规则管理等
• 版本稳定性：采用ApiVer版本控制策略，确保长期脚本运行的稳定性（推荐使用b2v4命令）
• 轻量部署：无需安装Python环境或系统依赖，直接通过容器运行命令

使用场景

• 需要在多操作系统环境中统一B2 CLI使用方式的开发/运维场景
• 容器化部署环境中集成B2存储操作的自动化流程
• 临时或一次性B2操作需求，避免系统环境污染
• 脚本自动化任务（如定时备份、数据同步）中确保命令兼容性

使用方法与配置说明

基础使用命令

通过Docker运行B2 CLI命令的基本格式：

docker run backblazeit/b2:latest [命令参数]

授权方式

单次命令授权

通过环境变量传递应用密钥进行临时授权（以列出桶为例）：

B2_APPLICATION_KEY=<你的应用密钥> B2_APPLICATION_KEY_ID=<你的应用密钥ID> docker run --rm -e B2_APPLICATION_KEY -e B2_APPLICATION_KEY_ID backblazeit/b2:latest b2v4 bucket list

持久化授权

首次运行交互式授权并保存凭证到卷：

docker run --rm -it -v b2:/root backblazeit/b2:latest b2v4 account authorize

后续使用时挂载该卷即可自动加载授权信息：

docker run --rm -v b2:/root backblazeit/b2:latest b2v4 bucket list  # 需保持-v参数以加载授权卷

文件上传与下载

管道方式上传单个文件

通过标准输入传递文件内容：

cat 本地文件.txt | docker run -i --rm -v b2:/root backblazeit/b2:latest b2v4 upload-unbound-stream 桶名称 - 目标文件名

挂载本地文件系统上传

通过挂载本地目录将文件传入容器：

docker run --rm -v b2:/root -v /本地路径:/data backblazeit/b2:latest b2v4 file upload 桶名称 /data/本地文件.txt 目标文件名

ApiVer CLI版本说明

为确保脚本长期稳定性，推荐在自动化场景中使用版本绑定命令：

• b2v4：稳定版本命令，提供长期接口兼容性保证，适合脚本使用
• b2：最新稳定接口命令，包含最新特性，适合交互式使用
• _b2v5：预览版本，不稳定，不建议生产环境使用

示例（脚本中推荐用法）：

docker run backblazeit/b2:latest b2v4 sync /data b2://my-bucket/backup

日志与调试

• 详细日志：添加--verbose标志启用标准输出详细日志
• 调试日志：使用--debug-logs标志在当前目录生成b2_cli.log日志文件（含午夜自动轮转）

  注意：避免在同步目录中运行，防止日志文件被同步上传

• 自定义日志配置：通过--log-config <配置文件.ini>指定自定义日志格式，配置示例可参考官方调试日志配置

镜像标签

• latest：最新稳定版本，推荐生产环境使用
• 特定版本标签（如v4.2.0）：指定版本，适合需要固定版本的场景

注意事项

• 持久化授权时需确保b2卷未被意外删除，否则需重新授权
• 挂载本地目录时注意文件权限，容器内默认使用root用户
• 大文件上传建议使用挂载方式而非管道，以提高稳定性和性能
• 脚本中务必使用b2v4而非b2命令，避免因版本更新导致接口变化