开源多数据库管理工具 DBX 完整技术实操教程

一、工具基础介绍

在后端开发、运维工作中，业务常会同时使用多种数据库，切换不同客户端会增加操作成本。DBX 是一款基于 Rust+Tauri 2+Vue 3 开发的跨平台开源数据库统一管理客户端，可一站式对接数十类数据库，降低多库运维操作成本。

1. 项目基础信息

开源协议：MIT/AGPL-3.0 双协议，个人、商业场景均可免费使用，无功能阉割；
程序体积与资源：安装包仅约 15MB，依托系统原生 WebView 运行，区别于 Electron 程序，常规运行内存约 80MB，硬件占用更低；
支持运行环境：Windows、macOS（Intel/Apple Silicon）、Linux 桌面端，额外提供 Web 网页端、Docker 容器部署方案；
兼容数据库：MySQL、MariaDB、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server、Oracle、TiDB、达梦、高斯、TDSQL、OceanBase 等数十种主流 / 国产数据库，项目持续迭代新增适配类型。

二、主流数据库客户端硬件资源对比

下表为 DBX 与市面常用数据库客户端安装包体积、内存占用客观对比：

表格

工具名称	授权模式	安装包大小	常规运行内存占用
DBX	开源全免费	~15MB	~80MB
DataGrip	商业订阅付费	800MB+	1GB+
DBeaver	免费社区版 / 商业专业版	400MB+	500MB+
Navicat	商业付费	200MB+	300MB+

补充特性：DBX 采用虚拟滚动渲染数据表，面对十万级大表分页浏览时滚动操作流畅无卡顿。

三、全平台完整安装部署教程

3.1 安装资源获取

百度网盘下载地址保存： https://pan.baidu.com/s/1u53o4CMee0TcvrU9IscdVw?pwd=5555 提取码: 5555

3.2 Windows 系统三种安装方式

方式 1：Winget 官方包管理器（Win10/Win11 推荐）

打开 PowerShell 终端，执行一键安装命令：

plaintext

复制代码

winget install t8y2.DBX

方式 2：Scoop 包管理器

提前部署 Scoop 环境后执行对应安装指令，缺失依赖可通过网盘下载包补充。

方式 3：离线安装包

下载.exe安装程序，双击启动安装向导，自定义无中文路径完成安装，安装后直接启动程序。

3.3 macOS 系统安装步骤

方式 1：Homebrew 命令行（推荐）

plaintext

复制代码

brew install --cask t8y2/tap/dbx

方式 2：离线 DMG 镜像

根据设备芯片选择安装包：M 系列 Apple Silicon 选 arm64 版本，Intel 处理器选 x86_64；
打开 dmg 镜像，将 DBX.app 拖拽至 Applications 应用目录；
系统拦截解决方案（未公证软件安全限制）方案 A（终端命令）：

plaintext

复制代码

xattr -cr /Applications/dbx.app

执行后双击程序即可打开；方案 B（图形界面）：系统设置→隐私与安全性，页面下方点击「仍要打开」放行软件。

3.4 Linux 桌面端安装

3.4.1 Ubuntu/Debian deb 包

先安装运行依赖库：

plaintext

复制代码

sudo apt-get install -y libwebkit2gtk-4.1-dev libgtk-3-dev libappindicator3-dev librsvg2-dev patchelf libssl-dev

下载 deb 包后执行安装：

plaintext

复制代码

sudo dpkg -i dbx_x.x.x_amd64.deb

3.4.2 通用 AppImage（全发行版兼容）

plaintext

复制代码

# 赋予程序可执行权限
chmod +x dbx_x.x.x_amd64.AppImage
# 启动程序
./dbx_x.x.x_amd64.AppImage

3.5 Docker Web 端部署（服务端多人使用）

镜像支持 amd64、arm64 双服务器架构，两种部署方案：

方案 1：单行 Docker run 部署

plaintext

复制代码

docker run -d --name dbx -p 4224:4224 -v dbx-data:/app/data t8y2/dbx

部署完成后浏览器访问http://localhost:4224进入 Web 管理界面。

方案 2：docker-compose 标准化部署

新建docker-compose.yml配置文件：

yaml

复制代码

services:
  dbx:
    image: t8y2/dbx
    ports:
      - "4224:4224"
    volumes:
      - dbx-data:/app
    restart: unless-stopped
volumes:
  dbx-data:

启动命令：

plaintext

复制代码

docker compose up -d

3.6 源码手动编译安装

适用具备 Rust、Node 开发环境的自定义需求用户，前置依赖：Node.js 18+、pnpm、Rust 1.77+ 完整编译流程：

plaintext

复制代码

# 拉取项目源码
git clone https://github.com/t8y2/dbx.git
cd dbx
# 前端依赖安装
pnpm install
# 编译桌面端安装包
pnpm tauri build

