# git_backup_site

**Repository Path**: web/git_backup_site

## Basic Information

- **Project Name**: git_backup_site
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-10-25
- **Last Updated**: 2025-11-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: backup

## README

# Gitee网站备份插件

一个功能强大的宝塔面板插件，用于自动将网站文件备份到Gitee代码仓库，支持增量备份和灵活的定时任务配置。

## 功能特性

### 🔄 多种备份方案
- **基础方案**：简单快速的文件备份
- **优化方案**：智能增量备份，节省存储空间
- **高级方案**：完整的备份策略，包含快照和日志记录

### ⏰ 灵活的定时任务
- 可选择启用或禁用计划任务
- 自定义备份执行时间
- 智能检测计划任务状态

### 🔒 安全可靠
- 支持文件排除规则
- Git用户信息配置
- SSH密钥自动配置

### 📊 可视化界面
- 直观的备份任务管理
- 实时备份日志查看
- 一键手动执行备份

## 安装说明

### 前置要求
- 宝塔面板 7.0+
- 已安装Git
- Gitee账户和仓库

### 安装步骤
1. 下载插件文件到宝塔插件目录
2. 执行安装脚本：
   ```bash
   cd /www/server/panel/plugin/gitee_backup
   bash install.sh
   ```
3. 在宝塔面板插件页面启用插件

## 使用指南

### 1. 全局配置
首次使用前需要配置全局设置：
- **Git用户信息**：设置提交时的用户名和邮箱
- **SSH密钥**：配置Gitee仓库的SSH访问权限
- **排除规则**：设置不需要备份的文件和目录

### 2. 创建备份任务
1. 在"添加备份"标签页选择要备份的网站
2. 配置Gitee仓库地址
3. 选择备份方案（基础/优化/高级）
4. 设置是否启用定时任务
5. 保存配置

### 3. 管理备份任务
- 在"备份列表"标签页查看所有备份任务
- 支持修改、删除、手动执行备份
- 查看备份执行日志

## 备份方案说明

### 基础方案
- 简单直接的文件备份
- 适合小型网站
- 备份速度快

### 优化方案（推荐）
- 智能增量备份
- 自动检测文件变化
- 节省存储空间和备份时间

### 高级方案
- 完整的备份策略
- 包含快照管理
- 详细的日志记录
- 适合企业级应用

## 配置说明

### Gitee仓库配置
- 仓库地址格式：`git@gitee.com:用户名/仓库名.git`
- 需要提前在Gitee创建空仓库
- 确保SSH密钥已添加到Gitee账户

### 排除规则配置
支持多种排除模式：
- 文件扩展名：`*.log`, `*.tmp`
- 目录路径：`cache/`, `logs/`
- 正则表达式模式

## 常见问题

### Q: SSH连接测试失败怎么办？
A: 检查以下项目：
1. SSH密钥是否正确配置
2. Gitee仓库是否设置为公开或已添加部署密钥
3. 网络连接是否正常

### Q: 备份速度很慢怎么办？
A: 可以尝试：
1. 使用优化方案减少备份数据量
2. 配置更精确的排除规则
3. 在网络空闲时段执行备份

### Q: 如何查看详细的备份日志？
A: 日志文件位置：
- 基础方案：`/tmp/git_temp_backup_网站名/backup.log`
- 高级方案：`/var/log/gitee_backup_网站名_日期.log`

## 更新日志

### v1.0 (2025-10-25)
- 初始版本发布
- 支持三种备份方案
- 完整的定时任务管理
- 可视化界面操作

## 技术支持

- 作者：xiaogg
- 项目主页：[Gitee仓库](https://gitee.com/web/git_backup_site)
- 问题反馈：请在Gitee仓库提交Issue

## 许可证

本项目基于MIT许可证开源，详情请查看LICENSE文件。

---

**注意**：使用前请确保已阅读并理解相关配置要求，建议在生产环境使用前进行充分测试。