littlebalalafairy/xianyu-auto-reply

Fork 0

mirror of https://github.com/zhinianboke/xianyu-auto-reply.git synced 2025-08-02 12:37:35 +08:00

zhinianboke 17cb117c89 新增多用户管理

2025-07-25 17:24:29 +08:00

9.0 KiB

Raw Blame History

数据库备份和恢复功能总结

🎯 功能概述

为闲鱼自动回复系统添加了直接的数据库文件备份和恢复功能，支持一键下载完整数据库文件和直接上传替换数据库，实现最简单有效的备份方案。

✨ 主要特性

🔽 数据库备份下载

一键下载：直接下载完整的SQLite数据库文件
自动命名：备份文件自动添加时间戳
完整备份：包含所有用户数据、设置、Cookie、卡券等
快速简单：无需复杂的导出过程

🔼 数据库恢复上传

直接替换：上传数据库文件直接替换当前数据库
自动验证：验证文件格式和完整性
安全备份：替换前自动备份当前数据库
自动重载：替换后自动重新初始化数据库连接

🛡️ 安全机制

权限控制：只有admin用户可以访问
文件验证：严格验证上传文件的格式和完整性
大小限制：限制上传文件大小（100MB）
回滚机制：失败时自动恢复原数据库

🔧 技术实现

后端API接口

1. 数据库下载接口

@app.get('/admin/backup/download')
def download_database_backup(admin_user: Dict[str, Any] = Depends(require_admin)):
    """下载数据库备份文件（管理员专用）"""

功能：

检查数据库文件存在性
生成带时间戳的文件名
返回FileResponse供下载

2. 数据库上传接口

@app.post('/admin/backup/upload')
async def upload_database_backup(admin_user: Dict[str, Any] = Depends(require_admin), 
                                backup_file: UploadFile = File(...)):
    """上传并恢复数据库备份文件（管理员专用）"""

功能：

验证文件类型和大小
验证SQLite数据库完整性
备份当前数据库
替换数据库文件
重新初始化数据库连接

3. 备份文件列表接口

@app.get('/admin/backup/list')
def list_backup_files(admin_user: Dict[str, Any] = Depends(require_admin)):
    """列出服务器上的备份文件（管理员专用）"""

功能：

扫描服务器上的备份文件
返回文件信息（大小、创建时间等）

前端界面

1. 系统设置页面集成

位置：主页 → 系统设置 → 备份管理

2. 数据库备份区域

<!-- 数据库备份 -->
<div class="col-md-6">
  <h6 class="mb-3">
    <i class="bi bi-database-down me-2"></i>数据库备份
  </h6>
  <button onclick="downloadDatabaseBackup()">下载数据库</button>
</div>

<!-- 数据库恢复 -->
<div class="col-md-6">
  <h6 class="mb-3">
    <i class="bi bi-database-up me-2"></i>数据库恢复
  </h6>
  <input type="file" id="databaseFile" accept=".db">
  <button onclick="uploadDatabaseBackup()">恢复数据库</button>
</div>

3. JavaScript函数

下载数据库备份：

async function downloadDatabaseBackup() {
  // 调用API下载数据库文件
  // 自动触发浏览器下载
}

上传数据库备份：

async function uploadDatabaseBackup() {
  // 验证文件选择和格式
  // 确认操作风险
  // 上传文件并处理结果
}

🎨 用户界面

备份管理布局

┌─────────────────────────────────────────────────────────────┐
│                        备份管理                              │
├─────────────────────────┬───────────────────────────────────┤
│      数据库备份          │         数据库恢复                │
│                        │                                   │
│ 直接下载完整的数据库文件  │ 上传数据库文件直接替换当前数据库    │
│                        │                                   │
│ [下载数据库]            │ [选择文件] [恢复数据库]            │
│                        │                                   │
│ 推荐方式：完整备份，恢复简单│ 警告：将覆盖所有当前数据！         │
└─────────────────────────┴───────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│              JSON格式备份（兼容模式）                        │
├─────────────────────────┬───────────────────────────────────┤
│    导出JSON格式备份      │       导入JSON格式备份            │
│                        │                                   │
│ [导出JSON备份]          │ [选择文件] [导入JSON备份]          │
└─────────────────────────┴───────────────────────────────────┘

