25MB 搞定 100+ 数据库：DBX 数据库管理工具的安装、部署与 CSV 导出指南-育师

25MB 搞定 100+ 数据库：DBX 数据库管理工具的安装、部署与 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+ 数据库类型：原生驱动直连，达梦、openGauss、Hive 等走 Agent/JDBC 驱动，桌面端、Docker、CLI 三种形态开箱即用。本文带你依次完成三件事：在桌面端或容器端完成安装并启动、建立并测试第一个数据库连接、把查询结果导出为 CSV 交付。它适合刚接触 DBX 的新手，以及需要把服务自托管到服务器的团队。

跑完全文，你将得到一张按 WHERE 条件过滤后的数据网格，和一个可直接发给业务同事的 CSV 文件。

先定路线：装在本机还是装到服务器

对照下面 3 项判断，选一条路线执行即可，两条路线的操作差异只在部署方式，连接与导出流程完全一致。

你的情况	推荐路线	理由
日常开发在本机，常操作 SQLite、DuckDB 等本地文件库	桌面端	文件路径直接指向本机磁盘，无需挂载
服务部署在服务器，团队成员经浏览器访问	容器端	固定入口`http://localhost:4224`，数据落在持久化卷
内网或离线环境，无法访问外网	任一路线 + 离线驱动包	驱动商店支持「导入离线包」，见后文速查表

桌面路线：装、启、连三步完成

桌面端一条包管理命令即可完成安装，启动后认准主界面的「新建连接」按钮。

装：macOS 执行brew install --cask dbx；Windows 执行winget install t8y2.dbx（或经 Scoop 安装）；Linux 走 Flatpak，或取.deb/.rpm/.AppImage对应发行版的安装包。需要查阅文档与配置文件时，可拉取源码备用：

git clone https://gitcode.com/gh_mirrors/dbx7/dbx

启：Linux 上首次启动报缺库，原因是依赖 WebKitGTK 运行时，补齐后重启：

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

此时主界面出现「新建连接」按钮，即代表启动成功。失败时的第一反应：在终端直接运行 DBX 可执行文件，错误首行会指出具体缺失的.so，照名安装即可。

连：点「新建连接」，选 MySQL，填主机、端口、账号、密码，点「测试」。测试通过并保存后，左侧边栏出现该数据库，展开对象树能看到表清单，即代表连接成功。完整步骤见 docs/content/docs/getting-started.cn.mdx。

🐳 容器路线：DBX Docker 部署只需一条命令

容器端把镜像跑起来，浏览器访问 4224 端口即可，数据经命名卷持久化。

装并启：

docker run -d --pull=always --name dbx -p 4224:4224 -v dbx-data:/app/data t8y2/dbx:latest

浏览器访问http://localhost:4224，出现登录页即代表容器启动成功。生产环境务必追加登录密码：-e DBX_PASSWORD=your-password。镜像还接受DBX_DATA_DIR（默认/app/data）、DBX_PORT（默认4224）、DBX_PUBLIC_BASE_PATH（子路径部署，如/dbx）三个环境变量。失败时的第一反应：docker logs dbx看监听端口，再核对-p 4224:4224映射是否存在。

习惯 Compose 的，用仓库里已发布镜像版配置，它默认映射4224:4224并把数据写入dbx-data卷：

docker compose -f deploy/docker-compose.release.yml up -d

连：与桌面端一致——「新建连接」→ 填参 → 「测试」→ 保存，侧边栏出现表树即代表成功。

公共操作：用 WHERE 过滤，再把结果导出为 CSV

双击打开目标库，在对象树选中orders表，数据网格随之铺开：DBX 采用虚拟滚动，几千行也只渲染可视区域，翻页不卡顿。在工具栏展开 WHERE 条件，输入created_at > '2026-08-01'——这在数据库侧过滤，真实减少返回的数据量；客户端搜索则只是缩小显示，不改变拉取量，大表务必走数据库侧。

点导出按钮，选 CSV——DBX 同时支持 CSV / TSV / JSON / Markdown / XLSX / SQL 六种格式。导出前核对三个确认点：当前页、WHERE 筛选条件、选择区域。「当前可见数据」不等于完整表，这是新手导出漏数据的头号原因；需要全表时先清空筛选再导出。数据网格的完整能力见 docs/content/docs/data-grid.cn.mdx，补全、格式化、选中执行等编辑器玩法见 docs/content/docs/query-editor.cn.mdx。

问题速查：四个高频现象对照处理

遇到下面四种现象，按下表逐项处理即可，全部覆盖首次使用阶段的高频故障。

现象	可能原因	处理动作
连接超时	主机、端口、防火墙或安全组拦截；内网库未配置隧道；Docker 宿主机到目标库网络不通	逐项核对网络链路；内网库先配隧道/代理；验证部署机能否直连目标库
认证失败	账号密码错误、认证方式不匹配、要求 SSL、账号无远程登录权限	复核凭据；确认认证方式与 SSL 要求；让管理员放开该账号的远程访问
能连接但看不到表	默认数据库或 Schema 选错、权限不足、可见数据库过滤生效	检查连接设置中的默认库、Schema 与「可见数据库」过滤
提示驱动缺失	Agent/JDBC 驱动尚未安装	「设置 → 驱动」进驱动商店一键安装；离线环境从其他机器下载匹配平台的离线驱动 ZIP，在驱动商店选「导入离线包」