☰
DBX 数据库管理工具上手教程:25MB 支持 100+ 数据库,连库查数到导出 CSV 报表
2026/11/5 3:21:13 网站建设 项目流程

DBX 数据库管理工具上手教程:25MB 支持 100+ 数据库,连库查数到导出 CSV 报表

【免费下载链接】dbx25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 100+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP。项目地址: https://gitcode.com/GitHub_Trending/dbx7/dbx

DBX 是一个 25MB 的轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、Redis、MongoDB、DuckDB、达梦等 100+ 数据库和服务,桌面端、Docker、CLI 三种形态开箱即用。这篇教程带你走完一条真实链路:装好、建连接、查数,最后导出一份 CSV 报表交给对账方。

动手前先对号入座:桌面端还是 Docker 部署

花 30 秒回答三个问题:

  • 目标机器:库在本机还是服务器上?本机走桌面端,服务器走 Docker。
  • 目标数据库:MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、SQL Server 是内置 Rust 驱动,装上就能连;达梦(DM)、openGauss、Hive 这类走 JDBC Agent,首次连接时在驱动商店一键安装。
  • 网络条件:能上外网走在线安装;内网或离线环境,要提前在别的机器下载对应平台的离线驱动 ZIP 包。
对比维度桌面端Docker / Web
适用场景本机日常开发、本地数据库文件服务器自托管、团队远程访问
数据存哪本机应用数据目录,如 Linux 下~/.local/share/com.dbx.app/dbx.dbDocker 卷,如dbx-data:/app/data
连接入口桌面窗口,支持本地 SQL 文件树浏览器http://localhost:4224

两条路线只选一条。关键差异:桌面端文件路径属于本机,Docker 里的文件路径属于服务器,你选定的路线决定后面每一步在哪台机器上操作。

最快安装步骤:三种系统各一条命令

本节以桌面端为例,按系统三选一:

# 按你的系统选一条命令安装桌面版 brew install --cask dbx # macOS scoop install dbx # Windows flatpak install flatpark com.dbxio.dbx # Linux

Linux 首次启动如果提示缺少 WebKitGTK 之类的系统库,按报错装上对应的 WebKitGTK 开发依赖再重启即可。如果你在上一步选了 Docker 路线,安装就只剩一行:

# 拉取官方镜像,映射 4224 端口并挂载数据卷 docker run -d --name dbx -p 4224:4224 -v dbx-data:/app/data t8y2/dbx:latest

生产环境记得追加-e DBX_PASSWORD=your-password设置 Web 登录密码,别裸奔。

第一个连接:新建连接并测试 MySQL

桌面端启动后,点侧边栏的新建连接,类型下拉框里选MySQL。这个下拉框按「主流 / MySQL 兼容 / PostgreSQL 兼容」分组,列出了 MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、SQL Server、Oracle、TiDB、OceanBase、openGauss、KingbaseES 等上百种类型。填好主机、端口3306、用户名、密码和默认数据库,点测试。

测试通过就保存,左侧边栏会出现带绿色状态点的连接条目——这就是你跑通的第一格。如果你手上已经有连接 URL,直接粘贴也行,DBX 会自动解析出主机、端口、账号等字段,保存前检查一遍解析结果再点测试。

实战任务:交付一份「11 月支付记录」CSV 对账报表

🎯 设定一个具体目标:对账方要payments表里 2026 年 11 月 1 日之后全部支付记录,格式要 CSV,下班前交付。全程四步。

第一步:打开 payments 表,看见真实数据

在对象树里双击payments表。数据网格用虚拟滚动,只渲染当前可视区域,几万行的表翻页也不卡。

第二步:用 WHERE 在数据库侧过滤,而不是客户端搜

点工具栏的WHERE输入框,填入created_at >= '2026-11-01'。为什么不用表格上方的搜索框?因为客户端搜索和本地值过滤只作用于「已加载的数据」,不会减少数据库实际返回的量;只有WHERE和ORDER BY在数据库侧执行、能走索引。这是新手第一个坑:在客户端筛选后看到行数变少了,就以为查询变轻了,其实整张表还是全量拉回来的。

第三步:确认导出范围再点导出

导出按钮点下去之前,核对三件事:当前页、WHERE 条件、是否选中了区域。要整个查询结果就别先选中区域;只要部分行就先选中行或矩形区域。第二个坑:「当前可见数据」不等于完整表,筛选后的导出行数自然小于表总行数,别把这两个数字混起来对账。

第四步:选格式交付

DBX 支持 CSV / TSV / JSON / Markdown / XLSX / SQL 六种导出格式,对账场景选CSV最稳。如果对方用 Excel,选 XLSX 也可以,超过单工作表行数上限时会自动拆分工作表。需要把整库都导走的话,在左侧树右键数据库节点选「导出数据库」即可,不用切到网格。

速查表:五个高频报错的排查方向

  • 连接超时→ 依次检查主机、端口、防火墙、安全组 → 内网库确认 SSH 隧道或代理已配置;Docker 部署先确认容器网络能通到目标数据库。
  • 认证失败→ 检查用户名、密码、认证方式与 SSL 要求 → 再确认该账号是否被允许远程登录。
  • 能连接但看不到表→ 多半是默认数据库、Schema 或权限问题 → 去连接的「可见数据库」过滤里看一眼,或换有权限的账号。
  • 提示驱动缺失→ 打开驱动管理,在驱动商店一键安装 → 离线内网从别的机器下载匹配平台的驱动 ZIP,选「导入离线包」。
  • 导出数量和预期对不上→ 核对当前页、客户端过滤、选择区域 → 改用数据库侧WHERE收紧范围,或明确要导的是查询结果还是选中区域。

25MB 装下 100+ 数据库的统一入口

DBX 的价值在于:一个 25MB 的安装包顶替多个臃肿客户端,100+ 数据库一个入口管理,还内置 AI 助手、MCP Server 和 CLI,桌面、服务器、终端三种场景都能覆盖。想继续深入,看这几份文档:

  • 安装与建连全流程:快速开始文档
  • 数据网格筛选、编辑与导出细节:数据表格文档
  • 驱动商店、JRE 与离线包导入:驱动管理文档
  • 已发布镜像的 Compose 配置:deploy/docker-compose.release.yml

如果你在装或导的过程中遇到上面没覆盖的报错,欢迎在评论区留下你的操作系统和数据库类型,我们一起把这张速查表补全。

【免费下载链接】dbx25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 100+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP。项目地址: https://gitcode.com/GitHub_Trending/dbx7/dbx

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询