lnxd/github-backup

GitHub备份脚本 Docker镜像

镜像概述和主要用途

该Docker容器包含backup.py脚本，用于备份GitHub仓库。通过提供GitHub token和目标目录，脚本可克隆所有token可访问的仓库，并支持定时运行。重复运行时仅更新现有备份并添加新仓库，实现增量备份。

核心功能和特性

• 使用GitHub token进行授权访问
• 克隆所有token可访问的仓库（公开/私有取决于token权限）
• 支持定时运行，实现定期自动备份
• 增量更新机制：重复运行仅更新现有备份并添加新仓库

使用场景和适用范围

适用于需要定期备份GitHub仓库的个人开发者或团队，尤其适合希望自动化备份流程、确保代码仓库安全及版本历史完整保存的用户。

详细使用方法和配置说明

安装

可通过Unraid的Community Applications（CA）完成安装。

配置

创建GitHub token

授权需创建个人GitHub token，步骤如下：

1. 访问https://github.com/settings/tokens
2. 点击Generate new token按钮进入token创建页面
3. 为token设置描述性名称，并选择权限范围（scopes）：
   • 需备份公开和私有仓库：选择repo权限
   • 仅需备份公开仓库：选择public_repo权限
4. 点击Generate token按钮生成token，生成后请立即保存（GitHub不会再次显示该token）

Docker部署示例

docker run命令

bash
docker run -d \
  --name github-backup \
  -v /path/to/backup/directory:/backup \
  -e GITHUB_TOKEN=your_github_token \
  --restart unless-stopped \
  lnxd/github-backup

说明：将/path/to/backup/directory替换为本地备份目录路径，your_github_token替换为创建的GitHub token。

最后说明

如发现任何bug，欢迎提交Issue或Pull Request。关于在Unraid上使用的支持，可通过Unraid社区论坛的支持线程联系。