v2.7.0 现已发布

智能数据库
健康巡检平台

快速开始查看源码插件系统

数据库类型

检查规则

使用方式

插件

可扩展系统

DBCheck — 数据库智能巡检

$ python web_ui.py

[*] DBCheck v2.7.7 启动中...

[+] Web UI 已启动: http://localhost:5003

[+] 连接数据库成功 (MySQL 8.0.35)

[*] 执行巡检: 160 项检查规则

[!] 发现 3 项风险 (1 高危, 1 中危, 1 低危)

[*] AI 本地诊断中 (Ollama qwen2.5)...

[+] 巡检报告已生成: MySQL巡检报告_20260619.docx

$ _

软件介绍

什么是 DBCheck？

开源跨平台数据库自动化健康巡检工具，专为 DBA 和运维团队打造

🎯

产品定位

DBCheck 是一款开源跨平台数据库自动化健康巡检工具，通过丰富的检查规则、AI 智能诊断和插件扩展系统，让数据库巡检从重复手工劳动转变为全自动化流程。

🔒

安全承诺

AI 诊断仅支持本地 Ollama，数据绝不外传。报告导出支持数据脱敏，自动掩码敏感信息。 MIT 开源协议，代码完全透明。

🚀

适用场景

DBA 日常健康巡检
数据库迁移前健康评估
性能瓶颈定位与优化
安全合规配置审计
Oracle AWR 报告解析

🌍

部署灵活

命令行 — 服务器自动化
Web UI — 浏览器可视化
Docker — 一条命令部署
OpenClaw Skill — AI 助手集成
打包版 — 零依赖分发

核心功能

v2.7.0 功能全览

专为 DBA 打造的全方位数据库健康检查解决方案

插件扩展系统

热加载插件，无需重启。GitHub 驱动插件市场，官方与社区插件清晰标识。让 DBCheck 从"工具"进化为"平台"。

热加载插件市场 v2.7.0

AI 智能诊断（完全离线）
仅支持本地 Ollama，数据绝不外传。代码层硬性限制，即使配置文件被篡改也会自动降级。适合金融、政务等高安全场景。

本地 Ollama 零数据外传

Oracle AWR 报告解析

上传 AWR 报告（HTML 或 TEXT），自动解析并生成结构化 Word 分析报告，附带 AI 诊断建议。大幅降低 Oracle 性能分析门槛。

HTML/TEXT Word 报告

自动生成 Word 报告

一键生成专业巡检报告，包含风险卡片、配置分析、趋势图表。支持数据脱敏，自动掩码 IP、端口、用户名等敏感信息。

配置基线检查

自动比对数据库参数与推荐基线值，支持根据内存和负载自动计算推荐值，识别配置偏差，防止性能隐患。

索引健康分析

检测缺失索引、冗余索引、未使用索引，给出优化建议，提升查询效率。让数据库跑得更快。

数据脱敏导出

导出 Word 报告时自动掩码 IP、端口、用户名等敏感信息，防止信息泄露。适合对外交付场景。

历史趋势分析

多次巡检数据自动汇聚，生成指标趋势折线图，与上次对比一目了然，提前发现潜在风险。

定时巡检 + 告警

支持 Cron 表达式定时任务，巡检完成后自动发送邮件/Webhook 告警。集成到现有运维体系，无人值守。

Docker 一键部署

支持 Docker Hub 和 GHCR 镜像，一条命令启动，支持 amd64/arm64 双架构。适合服务器快速部署。

多架构一键部署

PDF 报告导出

支持将 DOCX 巡检报告转换为 PDF，方便分享和归档。保持原有格式，适合正式汇报场景。

RAG 知识库

上传官方文档构建本地知识库，AI 诊断时自动检索相关最佳实践，让建议更精准、更有依据。

插件系统

核心突破：插件扩展

热加载、插件市场、官方与社区清晰标识，让 DBCheck 从"工具"进化为"平台"

🔌 插件系统
让功能无限延伸

DBCheck 引入完整的插件扩展架构。巡检规则、通知渠道、报告模板均可通过插件扩展，无需修改核心代码，热加载即时生效。