🔄 备份流程

备份流程

用户点击"下载数据库"
    ↓
前端调用 /admin/backup/download
    ↓
后端检查权限和文件存在性
    ↓
生成带时间戳的文件名
    ↓
返回FileResponse
    ↓
浏览器自动下载文件
    ↓
备份完成

恢复流程

用户选择.db文件
    ↓
用户点击"恢复数据库"
    ↓
前端验证文件格式和大小
    ↓
用户确认操作风险
    ↓
前端上传文件到 /admin/backup/upload
    ↓
后端验证文件完整性
    ↓
备份当前数据库
    ↓
关闭当前数据库连接
    ↓
替换数据库文件
    ↓
重新初始化数据库连接
    ↓
验证新数据库
    ↓
返回恢复结果
    ↓
前端提示刷新页面
    ↓
恢复完成

🛡️ 安全特性

1. 权限验证

所有备份API都需要admin权限
前端页面自动检查用户身份
非管理员无法访问备份功能

2. 文件验证

严格验证文件扩展名（.db）
验证SQLite数据库格式
检查必要的数据表存在性
限制文件大小（100MB）

3. 操作保护

恢复前自动备份当前数据库
失败时自动回滚到原数据库
用户确认机制防止误操作
详细的操作日志记录

4. 错误处理

完善的异常捕获和处理
清晰的错误信息提示
自动清理临时文件
数据库连接状态管理

💡 使用方法

备份数据库

使用admin账号登录系统
进入"系统设置"页面
在"备份管理"区域点击"下载数据库"
浏览器会自动下载数据库文件

恢复数据库

在"备份管理"区域点击"选择文件"
选择之前下载的.db文件
点击"恢复数据库"按钮
确认操作风险
等待恢复完成
刷新页面加载新数据

📊 优势对比

特性	数据库文件备份	JSON格式备份
备份速度	⚡ 极快	🐌 较慢
文件大小	📦 最小	📦 较大
恢复速度	⚡ 极快	🐌 较慢
数据完整性	✅ 100%	✅ 99%
操作复杂度	🟢 简单	🟡 中等
兼容性	🟢 原生	🟡 需要处理
推荐程度	⭐⭐⭐⭐⭐	⭐⭐⭐

🎯 应用场景

1. 日常备份

定期下载数据库文件作为备份
简单快速，无需复杂操作
适合自动化脚本调用

2. 系统迁移

从一个服务器迁移到另一个服务器
直接复制数据库文件即可
保持数据完整性

3. 版本回滚

升级前备份数据库
出现问题时快速回滚
最小化停机时间

4. 数据同步

在多个环境间同步数据
开发、测试、生产环境数据一致
便于问题复现和调试

🚀 部署说明

立即可用

重启服务后功能立即生效
无需额外配置
兼容现有数据

文件权限

确保服务器有足够的文件读写权限：

# 确保数据库文件可读写
chmod 644 xianyu_data.db

# 确保目录可写（用于备份文件）
chmod 755 .

磁盘空间

备份文件会占用额外磁盘空间
建议定期清理旧的备份文件
监控磁盘使用情况

🎉 总结

数据库备份和恢复功能为闲鱼自动回复系统提供了：

✅ 核心价值

简单高效：一键备份和恢复，操作简单
完整可靠：100%数据完整性保证
安全稳定：完善的验证和保护机制
快速便捷：最快的备份和恢复速度

🎯 实用性

日常维护：定期备份保障数据安全
系统迁移：轻松迁移到新服务器
问题恢复：快速回滚到正常状态
开发测试：便于环境数据同步

9.0 KiB Raw Blame History Unescape Escape