daniel156161/borgbackup-ssh

BorgBackup Docker镜像文档

镜像概述

本镜像基于轻量级Alpine Linux构建，集成BorgBackup备份工具、SSH服务及公钥认证机制，旨在提供安全、高效且资源友好的备份解决方案。Alpine基础确保镜像体积小巧，适合资源受限环境，同时通过SSH公钥认证保障备份操作的安全性。

核心功能与特性

• 轻量级基础：采用Alpine Linux作为基础镜像，显著降低资源占用，镜像体积小
• BorgBackup集成：预装BorgBackup工具，支持数据备份、恢复、重复数据删除及加密功能
• SSH服务支持：内置SSH服务，允许远程客户端通过SSH协议连接并执行备份操作
• 公钥认证机制：支持SSH公钥认证，避免密码传输风险，提升访问安全性
• 持久化存储：支持挂载外部卷以持久化存储备份数据和SSH配置

使用场景与适用范围

• 个人或小型团队的本地/远程数据备份需求
• 需要高效重复数据删除功能的备份场景（如多版本文件备份）
• 对安全性有要求的远程备份环境（通过SSH公钥认证确保访问安全）
• 资源受限环境（如嵌入式设备、边缘节点）的备份部署

使用方法与配置说明

前提条件

• 已安装Docker引擎（20.10+推荐）
• 准备SSH公钥文件（用于认证配置）
• 规划备份数据存储路径（需持久化）

Docker Run部署示例

bash
docker run -d \
  --name borgbackup \
  -p 2222:22 \  # 映射SSH端口到主机（主机端口:容器端口）
  -v /local/ssh/keys:/root/.ssh:ro \  # 挂载本地SSH密钥目录（只读权限）
  -v /local/backup/data:/backup \  # 挂载备份数据存储目录
  --restart unless-stopped \
  daniel156161/borgbackup-docker

核心配置说明

SSH公钥配置

1. 准备公钥文件：将客户端SSH公钥（通常为id_rsa.pub）内容添加至authorized_keys文件：

   bash
   cat /local/ssh/keys/id_rsa.pub >> /local/ssh/keys/authorized_keys
   

2. 权限设置：确保挂载的本地密钥目录及文件权限正确：

   bash
   chmod 700 /local/ssh/keys
   chmod 600 /local/ssh/keys/authorized_keys
   

备份操作示例

远程连接容器：

bash
# 通过SSH连接到容器（替换主机IP和端口）
ssh -p 2222 root@192.168.1.100

创建备份仓库：

bash
# 在容器内初始化加密备份仓库（替换仓库名称）
borg init --encryption=repokey /backup/my_backup_repo

执行备份：

bash
# 备份指定目录到仓库（自动生成带日期的版本标签）
borg create /backup/my_backup_repo::backup-$(date +%Y%m%d) /path/to/source/data

持久化卷说明

注意事项

• 密钥安全：妥善保管BorgBackup仓库的加密密钥（repokey），丢失将导致数据无法恢复
• 端口映射：避免使用默认SSH端口（22），建议自定义主机端口以降低暴露风险
• 版本更新：定期更新镜像以获取BorgBackup和Alpine的安全补丁
• 详细文档：更多配置细节请参考GitHub仓库：https://github.com/daniel***/borgBackup-Docker