热加载 — 安装插件无需重启，即时生效
插件市场 — GitHub 驱动，一键浏览和安装
来源标识 — 官方与社区插件清晰区分
开发友好 — 标准 Python 插件接口，10 分钟上手
自动更新 — 插件可独立版本化管理

// 插件市场预览

oracle-awr-parser

Oracle AWR 报告智能解析

官方

notify-feishu

巡检完成推送飞书通知

社区

report-executive

高管版巡检报告模板

社区

baseline-checker

数据库配置基线检查

官方

查看完整插件市场

亮点特性

为什么 DBCheck 与众不同？

带来的核心突破

🔌

插件扩展系统

热加载插件，无需重启。GitHub 驱动插件市场，官方与社区插件清晰标识。

巡检规则通知渠道报告模板

🤖

AI 诊断（完全离线）

仅支持本地 Ollama，数据绝不外传。代码层硬性限制，适合金融、政务等高安全场景。

本地 Ollama 零数据外传内网可用

📊

Oracle AWR 智能解析

上传 AWR 报告（HTML 或 TEXT），自动解析并生成 Word 报告，附带 AI 诊断建议。

HTML/TEXT Word 报告 AI 诊断

🐳

Docker 多架构支持

支持 amd64 和 arm64 双架构镜像，Docker Hub 和 GHCR 双源分发，一条命令启动。

多架构双源分发

🔐

数据脱敏导出

导出报告时自动掩码 IP、端口、用户名等敏感信息。适合对外交付和合规审计场景。

自动脱敏合规友好

📈

趋势分析与对比

多次巡检数据自动汇聚，生成趋势折线图，与上次对比一目了然，提前发现潜在风险。

趋势图历史对比

🔐

RBAC 权限管理

支持基于角色的访问控制，精细化管理用户权限，确保数据安全。

用户管理角色管理菜单与权限

快速上手

安装即用，五种方式

选择最适合你的使用方式

Bash / Terminal

# 克隆仓库

git clone https://github.com/fiyo/DBCheck.git

# 进入目录

cd DBCheck

# 安装依赖

pip install -r requirements.txt

# 启动 Web UI

python web_ui.py

# 访问浏览器

 http://localhost:5003

Docker CLI

# 拉取镜像 (Docker Hub)

docker pull jackge12345/dbcheck:latest

# 或使用 GHCR 镜像

docker pull ghcr.io/fiyo/dbcheck:latest

# 启动容器

docker run -d --name dbcheck -p 5003:5003 \

  -v $(pwd)/config:/app/config \

  -v $(pwd)/data:/app/data \

  jackge12345/dbcheck:latest

# 访问 Web UI

http://localhost:5003

OpenClaw CLI

# 安装 DBCheck Skill

clawhub install dbcheck

# 执行巡检 (自然语言)

帮我巡检一下 MySQL 数据库 192.168.1.100

# 查看历史报告

显示最近的巡检报告

命令行

# 下载打包版 (Windows)

wget https://github.com/fiyo/DBCheck/releases/download/v2.6.0/DBCheck-Windows-v2.6.0.zip

# 解压后直接运行

dbcheck.exe

# 无需安装 Python / 无需安装依赖

# 适合快速演示和内网分发

cURL / HTTP

# 健康检查

curl http://localhost:5003/api/v1/health

# 触发巡检

curl -X POST http://localhost:5003/api/v1/inspect \

  -H "Content-Type: application/json" \

  -d '{"db_type":"mysql","host":"192.168.1.100"}'

# 查看历史报告列表

curl http://localhost:5003/api/v1/reports

# 完整 API 文档见 GitHub README

五种使用方式

灵活选择，总有一款适合你

⌨️

命令行

直接运行脚本，适合服务器自动化

无需图形界面
易于集成 CI/CD
支持定时任务
批量巡检

🌐

Web UI

可视化界面，操作更直观

浏览器即可访问
实时查看进度
一键切换语言
管理定时任务

🐚

OpenClaw Skill

集成到 AI 助手中

自然语言操作
无需安装 Python
跨平台支持
自动更新

🐳

Docker

一键容器化部署，零依赖

一条命令启动
支持 amd64/arm64
数据持久化
适合服务器部署

🔌

REST API

程序化调用，集成到现有系统

