feat: 数据备份管理系统 v0.1.0
带 Web 操作界面的备份系统,支持: - 数据源:MySQL 数据库(mysqldump)、服务器目录(tar.gz) - 存储目标:本地目录、S3 兼容对象存储(MinIO/Ceph/AWS S3) - 触发方式:手动 + Cron 定时调度(APScheduler) - 备份还原:MySQL 库、目录 - JWT 登录认证 + Fernet 字段加密 - 保留策略:按数量 + 按天数双重清理 技术栈:FastAPI + SQLAlchemy 2 + APScheduler + aioboto3; 前端 Vite + React 18 + TypeScript + Ant Design 5 + Zustand。 Docker Compose 一键起。 Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,46 @@
|
||||
"""Fernet 对称加密工具:用于加密存储敏感字段(MySQL 密码、S3 SecretKey)。"""
|
||||
from cryptography.fernet import Fernet, InvalidToken
|
||||
|
||||
from app.config import get_settings
|
||||
|
||||
_fernet: Fernet | None = None
|
||||
|
||||
|
||||
def _get_fernet() -> Fernet:
|
||||
global _fernet
|
||||
if _fernet is None:
|
||||
_fernet = Fernet(get_settings().FERNET_KEY.encode())
|
||||
return _fernet
|
||||
|
||||
|
||||
def encrypt_str(plain: str) -> str:
|
||||
"""加密字符串,返回 base64-urlsafe 字符串(可安全存数据库 Text 字段)。"""
|
||||
if plain is None:
|
||||
return ""
|
||||
return _get_fernet().encrypt(plain.encode()).decode()
|
||||
|
||||
|
||||
def decrypt_str(token: str) -> str:
|
||||
"""解密字符串。空字符串返回空字符串。"""
|
||||
if not token:
|
||||
return ""
|
||||
try:
|
||||
return _get_fernet().decrypt(token.encode()).decode()
|
||||
except InvalidToken as e:
|
||||
raise ValueError(f"Failed to decrypt token (FERNET_KEY 可能已被更改): {e}") from e
|
||||
|
||||
|
||||
def encrypt_dict(data: dict) -> str:
|
||||
"""加密字典:序列化为 JSON 再加密。"""
|
||||
import json
|
||||
|
||||
return encrypt_str(json.dumps(data, ensure_ascii=False))
|
||||
|
||||
|
||||
def decrypt_dict(token: str) -> dict:
|
||||
"""解密字典。"""
|
||||
import json
|
||||
|
||||
if not token:
|
||||
return {}
|
||||
return json.loads(decrypt_str(token))
|
||||
@@ -0,0 +1,50 @@
|
||||
"""日志配置:控制台 + 文件 + 单 run StringIO Tee。"""
|
||||
import logging
|
||||
import os
|
||||
import sys
|
||||
from datetime import datetime
|
||||
from logging.handlers import RotatingFileHandler
|
||||
from pathlib import Path
|
||||
|
||||
from app.config import get_settings
|
||||
|
||||
_settings = get_settings()
|
||||
|
||||
_LOG_DIR = Path("logs")
|
||||
_LOG_DIR.mkdir(parents=True, exist_ok=True)
|
||||
|
||||
|
||||
def setup_logging() -> None:
|
||||
"""应用启动时调用一次。"""
|
||||
root = logging.getLogger()
|
||||
root.setLevel(_settings.LOG_LEVEL.upper())
|
||||
|
||||
# 避免重复添加 handler(uvicorn 重载时)
|
||||
if root.handlers:
|
||||
return
|
||||
|
||||
fmt = logging.Formatter(
|
||||
"%(asctime)s | %(levelname)-7s | %(name)s | %(message)s",
|
||||
datefmt="%Y-%m-%d %H:%M:%S",
|
||||
)
|
||||
|
||||
# 控制台
|
||||
console = logging.StreamHandler(sys.stdout)
|
||||
console.setFormatter(fmt)
|
||||
root.addHandler(console)
|
||||
|
||||
# 文件
|
||||
log_file = _LOG_DIR / f"app-{datetime.now():%Y-%m-%d}.log"
|
||||
file_handler = RotatingFileHandler(
|
||||
log_file, maxBytes=20 * 1024 * 1024, backupCount=10, encoding="utf-8"
|
||||
)
|
||||
file_handler.setFormatter(fmt)
|
||||
root.addHandler(file_handler)
|
||||
|
||||
# 调整 uvicorn 噪音
|
||||
logging.getLogger("uvicorn.access").setLevel(logging.WARNING)
|
||||
logging.getLogger("apscheduler.scheduler").setLevel(logging.INFO)
|
||||
|
||||
|
||||
def get_logger(name: str) -> logging.Logger:
|
||||
return logging.getLogger(name)
|
||||
Reference in New Issue
Block a user