cubebackup/workspace

CubeBackup for Google Workspace Docker镜像

镜像概述

CubeBackup for Google Workspace是一款自托管备份解决方案，允许您为整个组织的Google Drive、Shared Drive、Gmail、联系人及日历数据进行本地或云存储备份。本镜像为其官方Docker实现，便于快速部署和管理。

Dockerfile地址：https://github.com/CubeBackup/docker/blob/master/workspace-debian/release/Dockerfile

核心功能与特性

• 支持备份多种Google Workspace数据：Google Drive、Shared Drive、Gmail、联系人、日历
• 自托管架构，数据存储位置可控（本地或云存储）
• 灵活的数据持久化配置，确保备份数据、索引及配置安全
• 高性能数据索引设计，需配合本地SSD提升备份效率

适用场景

适用于需要对Google Workspace数据进行集中备份和管理的企业或组织，尤其适合对数据隐私和存储位置有严格要求的用户。

使用方法

基本用法

如需简单测试，可通过以下命令创建CubeBackup实例：

bash
docker run -d -p 80:80 --name cubebackup cubebackup/workspace

启动后，访问http://<主机服务器IP>，通过初始化配置向导完成Google Workspace域的备份设置。

数据持久化

由于CubeBackup处理重要备份数据，强烈建议配置数据持久化。Dockerfile中声明了2个卷，同时需考虑3个关键目录的持久化。

核心卷说明

1. /cubebackup_data
   备份数据存储位置。启动容器时，应将主机上的备份目标目录绑定挂载到容器的/cubebackup_data。

   提示：若备份至云存储（如Amazon S3），可忽略此卷。

2. /cubebackup_index
   数据索引存储位置。索引访问速度对备份性能至关重要，必须将主机本地SSD目录绑定挂载至此卷，不可使用网络存储。

   注意：仅支持直接本地存储（非网络挂载），推荐使用高速本地SSD以避免性能问题。数据索引详情见官方文档。

关键目录持久化

为确保配置、设置及日志在容器升级或重建时不丢失，需持久化以下目录：

• /opt/cubebackup/etc：存储主配置文件config.toml，建议使用命名卷（如cube_cfg）
• /opt/cubebackup/db：存储应用设置、密钥文件及SQLite会话数据库，建议使用命名卷（如cube_db）
• /opt/cubebackup/log：存储日志文件，建议使用命名卷（如cube_log）

持久化配置示例

以下命令启动带数据持久化的容器：

bash
sudo docker run -d -p 80:80 -p 443:443 \
  -v /var/cubebackup_index:/cubebackup_index \
  -v /var/cubebackup_data:/cubebackup_data \
  --mount source=cube_cfg,target=/opt/cubebackup/etc \
  --mount source=cube_db,target=/opt/cubebackup/db \
  --mount source=cube_log,target=/opt/cubebackup/log \
  --name cubebackup \
  cubebackup/workspace

提示：

• 若备份数据至云存储（如AWS S3），无需绑定挂载/cubebackup_data卷（即省略-v /var/cubebackup_data:/cubebackup_data）
• 如需启用HTTPS/SSL控制台，需同时发布443端口（-p 443:443）

使用docker-compose启动

以下是docker-compose.yml配置示例：

yaml
version: "3.8"
services:
  cubebackup:
    image: cubebackup/workspace
    restart: always
    ports:
      - "80:80"
      - "443:443"  # 仅HTTPS/SSL需要
    volumes:
      - /var/cubebackup_index:/cubebackup_index  # 本地SSD目录
      - /var/cubebackup_data:/cubebackup_data    # 本地备份目录（云存储可省略）
      - cube_cfg:/opt/cubebackup/etc
      - cube_db:/opt/cubebackup/db
      - cube_log:/opt/cubebackup/log
volumes:
  cube_cfg:
  cube_db:
  cube_log:

提示：

• 仅在启用HTTPS/SSL时需发布443端口
• 云存储备份时，可删除/cubebackup_data卷挂载配置

参考资料

• CubeBackup官方网站
• CubeBackup Docker安装指南
• Docker用户初始配置指南