开源数据库智能巡检平台 RaccoonX原 DBCheck功能详解与实战体验让数据库运维可知 · 可控 · 可防参考官网 https://raccoonx.cn/ GitHub https://github.com/fiyo/DBCheck一、RaccoonX 是什么RaccoonX原名DBCheck浣熊图标取像浣熊一样夜行探索让隐藏的数据库问题无所遁形之意是一款开源、跨平台的数据库智能巡检与实时监控平台面向 DBA、数据库工程师、DevOps 与基础设施团队。它把传统数据库巡检中手动执行 SQL 脚本 → 检查操作系统资源 → 截屏取证 → 分析慢 SQL → 手工编写巡检报告的整套流程收敛为一个平台上的自动化流水线连接 → 巡检 → 采集 → 分析 → 识别风险 → 生成报告 → 变更跟踪 → AI 辅助诊断关键数据官网 / GitHub 实时指标数值支持数据库类型21 种含 10 国产数据库内置巡检规则344基线参数219Docker 镜像累计拉取28k官网/ 25,000GitHubGitHub Stars / Forks166 / 57协议Apache 2.0社区版完全开源界面语言9 种中/英/日/韩/西/法/德/俄等二、极简部署一条 Docker 命令跑起来dockerrun-d-p5003:5003\-vdbcheck_data:/app/data\-vdbcheck_reports:/app/reports\--namedbcheck\jackge12345/dbcheck:latest启动后访问http://localhost:5003默认账号角色账号 / 密码管理员admin / admin123只读viewer / viewer123运维operator / operator123也支持docker-compose与源码安装Python 3.10python web_ui.py另有 Windows / macOS 桌面客户端解压即用。三、核心亮点1. 数据库巡检344 规则一键体检覆盖 21 种数据库内置 344 巡检规则覆盖基本信息、会话连接、内存缓存、表空间、SGA/PGA、Redo、归档备份、安全审计、Top SQL、复制/Data Guard、RAC、锁与阻塞等多维度检查自动生成专业Word / PDF 报告。每条风险附带可执行修复 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-inSSH 安全宿主采集零侵入、无需预装 Python凭据 Fernet 加密REST APIAPI Key 认证接入 CI/CD容灾备份定时库/文件备份 保留策略与健康追踪四、支持数据库一览21数据库驱动默认端口说明MySQLpymysql33065.6 / 5.7 / 8.0MariaDBpymysql330610.3PostgreSQLpsycopg2543210Oracleoracledb152111g R2 / 12c / 19c / 21cOracle (JDBC)JPype1 ojdbc1521无需 Instant Client 的插件SQL Serverpyodbc ODBC 1714332012DM8达梦dmpython5236国产TiDBpymysql4000MySQL 协议IvorySQLpsycopg25333PG 兼容YashanDB崖山yashandb1688Oracle 兼容KingbaseES人大金仓psycopg254321PG 兼容GBase 8s南大通用JDBC9088JDK JDBCUXDB优炫JDBC33060PG 兼容HGDB瀚高JDBC5866PG 兼容MongoDBpymongo270174.0DB2 LUWJDBC5000011.5 / 12.xOceanBasepymysql2881MySQL 租户TDSQL-C MySQLpymysql3306云原生 MySQLRedisredis-py63793.0Redis Clusterredis-py6379拓扑与槽位ClickHouseJDBC812321.8五、实战体验本机接入 3 个 Oracle含 RAC 集群本机以 Docker 部署社区版 v26.9.29.0已接入 3 个 Oracle数据源数据源连接账号RAC-ORCLCDBRAC 双节点集群SCAN 接入172.16.1.230:1521/ORCLCDBC##DB_MONITORDB1-LOCALoracle-db:1521/FREEPDB1db_monitorDB2-LOCALoracle-db2:1521/FREEPDB1db_monitor首页「健康驾驶舱」按实例实时展示吞吐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.gitcdDBCheckpipinstall-rdeploy/requirements.txt python web_ui. py七、学习资源官网https://raccoonx.cn/ 产品亮点、功能全览、用户手册 PDF 下载GitHubhttps://github.com/fiyo/DBCheck README / README_zh、源码、Issues、DiscussionsDocker Hubhttps://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 给项目点个 ⭐Starhttps://github.com/fiyo/DBCheck