JSON 格式返回
集成到监控系统
灵活的触发方式
支持 Token 认证

常见问题

你可能想问的问题

关于 DBCheck 的常见疑问解答

DBCheck 是免费的吗？

是的，DBCheck 基于 MIT 开源协议，完全免费。你可以自由使用、修改和分发，包括商业用途。

AI 诊断会泄露数据吗？

DBCheck 的 AI 诊断支持本地 Ollama 模型，使用本地 Ollama，所有数据都在本地处理，绝不会发送到外部 API。如果想使用在线模型（如 OpenAI），请确保网络环境安全，并注意数据隐私。

支持哪些数据库？

目前支持 10 种主流关系型数据库：MySQL、PostgreSQL、Oracle、SQL Server、达梦 DM8、TiDB、IvorySQL、YashanDB、KingbaseES、GBase 8s。更多数据库支持持续增加中。

插件系统怎么用？

在 Web UI 中进入"插件市场"，浏览可用插件，点击安装即可。插件支持热加载，安装后无需重启。也可以手动将插件放入 plugins/ 目录，DBCheck 会自动加载。

可以用于生产环境吗？

可以。DBCheck 的检查规则都是只读操作（SELECT、SHOW 等），不会对数据库进行任何写入或修改。但是如果使用在线修复功能，则会对生产环境进行修改，在使用此功能前需自行评估安全性，建议先在测试环境验证，再用于生产环境。

如何参与贡献？

欢迎提交 PR、Issue 或插件！请访问 GitHub 仓库了解贡献指南。插件开发文档详见插件仓库。

智能数据库
健康巡检平台

什么是 DBCheck？

产品定位

安全承诺

适用场景

部署灵活

v2.7.0 功能全览

插件扩展系统

AI 智能诊断（完全离线）
仅支持本地 Ollama，数据绝不外传。代码层硬性限制，即使配置文件被篡改也会自动降级。适合金融、政务等高安全场景。

本地 Ollama 零数据外传

Oracle AWR 报告解析

自动生成 Word 报告

配置基线检查

索引健康分析

数据脱敏导出

历史趋势分析

定时巡检 + 告警

Docker 一键部署

PDF 报告导出

RAG 知识库

核心突破：插件扩展

🔌 插件系统
让功能无限延伸

覆盖 10 种主流数据库

为什么 DBCheck 与众不同？

插件扩展系统

AI 诊断（完全离线）

Oracle AWR 智能解析

Docker 多架构支持

数据脱敏导出

趋势分析与对比

RBAC 权限管理

简单四步，完成数据库巡检

安装即用，五种方式

五种使用方式

命令行

Web UI

OpenClaw Skill

Docker

REST API

你可能想问的问题

准备好开始了吗？

智能数据库 健康巡检平台

什么是 DBCheck？

产品定位

安全承诺

适用场景

部署灵活

v2.7.0 功能全览

插件扩展系统

AI 智能诊断（完全离线） 仅支持本地 Ollama，数据绝不外传。代码层硬性限制，即使配置文件被篡改也会自动降级。适合金融、政务等高安全场景。 本地 Ollama 零数据外传

Oracle AWR 报告解析

自动生成 Word 报告

配置基线检查

索引健康分析

数据脱敏导出

历史趋势分析

定时巡检 + 告警

Docker 一键部署

PDF 报告导出

RAG 知识库

核心突破：插件扩展

🔌 插件系统让功能无限延伸

覆盖 10 种主流数据库

为什么 DBCheck 与众不同？

插件扩展系统

AI 诊断（完全离线）

Oracle AWR 智能解析

Docker 多架构支持

数据脱敏导出

趋势分析与对比

RBAC 权限管理

简单四步，完成数据库巡检

安装即用，五种方式

五种使用方式

命令行

Web UI

OpenClaw Skill

Docker

REST API

你可能想问的问题

准备好开始了吗？

智能数据库
健康巡检平台

AI 智能诊断（完全离线）
仅支持本地 Ollama，数据绝不外传。代码层硬性限制，即使配置文件被篡改也会自动降级。适合金融、政务等高安全场景。

本地 Ollama 零数据外传

🔌 插件系统
让功能无限延伸