跟着做完约 10 分钟，你用 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 的开发者。DBX 是一个约 25 MB 的跨平台数据库客户端，一个入口管理 MySQL、PostgreSQL、Redis 等 100+ 数据库，提供桌面端、Docker 与 CLI 三种形态。跟完下面的步骤，你会拿到一份从真实表导出的 CSV 文件，外加一套可复用的建连、查数、导出流程。
路线图：
- 回答 3 个问题，定部署路线（30 秒）
- 安装桌面端并完成首次建连（约 5 分钟）
- 打开真实表，过滤后导出 CSV（约 3 分钟）
- 服务器场景改走 Docker 路线（约 2 分钟）
- 出问题对照速查表（随时）
动手前：先回答 3 个问题
它要装在哪台机器？本机日常开发选桌面端；数据库在服务器上、希望用浏览器远程访问，选 Docker / Web。
你要连什么数据库？MySQL、PostgreSQL、SQLite、Redis、MongoDB 这类走内置原生驱动，开箱即用；达梦、openGauss、Hive 这类走 JDBC Agent，连接前在驱动商店一键安装。
机器能不能访问外网？能，驱动直接在线安装；不能（气隙内网），从另一台机器下载匹配平台的离线驱动 ZIP，在驱动商店里选「导入离线包」。
| 场景 | 路线 |
|---|---|
| 本机开发、本地数据库文件 | 桌面端 |
| 服务器自托管、浏览器远程访问 | Docker / Web |
桌面端安装与首次建连（主线 1~3 步）
第 1 步：安装桌面端。各系统各一条命令：
# macOS：用 Homebrew 直接装发布版 brew install --cask dbx # Windows：用 winget 安装 winget install t8y2.dbx # Linux：从 Releases 下载对应 .deb / .rpm / .AppImage 安装 # 首次启动报缺库时，补齐桌面端依赖（WebKitGTK 等） sudo apt-get install -y libwebkit2gtk-4.1-dev libgtk-3-dev libappindicator3-dev librsvg2-dev patchelf libssl-dev # 想同时保留源码以便查阅文档与配置时，再拉一份源码 git clone https://gitcode.com/GitHub_Trending/dbx7/dbx你会看到：主窗口打开，侧边栏和工具栏上有「新建连接」入口。 怎么算成功：应用图标正常出现在系统托盘/Dock，窗口能打开且不再报缺库错误。
第 2 步：新建连接并测试。点「新建连接」，在类型下拉里选 MySQL，依次填主机、端口（默认 3306）、用户名、密码和默认数据库；手头有连接字符串的话可以直接粘贴 URL，DBX 会解析出各字段，保存前核对一遍。
点「测试」验证账号、网络与权限。 怎么算成功：测试通过，不出现红色报错。如果目标库是达梦、openGauss 这类 JDBC 类型而提示驱动缺失，去 设置 → 驱动 一键安装即可。
第 3 步：保存连接，打开目标表。测试通过后保存，左侧边栏展开「数据库 → 表」，双击orders。 你会看到：数据网格铺开，表头上方有 WHERE、ORDER BY 输入框。 怎么算成功：表格渲染出数据行，底部分页信息正常显示。
查出一张真实表并导出 CSV（主线 4~6 步）
第 4 步：用 WHERE 收窄数据。在 WHERE 框输入created_at > '2026-08-01'并执行。 为什么用 WHERE：它在数据库侧执行，真正减少返回的数据量；表格搜索和本地过滤只作用于已加载结果，不省传输成本。 怎么算成功：底部总行数变小，且每一行都满足该条件。
第 5 步：导出 CSV。导出前先确认三件事：当前页、筛选条件、选择区域——「当前可见数据」不等于整张表，这是新手最容易踩的坑。确认后打开导出菜单选 CSV，DBX 也支持 TSV、JSON、Markdown、XLSX、SQL 等格式。
怎么算成功：本机生成一个 CSV 文件，用文本编辑器打开，行数与结果页一致，表头和字段顺序与网格一致。
第 6 步（按需）：处理驱动问题。主线连的是内置驱动覆盖的库就不需要这步。连 JDBC 库时若 Agent 起不来，先在 设置 → 驱动 里确认驱动和 JRE 已安装；离线环境走「导入离线包」。详见 驱动管理文档，驱动清单在 crates/dbx-core/assets/database-drivers.manifest.json。
备选路线：Docker 服务器部署
如果你的库在服务器上、希望团队通过浏览器访问，把 DBX 搬进容器即可，连接与导出操作沿用第 2 节步骤 2~5：
# 后台启动官方镜像，映射 4224 端口，命名卷持久化连接与元数据 docker run -d --pull=always --name dbx -p 4224:4224 -v dbx-data:/app/data t8y2/dbx:latest关键配置两个就够：
-e DBX_PASSWORD=your-password：设置 Web 登录密码，生产环境强烈建议加；- 其余按需调整：
DBX_PORT（默认 4224）、DBX_DATA_DIR（默认 /app/data）、DBX_PUBLIC_BASE_PATH（子路径部署，如/dbx）。
习惯 Compose 的话直接用官方发布配置：
# 用发布镜像的 Compose 文件启动，数据持久化到 dbx-data 卷 docker compose -f deploy/docker-compose.release.yml up -d对应文件见 deploy/docker-compose.release.yml。 验证方式：浏览器打开http://localhost:4224，看到登录页即容器正常。注意 Web 版的文件路径归属服务器，本地机器上的 SQLite 文件要先挂载进容器才能打开。
高频问题速查表
| 现象 | 处理 |
|---|---|
| 连接超时 | 多是主机、端口、防火墙、安全组未放行，或 Docker 宿主机到不了目标库。逐项排查；内网库先确认隧道/代理是否配置。 |
| 认证失败 | 用户名密码、认证方式或 SSL 要求不匹配，也可能账号未允许远程登录。核对账号配置，并在数据库侧确认该账号可远程登录。 |
| 能连接但看不到表 | 默认数据库/Schema 不对，或账号缺元数据读取权限，也可能开了「可见数据库」过滤。切换默认数据库并检查可见过滤设置。 |
| 提示驱动缺失或下载失败 | JDBC 类驱动需从驱动商店安装，离线机器下载会失败。在 设置 → 驱动 一键安装；内网环境从别的机器下载匹配平台的 ZIP 后「导入离线包」。 |
| 文件型数据库（SQLite）打不开 | 路径错、文件无权限，或 Docker 环境文件未挂载进容器。确认文件实际在哪台机器上，Web 版先把目录挂载进容器。 |
| 导出行数与预期不符 | 导出的是当前页、选择区域或客户端过滤后的结果，不是整表。导出前重看当前页、WHERE 条件和选择范围。 |
DBX 用一个小体积客户端统一了 100+ 数据库的建连、查数与导出，桌面、Docker、CLI 场景都能覆盖。想继续深入，可以看 数据表格文档 和 快速开始文档。你部署中遇到的报错或机型问题，欢迎留言补充，一起把这份速查表做厚。
【免费下载链接】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），仅供参考