10 分钟跑通 DBX：从装好到导出第一张 CSV 表
项目地址: https://gitcode.com/GitHub_Trending/dbx7/dbx 读完这篇文章，你已经在本地或服务器上跑起了 DBX，并导出了第一张 CSV 表。DBX 是一个 25MB 的轻量跨平台数据库客户端，覆盖 100+ 数据库：MySQL、PostgreSQL、Redis、MongoDB、达梦都在内置列表里，AI 助手、MCP Server 和 CLI 也一并自带，桌面、Docker、Web 三种形态任选。
先回答你最容易卡住的三个问题
Q： DBX 对环境有什么要求？
A：没有硬性门槛。桌面端安装包约 25MB，macOS、Windows、Linux 都有现成安装渠道；Docker 路线只需要一台能跑容器、开放 4224 端口的机器，装 JDBC 驱动时再按需准备 Java 即可。
Q： 支持哪些数据库？
A：100+ 种。MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、SQL Server 走内置原生驱动；达梦、openGauss、Hive 等走 Agent/JDBC 驱动商店，连接前一键安装，完整清单在数据库支持页都能查到。
Q： 内网或离线环境能用吗？
A：能。驱动商店支持导入离线驱动 ZIP，装不了驱动也能连；Web 版是纯服务端形态，浏览器访问即可，不要求目标数据库和它同机部署。离线导入流程见 驱动管理文档。
最短路径——本地装好 DBX 并三步导出第一张 CSV 表
以 MySQL 为例，其他类型同样适用。
装到能打开
macOS 执行 brew install --cask dbx，Windows 用 winget install t8y2.dbx 或 Scoop，Linux 走 Flatpak 或下载对应 .deb / .rpm / .AppImage 安装包。装完打开窗口，第一眼看到的就是「新建连接」。Linux 上如果首次启动报缺库，是少了 WebKitGTK 系统依赖，用包管理器补上系统库后重启应用即可。
填对连接配置
点「新建连接」：名称、类型（选 MySQL）、主机、端口、用户名、密码、默认库，逐项填完点「测试」，通过就保存，侧边栏立刻挂出你的库。有现成连接 URL 可以直接粘贴，DBX 会自动解析成各字段；SQLite、DuckDB 这类文件型数据库不填主机端口，直接选本地数据库文件。内网或跳板机后面的库，先在 SSH 隧道/代理栏配好再测。
把数据导出去
双击目标库，在对象树点开目标表，数据网格铺开。工具栏「WHERE」里写 created_at > '2026-08-01'，过滤发生在数据库侧，返回的数据量真的变小了，不是客户端假筛选。网格用虚拟滚动，几千行的表也只渲染可视区域，翻页不卡。确认筛选条件和选中区域后点导出，CSV / TSV / JSON / XLSX / SQL 任选，业务要 CSV 就选 CSV。
换条路走——Docker 部署 DBX 到服务器
适合库在服务器、要远程访问或团队共用，两条命令内跑完：
# 启动 DBX Web 服务，映射 4224 端口，数据落命名卷
docker run -d --pull=always --name dbx -p 4224:4224 -v dbx-data:/app/data t8y2/dbx:latest
访问 http://localhost:4224 就能登录。想用 Compose 管理，仓库里已备好已发布镜像的配置 deploy/docker-compose.release.yml：
# 已发布镜像的 Compose 配置（含备份卷与重启策略）
docker compose -f deploy/docker-compose.release.yml up -d
镜像同时提供 amd64 / arm64，ARM 服务器直接可用。桌面端管本机文件和日常开发，Docker 管服务器和远程协作，两边数据流一致，按部署位置选就行。
装完 ≠ 会用——DBX 生产部署必配的两个环境变量开关
DBX_PASSWORD：默认没设密码，生产网段里 Web 版等于裸奔。Docker 启动加 -e DBX_PASSWORD=你的密码，浏览器端立刻要求登录。改完环境变量重启容器再刷新页面。
DBX_PUBLIC_BASE_PATH：DBX 挂在网关子路径（比如 /dbx）后面时，默认根路径会 404。设成对应子路径，重启容器生效，前端资源和 API 会按这个前缀走。
出了问题先查这里
连接超时 → 主机、端口、防火墙、安全组任一不通 → 内网库先确认隧道或代理是否配置，Docker 机器还要能访问目标库。
认证失败 → 密码错误、认证方式不匹配或账号不允许远程登录 → 核对账号密码与 SSL 要求，换权限够的账号再试。
能连接但看不到表 → 默认库、Schema 选错或账号无权限 → 检查连接的默认数据库和可见范围设置。
提示驱动缺失 → 该类型走 JDBC 驱动商店，还没安装 → 在「设置 → 驱动」里一键安装；离线环境导入匹配的驱动 ZIP。
从装好到导出第一张 CSV，就是装、连、导这三步。卡在哪一步，评论区贴系统版本和报错原文。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
