tianon/backblaze-b2

B2 命令行工具镜像文档

镜像概述

本镜像包含Backblaze B2云存储服务的官方命令行工具（CLI），旨在提供轻量级、跨平台的方式通过命令行界面管理B2云存储资源。用户可通过该工具执行文件传输、存储桶配置、权限管理等操作，无需在本地系统直接安装B2 CLI依赖。

核心功能与特性

• 文件传输管理：支持单个/批量文件上传（含大文件分块上传）、下载（支持断点续传）及删除操作。
• 存储桶管理：创建、列出、删除存储桶，配置存储桶访问权限（私有/公有）及生命周期规则。
• 文件版本控制：查看文件历史版本、恢复旧版本或永久删除特定版本。
• 权限与安全：通过应用密钥控制访问权限，支持基于密钥的细粒度操作授权。
• 数据校验：集成校验机制，确保文件传输完整性（基于SHA-1哈希验证）。
• 元数据管理：查看/设置文件自定义元数据，支持存储额外文件属性信息。

使用场景

• 自动化备份：集成到Shell脚本或CI/CD流程，实现服务器数据、应用备份文件自动上传至B2云存储。
• 跨服务器数据同步：在多台服务器间通过B2云存储中转同步文件，避免直接网络传输限制。
• 开发环境集成：在开发/测试环境中快速验证B2 API功能，或模拟云存储操作流程。
• 轻量级管理工具：在无图形界面的服务器环境中，通过命令行高效管理B2存储资源。

使用方法与配置说明

基本使用前提

使用前需准备Backblaze B2账户的Account ID和Application Key（可在B2账户控制台的"应用密钥"页面创建）。

快速启动（Docker Run）

通过以下命令运行B2 CLI工具，执行基本操作（以列出存储桶为例）：

bash
docker run --rm \
  -e B2_ACCOUNT_ID="your_account_id" \
  -e B2_APPLICATION_KEY="your_application_key" \
  backblaze/b2 \
  b2 bucket list

• --rm：容器退出后自动清理，适合临时命令执行。
• -e：设置环境变量，用于B2账户认证。

挂载本地目录传输文件

如需与本地文件系统交互（如上传本地文件），需挂载主机目录至容器内：

bash
docker run --rm \
  -e B2_ACCOUNT_ID="your_account_id" \
  -e B2_APPLICATION_KEY="your_application_key" \
  -v /path/to/local/files:/data \
  backblaze/b2 \
  b2 upload-file my-bucket /data/local-file.txt remote-file.txt

• -v /path/to/local/files:/data：将主机本地目录挂载到容器内/data路径，实现文件共享。

Docker Compose配置示例

适用于需持久化配置或频繁使用的场景：

yaml
version: '3'
services:
  b2-cli:
    image: backblaze/b2
    environment:
      - B2_ACCOUNT_ID=your_account_id
      - B2_APPLICATION_KEY=your_application_key
    volumes:
      - ./local-data:/data  # 本地数据目录挂载
    command: "b2 bucket list"  # 默认执行的命令，可替换为实际操作

核心配置参数

常用命令示例

1. 验证配置并查看账户信息：

   bash
   docker run --rm -e B2_ACCOUNT_ID=xxx -e B2_APPLICATION_KEY=yyy backblaze/b2 b2 account info
   

2. 创建存储桶：

   bash
   docker run --rm -e B2_ACCOUNT_ID=xxx -e B2_APPLICATION_KEY=yyy backblaze/b2 b2 bucket create my-backup-bucket allPrivate
   

3. 下载文件：

   bash
   docker run --rm -e B2_ACCOUNT_ID=xxx -e B2_APPLICATION_KEY=yyy -v ./downloads:/data backblaze/b2 b2 download-file-by-id my-bucket file-id /data/downloaded-file.txt
   

注意事项

• 敏感信息（如B2_APPLICATION_KEY）建议通过环境变量注入，避免硬编码在容器镜像或配置文件中。
• 大文件上传需确保容器有足够临时存储空间，或通过-v挂载主机临时目录至容器/tmp路径。
• 详细命令文档可通过docker run --rm backblaze/b2 b2 help查看完整CLI命令列表及参数说明。