4.2 KiB
Executable File
4.2 KiB
Executable File
DBCheck — 开源跨平台数据库巡检工具研究
来源: https://mp.weixin.qq.com/s/tR4FpYFnfi6vFmPgoNSUuA 研究日期: 2026-05-05
项目概览
- 名称: DBCheck
- GitHub: https://github.com/fiyo/DBCheck.git
- 官网: https://dbcheck.top
- 许可证: MIT
- 定位: 开源跨平台数据库巡检工具，一键生成专业巡检报告
支持的数据库
| 数据库 | 连接资源 | 缓存性能 | 查询效率 | 日志 | 安全 | 集群 |
|---|---|---|---|---|---|---|
| MySQL | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| PostgreSQL | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| SQL Server | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| 达梦 DM8 | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| TiDB | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Oracle | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
解决的三大痛点
| 痛点 | 说明 | DBCheck 方案 |
|---|---|---|
| 重复劳动 | 50 套库 × 20 分钟 = 16 小时 | 一键自动，3 分钟出报告 |
| 标准不一 | 不同 DBA 巡检质量差异大 | 内置 130+ 标准化规则 |
| 历史缺失 | 无法判断趋势 | 自动保存快照，趋势折线图 |
系统架构
用户交互层
├── CLI 模式（自动化脚本/CI/CD）
├── Web UI 模式（Flask + 原生 JS）
└── 编程接口（Python 模块 import）
核心调度层
├── checkdb() 总入口
├── APScheduler 定时调度
└── SSH 隧道支持
数据库适配层
├── main_mysql.py
├── main_pg.py
├── main_sqlserver.py
├── main_dm.py（达梦）
└── main_tidb.py
分析引擎层
├── analyzer.py（130+ 规则引擎）
├── slow_query_analyzer.py（慢查询分析）
└── AI 诊断模块（Ollama 本地）
输出层
├── Word 报告（python-docx）
└── Web UI 可视化报告
核心功能
1. AI 智能诊断
- 本地部署 Ollama，数据零出站，满足等保合规
- 建议包含：问题描述 + 可执行 SQL + 操作影响 + 优先级标注
- 安全约束：硬编码仅允许 localhost，无法被配置绕过
2. 130+ 条标准化检查规则
覆盖维度：
- 连接资源（连接数使用率、连接堆积）
- 缓存性能（Buffer Pool 命中率）
- 查询效率（全表扫描、慢查询）
- 日志与告警（错误日志、归档日志空间）
- 安全审计（弱密码、权限过剩）
- 复制/集群（主从延迟、Region 均衡）
3. 历史趋势分析
- 每次巡检快照自动存入
history.json（SQLite 版本规划中） - Web UI 折线图展示关键指标历史变化
- 支持任意时间段对比
4. 慢查询深度分析
- 解析慢查询日志，提取 Top 20 慢 SQL
- 执行 EXPLAIN 模拟，识别全表扫描、索引缺失
- 自动生成建议创建的索引 SQL
5. RAG 知识库（进阶功能）
- 支持格式：PDF、Markdown、TXT、HTML
- 检索增强生成，让 AI 建议更精准
6. 定时巡检 + 多渠道告警
- 基于 APScheduler，支持标准 Cron 表达式
- 企业微信/钉钉/邮件通知
快速上手
# 方式一：源码运行
git clone https://github.com/fiyo/DBCheck.git
cd DBCheck
pip install -r requirements.txt
python web_ui.py
# 访问 http://localhost:5000
# 方式二：下载可执行文件
# Windows: DBCheck.exe
# Linux: DBCheck-Linux-x64
# macOS: DBCheck-macOS-x64
技术栈
| 组件 | 技术 |
|---|---|
| 后端 | Python + Flask |
| 报告生成 | python-docx |
| 定时任务 | APScheduler |
| AI 诊断 | Ollama（本地 LLM） |
| 前端 | 原生 JS（无重型框架） |
| 数据持久化 | history.json → 规划 SQLite |
开源理念
- MIT 许可证，商用/修改/分发自由
- 所有检查 SQL、AI Prompt、报告逻辑全部开源可审计
- 功能路线图由社区投票决定
- 参与方式：Star / Issue / PR
项目评价
优点：
- ✅ 解决真实痛点，实用性强
- ✅ 多数据库支持，国产达梦也在列
- ✅ AI 诊断本地部署，安全合规
- ✅ 架构清晰，模块化设计
- ✅ 零重型前端依赖，部署极简
可改进：
- 🔧 历史数据目前用 JSON，建议尽早切 SQLite
- 🔧 Web UI 较简单，可考虑 Vue3/Element Plus 升级
- 🔧 可增加更多数据库（MongoDB、Redis 等）