一封给社区老友的信

亲爱的 DBCheck 老朋友们：

今天，我们想认真地告诉你一件事——我们的名字变了。

过去的一段时间里，DBCheck 这个名字陪你走过无数个深夜。你或许在凌晨两点被告警吵醒，打开它巡检一套岌岌可危的 MySQL；或许在某个上线前夜，用它生成一份健康报告发给团队；也或许你只是个刚入行的新人，在这里第一次学着看懂慢日志和锁等待。

无论你是谁、在哪里、用过 DBCheck 多久，我们都想先说一声：谢谢。

谢谢你在还不完美的时候选择了相信，谢谢你在 GitHub 上留下的每一个 star、issue 和 PR，也谢谢你把这么重要的工作，交给我们来做。

现在，是时候换一种方式，继续陪你走下去了。

DBCheck，正式升级为 RaccoonX 浣巡。

数据库是业务系统的心脏，而巡检就是给心脏做"体检"。今天介绍一款开源免费的数据库智能巡检平台——浣巡（RaccoonX）。

它源自社区广受欢迎的开源项目 DBCheck，近期完成了品牌升级，正式更名为浣巡（RaccoonX）。名字取自小浣熊：机敏、爱探索，且多在夜间活动——恰好契合 DBA 们半夜被叫醒救火的真实日常。

浣巡面向 MySQL、PostgreSQL、Oracle、达梦 DM8、MongoDB 等主流与国产数据库，提供：

• Web 可视化巡检：打开浏览器即可发起巡检，自动生成结构化健康报告；
• AI 辅助：内置 AI 聊天与慢查询/SQL 诊断能力，帮你看懂"为什么慢"；
• RBAC 权限管理：团队多角色协作，权限可控；
• 插件化架构：可扩展的巡检引擎，按需加载数据源驱动。

社区版采用 Apache 2.0 开源协议，可自由使用与二次开发。

二、近期更新总览（自 v26.8.10.1 起）

从 v26.8.10.1 到当前的 v26.8.13.0 v26.8.14.0，浣巡跨越多个版本，围绕品牌、智能化、兼容性、巡检能力、工程化五个方向做了大量打磨。下面按模块逐一说明。

1. 品牌焕新：DBCheck → 浣巡（RaccoonX）

社区版展示层完成品牌升级，从 DBCheck 全面焕新为浣巡（RaccoonX），包含新的产品命名、Logo 与界面标识。品牌升级聚焦社区版展示层，专业版与其它外部资产（仓库、域名）暂保持现状，老用户迁移无负担。

2. 智能化能力跃升

这是本次更新含金量最高的一块。

• SQL 审核内置模块（MVP1 → MVP2）：新增解析、规则、评分与报告能力，可对照规范自动给出 SQL 质量评分与改进建议。默认只读不执行，安全无副作用；MVP2 进一步增强了规则覆盖与报告可读性。
• SQL 编辑器强制只读 + Redis 只读命令限制：从源头杜绝"在巡检平台误执行写操作"，SQL 编辑器只读、Redis 仅放行只读命令，运维更安心。
• 新增 MCP Server（stdio JSON-RPC 2.0）：开放标准化的模型上下文协议接口，可把浣巡的巡检/诊断能力接入各类 AI 工具与 Agent，让数据库知识真正"可被调用"。详见：DBCheck v26.8.10.1：让 AI 直接帮你巡检数据库
• 根治卡死（重大稳定性修复）：以往 JDBC 连接测试、智能诊断、定时巡检在 gevent + 进程内 JVM 环境下会偶发卡死。本次通过子进程隔离将重负载操作移到独立、非 gevent 的 Python 子进程执行，从根上消除死锁；同时修复了历史趋势实例列表与 bcrypt 跨版本兼容问题。

3. 数据库兼容性全面加固

针对社区反馈的多个兼容性误报与报错，做了系统性修复：

• MariaDB 10.3 语法修复（GitHub Issue #46）：修正 master_status
   等语法，老版本 MariaDB 巡检不再报错。
• MariaDB 巡检报告误报修复（GitHub Issue #48）：
• 修正"本机 C 盘空间告警取值来源有误"——未勾选查询服务器时不采集本机磁盘，避免张冠李戴；
• 修正"数据库用户密码告警为误报"——列名错配导致空密码误报，已校正；
• global_priv
   列缺失误报（1054）：旧逻辑靠版本号默认 10.4 误判，改为运行时探测 mysql.user.global_priv
   列是否真实存在，无该列的实例自动回退，不再报错；
• wsrep
   基线误报：独立（非 Galera）MariaDB 的 wsrep_cluster_address
   永远为空却被标成风险，现仅当 wsrep_on=ON
   时才检查。
• SQL Server JDBC 双开关 + TLS/encrypt 兼容修复：连接开关更灵活，并修复 encrypt
  /TLS 协商在部分环境下的连接失败。
• Oracle 深采报错修复：修正 Oracle 深度采集 DEFAULT_MODE
   相关报错，深采更稳定。

4. 巡检能力增强

• 真现实 eBPF 内核级指标：巡检向导开启 SSH 开关。当目标机具备 Python3 + bcc + root 时，可采集磁盘 p99 时延 IOPS 按进程 Top 归因等内核级指标；不具备环境时安全降级，基础宿主指标不受影响。
• DM8 离线坏块检测增强：国产达梦数据库的离线坏块检测能力加强。
• 定时巡检多项修复：自定义 cron 保存失败已修复；小时下拉框补齐 0–23 点；巡检并发改为串行化、周期类型更丰富；新增 --async-mode
   启动开关，便于在受限环境下调整异步策略。