编译产出文件存放路径：src-tauri/target/release/bundle/

四、数据库连接通用配置流程（以 MySQL 为例）

其余数据库配置逻辑与 MySQL 基本一致，操作步骤通用：

启动 DBX，点击左侧面板「+」新建连接；
在数据库选择界面检索并选中目标库类型（MySQL），点击下一步；
基础连接参数填写规范

连接名称：自定义标识，区分开发 / 测试 / 生产环境；
主机地址：本地库填 127.0.0.1，远程库填写内网 / 公网 IP；
端口：MySQL 默认 3306，自定义端口填写对应数值；
登录用户名、数据库登录密码；
数据库名：选填，可连接后再切换库；

内网跳板机 SSH 隧道配置（可选）切换至「SSH 隧道」标签，填写跳板机地址、端口、账号，支持密码 / 私钥两种认证方式，填写完成后点击测试连接；
连接管理拓展功能

支持加密导出 / 导入全部连接配置，更换设备无需重复录入参数；
可给不同环境连接自定义区分颜色，降低线上误操作风险。

五、软件核心功能技术详解

5.1 SQL 查询编辑器

编辑器基于 CodeMirror 6 内核开发，适配各类数据库 SQL 语法：

语法支持：全库关键词高亮、表 / 字段实时自动联想补全；
执行快捷键：Windows Ctrl+Enter、macOS Cmd+Enter；选中片段仅执行选中 SQL；
辅助工具：一键 SQL 格式化、持久化历史查询记录、历史语句检索、内置通用 SQL 模板（增删改查、条件函数等）；
安全机制：DROP、TRUNCATE、ALTER、DELETE 等高危语句执行前弹出二次确认弹窗。

5.2 AI 辅助 SQL 模块

内置大模型对接入口，兼容 OpenAI、Claude 两类 API 服务：

配置方式：软件设置面板填入对应平台 API Key，DBX 仅提供调用通道，接口费用由服务商收取；
使用场景：自然语言描述需求自动生成 SQL；粘贴现有语句做逻辑解读、执行性能优化。

5.3 数据表可视化操作

行内编辑：查询结果表格直接修改单元格，保存同步至数据库；
浏览优化：拖拽调整列宽、单列升降序、分页、行号、斑马纹视图；
导出能力：结果集支持 CSV、JSON、Markdown 三种格式导出。

5.4 Schema 库结构浏览器

左侧侧边栏统一展示库、Schema、数据表、字段、索引、外键、触发器；支持全局检索表名，常用数据表可置顶固定。

5.5 非关系型数据库专属面板

Redis：可视化键管理，支持user:*通配批量检索，兼容 String/Hash/List/Set/ZSet/Stream 全类型数据编辑；
MongoDB：文档分页浏览，兼容标准 URL、Atlas 云库、副本集多种连接格式。

5.6 本地文件快速查询

依托内置 DuckDB 引擎，直接拖拽 Parquet、CSV、JSON 本地文件至软件，无需入库即可预览、执行查询。

5.7 MCP Server 集成能力

内置 MCP 服务，Cursor、Claude Code 等 AI 编程工具可直接复用 DBX 内已配置的数据库连接，无需重复录入账号密码。

六、与主流数据库客户端差异化对比

对比 DBeaver DBeaver 基于 Java+JVM，启动慢、内存占用高；DBX 轻量启动更快。DBeaver 优势在于完善 ER 图、批量数据迁移；DBX 更适合日常简单查询、多库快速切换。
对比 Navicat Navicat 商业付费，内置定时备份、数据同步调度成熟运维功能；DBX 开源免费，满足基础查询、表结构管理，无付费门槛。
对比 DataGrip DataGrip 为订阅制专业工具，SQL 解析、执行计划分析能力更强；DBX 轻量化，适合日常开发、轻度运维场景。
对比 TablePlus TablePlus 免费版限制标签、连接数量；DBX 无任何功能限制，额外提供 AI SQL 辅助功能。

七、软件使用注意事项

AI 功能需用户自行申请并填写第三方平台 API 密钥，软件不代理大模型接口；
数据表行内编辑会直接提交变更，建议通过连接颜色区分生产环境，避免误删数据；
macOS 首次拦截为系统安全机制，按教程终端 / 图形方式放行即可；
软件默认开启版本自动检测更新，可在设置面板手动关闭；
项目持续迭代，功能缺陷可前往 GitHub 仓库 Issues 板块反馈。

八、适用场景总结

同时维护 MySQL、Redis、MongoDB 等多类数据库的后端开发、运维人员；
个人开发者、小型团队，选择免费无限制数据库管理工具；
服务器部署 Web 端，内网团队共用一套数据库管理界面。