企业官网建设流程全解析

开源数据库智能巡检平台 RaccoonX（原 DBCheck）功能详解与实战体验

让数据库运维可知 · 可控 · 可防
参考：官网 https://raccoonx.cn/ ｜ GitHub https://github.com/fiyo/DBCheck

一、RaccoonX 是什么

RaccoonX（原名DBCheck，浣熊图标，取"像浣熊一样夜行探索，让隐藏的数据库问题无所遁形"之意）是一款开源、跨平台的数据库智能巡检与实时监控平台，面向 DBA、数据库工程师、DevOps 与基础设施团队。

它把传统数据库巡检中"手动执行 SQL 脚本 → 检查操作系统资源 → 截屏取证 → 分析慢 SQL → 手工编写巡检报告"的整套流程，收敛为一个平台上的自动化流水线：

连接 → 巡检 → 采集 → 分析 → 识别风险 → 生成报告 → 变更跟踪 → AI 辅助诊断

关键数据（官网 / GitHub 实时）

二、极简部署：一条 Docker 命令跑起来

dockerrun-d-p5003:5003\-vdbcheck_data:/app/data\-vdbcheck_reports:/app/reports\--namedbcheck\jackge12345/dbcheck:latest

启动后访问http://localhost:5003，默认账号：

也支持docker-compose与源码安装（Python 3.10+，python web_ui.py），另有 Windows / macOS 桌面客户端（解压即用）。

三、核心亮点

1. 数据库巡检：344+ 规则一键体检

覆盖 21 种数据库，内置 344+ 巡检规则，覆盖基本信息、会话连接、内存缓存、表空间、SGA/PGA、Redo、归档备份、安全审计、Top SQL、复制/Data Guard、RAC、锁与阻塞等多维度检查，自动生成专业Word / P
DF 报告。

• 每条风险附带可执行修复 SQL，一键执行（危险操作二次确认 + 全程日志）
• 风险规则按库细分：MySQL 35+、PG 27+、Oracle 20+、SQL Server 15+、DM8 16+、TiDB 18+、Kingbase 19+、UXDB 12+ 等
• 典型 Oracle 报告达 20+ 章节（封面 → OS → 基本信息 → 表空间 → SGA/PGA → 关键参数 → Undo/Redo/Archive/DG/RAC/ASM → 会话/性能/安全 → 风险与建议 → AI 诊断建议）

2. 实时监控大屏：多实例健康态势一屏掌握

按实例展示吞吐（QPS/TPS）、连接数、响应延迟、端口可用性，基于 flask-socketio每 30 秒推送刷新；慢查询与连接热力图5~60 秒刷新可调，支持 CSV 导出。

• 支持深采的库展示完整指标；暂不支持的库自动降级为「端口可用性时间线 + 连通性诊断」
• 内置表空间剩余最危 Top10、复制延迟、锁等待、慢查询、实例健康分布与底部实时告警栏

3. 本地 AI 智能诊断：数据零外传

• 基于本地Ollama的离线诊断（数据完全不出网），同时支持OpenAI / DeepSeek云端后端
• AI 对话巡检：Web UI 内置 AI 面板，自然语言发起巡检
• RAG 知识库：上传 PDF / Word / MD / TXT 自动向量化，诊断时检索最佳实践
• Oracle AWR 分析：上传 AWR HTML 自动解析，生成结构化报告 + AI 建议
• 协同诊断中枢：由监控哨兵 / 巡检分析 / 根因定位 / SQL 治理 / 锁等待分析 5 位 AI 专员在共享上下文（黑板）上串行接力，输出根因推断 + 可执行处置方案，并为每个方案标注执行代价、回滚风险与维护窗口
• 可选接入BIC-QA 云端知识库，外发内容默认脱敏

4. 工作流编排（DAG）

把诊断专家、技能与脚本编排成有向无环图（DAG），可视化画布搭建「采集 → 分析 → 审批 → 处置」自动化流程，一次搭建、反复运行。

5. SQL 智能审核与安全自治

