Backrest Docker镜像文档

概述

Backrest是restic的Web UI包装器，设计为自托管应用，用于管理数据备份。它提供直观的Web界面，简化restic备份工具的配置与操作，适合需要集中管理备份任务的场景。

核心功能

• 配置多个备份仓库（如本地存储、SFTP、S3、B2等restic支持的服务）
• 为每个仓库配置定时备份任务
• 手动触发备份操作
• 定时执行清理操作以释放旧数据
• 浏览快照历史记录
• 浏览快照中的文件内容

使用场景

适用于需要自托管备份解决方案的个人或小型团队，尤其适合需要管理多备份目标、自动化备份流程及定期清理旧备份数据的场景。

使用方法

Docker Run命令

通过以下命令快速启动Backrest容器：

docker run -p 9898:9898 -e BACKREST_PORT=9898 -e BACKREST_DATA=/data -e XDG_CACHE_HOME=/cache -v $(pwd)/.backrest/config:/.config/backrest -v $(pwd)/.backrest/data:/data -v $(pwd)/.backrest/cache:/cache garethgeorge/backrest:latest

Docker Compose配置

使用Docker Compose管理容器更便捷，示例配置如下：

version: "3.2"
services:
  backrest:
    image: garethgeorge/backrest:latest
    container_name: backrest
    hostname: backrest
    volumes:
      - ./backrest/data:/data  # Backrest数据目录（存放restic二进制文件和数据库）
      - ./backrest/config:/config  # 配置文件目录
      - ./backrest/cache:/cache  # 缓存目录
      - /MY-BACKUP-DATA:/userdata  # [可选] 挂载本地需备份的数据路径
      - /MY-REPOS:/repos  # [可选] 若使用本地存储仓库，挂载仓库路径（远程仓库如B2、S3等无需此步骤）
    environment:
      - BACKREST_DATA=/data  # Backrest数据目录路径，存放restic二进制文件和数据库
      - BACKREST_CONFIG=/config/config.json  # Backrest配置文件路径
      - XDG_CACHE_HOME=/cache  # 缓存目录路径，提升restic性能
      - TZ=America/Los_Angeles  # 容器时区，用于定时任务时间计算
    restart: unless-stopped
    ports:
      - 9898:9898

配置说明

环境变量