• 历史趋势实例列表修复：修复历史趋势页实例列表为空的问题。

5. 部署与工程化

• Docker 构建优化：将 Oracle instant client（linux_x64）纳入 Git LFS 管理，Docker 构建剔除 windows_x64，镜像更轻、拉取更快。
• 容器迁移挂载点设备繁忙修复（GitHub Issue #49）：容器环境下 /app/reports
   作为卷挂载点，旧迁移脚本强行删除会报"Device or resource busy"并每次启动刷屏。现已检测挂载点、仅合并内容不删除挂载点，并正常记录迁移完成态，不再重试刷屏。
• 发版说明 docker run 卷路径修正：发版文档里的 docker run
   报告卷挂载由 dbcheck_reports:/app/reports
   修正为正确的 dbcheck_reports:/app/data/reports
  ，与报告真实落盘路径一致。
• release.ps1 代理自动回退：发版脚本在代理不可用时自动回退直连 SSH，避免卡在代理。
• 工程合规：为缺失文件补充 Apache-2.0 license header，并修复 bcrypt 跨版本兼容。

三、一起走吧

从 DBCheck 到 RaccoonX 浣巡，不只是换一个名字，更像是一次郑重的承诺。

我们承诺，会继续做那个在深夜里替你盯着数据库的伙伴。 我们承诺，会越来越懂你的场景、你的痛点、你的凌晨三点。 我们承诺，不管名字怎么变，对社区、对开源、对每一位用户的初心，都不会变。

如果你也是那个经常半夜被叫醒的人， 如果你也相信数据库巡检可以不那么痛苦， 如果你愿意给一只小浣熊一个机会，让它陪你一起走夜路——

欢迎认识 RaccoonX 浣巡。

未来很长，让我们一起，把每一个深夜的告警，都变成一次从容的探索。

DBCheck 已至，浣巡初来。感谢相遇，不负陪伴。

# 方式一：Docker Hub 镜像：
docker pull jackge12345/dbcheck:latest
docker run -d -p 5003:5003 \
  -v dbcheck_data:/app/data \
  -v dbcheck_reports:/app/reports \
  jackge12345/dbcheck:latest
  


# 方式二：GitHub Container Registry 镜像：
docker pull ghcr.io/fiyo/dbcheck:latest
docker run -d -p 5003:5003 \
  -v dbcheck_data:/app/data \
  -v dbcheck_reports:/app/reports \
  ghcr.io/fiyo/dbcheck:latest
  
# 方式三：源码启动
git clone https://github.com/fiyo/DBCheck.git
cd DBCheck
#安装依赖（注：部分数据库驱动为商业驱动需自行手动下载安装）
pip install -r requirements.txt
python web_ui.py

作者也是一名 红十字救护员。代码能守护数据，急救能守护生命。
本文末尾，用一分钟了解 心肺复苏（CPR） 和 AED 的正确用法——关键时刻，你可能是别人活下去的全部希望。

⏱️ 黄金四分钟

心脏骤停后，4分钟内 开始心肺复苏，存活率可提高 2-3倍。每延迟1分钟，存活率下降7%-10%。

👐 心肺复苏（成人）简明步骤

1. 判断环境安全：确保施救者和患者远离危险（马路、火灾、漏电等）。

2. 拍打双肩，大声呼喊：判断有无意识、呼吸。

3. 呼叫急救：指定人打120，取AED。

4. 胸外按压：

• 位置：两乳头连线中点（胸骨下半段）

• 深度：5-6厘米

• 频率：100-120次/分钟

• 按压间隙让胸廓充分回弹

5. 开放气道（仰头抬颏法）+ 人工呼吸（非必学，但推荐）：30次按压后2次吹气，每次吹气1秒，见胸廓隆起。

⚡ AED（自动体外除颤器）使用口诀

“开机、贴片、听指令”

1. 打开AED电源（部分机型开盖即开机）

2. 按图示贴电极片：右锁骨下（胸骨右缘）、左腋前线（乳头外侧）

3. AED自动分析心律：任何人不得触碰患者（喊“离开”）

4. 若建议除颤：确认无人接触患者，按下电击按钮

5. 电击后立即继续心肺复苏，直至AED再次分析或患者恢复意识

📱 如何找到附近的AED？

• 微信/支付宝搜索 “AED地图”

• 许多城市地铁站、机场、体育场、大型商场均配备

人人学急救，急救为人人。
愿每一行代码都有用，每一次心跳都能继续。

🌟 公益一角 · 写给所有孤独症儿童

他们不聋，却对身边的声音充耳不闻； 

他们不盲，却对周围的风景视而不见； 

他们不哑，却总是一个人沉默不语。

他们有一个浪漫却让人心疼的名字——「星星的孩子」。

孤独症（自闭症）不是疾病，而是一种神经系统发育差异。全球每 160 名儿童中就有 1 名孤独症患者。他们就在我们身边，在普通学校里、在公园里、在每一个看似平凡的日子里。

💙 他们需要的，其实很简单

• 理解
  上课时突然离座、玩耍时不懂轮候，请多一点耐心
• 接纳
  他们不是"没教养"，只是用不同的方式感知世界
• 支持
  早期诊断、科学干预，可以改变一个人的人生轨迹

🌟 我们能做什么？

每一个孩子，都值得被世界温柔以待。

如果你身边有孤独症儿童家庭，请给他们多一些理解和支持。

你的一点善意，可能就是他们世界里的一束光。

DBCheck v26.8.2.1：目录调整+功能更新与 Bug 修复