• 内置规则引擎自动体检慢 SQL、危险 DDL、缺 WHERE 的 UPDATE/DELETE，标注风险等级并给出优化建议与反向恢复语句
• 默认只读 dry-run，真实执行必须审批放行
• 写操作工单闭环：危险写操作先建工单、审批后放行；UPDATE/DELETE 执行前自动快照原行落备份表，影响行数硬上限兜底，支持一键回滚
• 全链路审计留痕：执行、回滚、审批动作 append-only 落库，谁在何时对哪个库做了什么全程可追溯

6. 报告与协作

• 一键生成 Word / PDF，自动掩码 IP、端口、账号等敏感信息
• 每种库可独立增删 / 排序 / 启停报告章节
• 分享链接免登录查看，权限隔离 + 访问统计，随时撤销
• 定时任务：Cron 预设，完成后自动邮件（带附件）或
  Webhook（企微 / 钉钉 / 自定义）

7. 更多运维能力

• 插件系统：独立生命周期、干净卸载、数据隔离（内置 MongoDB / Oracle JDBC 插件）
• SQL 编辑器（11 库语法高亮）+SSH 远程终端（多标签/全屏）
• 服务器巡检：CPU / 内存 / 磁盘 / 网络 / 服务 / 进程
• eBPF 内核级采集：块设备服务时间 p50/p95/p99 微秒级百分位，默认关闭、仅 opt-in
• SSH 安全宿主采集：零侵入、无需预装 Python，凭据 Fernet 加密
• REST API：API Key 认证，接入 CI/CD
• 容灾备份：定时库/文件备份 + 保留策略与健康追踪

四、支持数据库一览（21+）

五、实战体验：本机接入 3 个 Oracle（含 RAC 集群）

本机以 Docker 部署社区版 v26.9.29.0，已接入 3 个 Oracle
数据源：

首页「健康驾驶舱」按实例实时展示吞吐（QPS/TPS）、连接数、响应延迟，采集器运行中：

「数据库巡检」采用五步向导（数据库类型 → 连接信息 → SSH 配置 → 巡检设置 → 执行巡检），21 种数据库按 MySQL 系 / PG 系 / Oracle 系 / SQL Server 系 / NoSQL / KV 缓存 / OLAP 分类，支持 JDBC 插件化接入：

「监控大屏」一屏纳管全部实例：在线/总数、预警、严重+宕机、总连接数、总 QPS/TPS，实例状态矩阵异常置顶，右侧表空间最危/复制延迟/锁等待/慢查询 Top10，底部实时告警栏滚动展示（本机实例表空间剩余不足已触发严重告警）：

六、快速开始

# Docker（推荐）dockerpull jackge12345/dbcheck:latestdockerrun-d-p5003:5003-vdbcheck_data:/app/data-vdbcheck_reports:/app/reports--namedbcheck jackge12345/dbcheck:latest# docker-composecurl-odeploy/docker-compose.yml https://raw.githubusercontent.com/fiyo/DBCheck/main/deploy/docker-compose.ymldockercompose-fdeploy/docker-compose.yml up-d# 源码gitclone https://github.com/fiyo/DBCheck.gitcdDBCheck&&pipinstall-rdeploy/requirements.txt python web_ui. py

七、学习资源

• 官网：https://raccoonx.cn/ （产品亮点、功能全览、用户手册 PDF 下载）
• GitHub：https://github.com/fiyo/DBCheck （README / README_zh、源码、Issues、Discussions）
• Docker Hub：https://hub.docker.com/r/jackge12345/dbcheck
• 用户手册：官网「下载中心」可下载 v26.9.11.0 · PDF 约 10MB · 共 11 章

八、总结

RaccoonX 是当前少有的**「巡检 + 实时监控 + AI 诊断 + SQL 审核 + 工作流编排」五位一体**的开源数据库运维平台：社区版 Apache 2.0 免费、支持 21 种主流与国产数据库、可纯本地离线部署（数据零外传）、报告自动脱敏，天然契合信创与高安全监管场景。无论你是单一 MySQL 小站还是 Oracle RAC 集群，一条 Docker 命令即可纳入统一巡检与监控体系，把 DBA 的重复劳动变成一键流程。

如果本文对你有帮助，欢迎到 GitHub 给项目点个 ⭐（Star）：https://github.com/fiyo/DBCheck