DBX 数据库管理工具完整指南：10 分钟连上数据库并导出第一张 CSV 表-育师

DBX 数据库管理工具完整指南：10 分钟连上数据库并导出第一张 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 等 100+ 数据库，提供桌面端与 Docker 两种形态。读完本文，你会在 10 分钟内完成 DBX Web 服务的部署，连上 MySQL，并导出第一份 CSV 表。

三问定路线：桌面端还是 Docker

动手之前，用 30 秒回答三个问题：

部署在哪？本机日常开发选桌面端；放服务器给团队访问选 Docker。
连什么库？MySQL、PostgreSQL、Redis、MongoDB 等是内置原生驱动，开箱即用；达梦、openGauss、Hive 走 JDBC，连接前需先在驱动商店安装。完整清单见 databases.cn.mdx。
有没有外网？没有外网要走离线驱动导入，排障部分会讲。

路线	适用场景	数据存哪
桌面端	本机开发、本地数据库文件	本机应用数据目录
Docker / Web	服务器自托管、团队浏览器访问	Docker 命名卷

本文以Docker 路线为主线走完整流程，桌面端压成一条旁注。

Docker 单命令拉起 DBX Web 服务

打开终端，一条命令启动服务：

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

这条命令做什么：后台运行官方镜像，映射 4224 端口，用dbx-data命名卷持久化数据，容器重启不丢连接。

生产环境务必加一个登录密码，别让服务裸奔：

docker run -d -e DBX_PASSWORD=your-password -p 4224:4224 -v dbx-data:/app/data t8y2/dbx:latest

DBX_PASSWORD设置的是 Web 登录密码；镜像还支持DBX_PORT、DBX_DATA_DIR、DBX_PUBLIC_BASE_PATH等参数，amd64 和 arm64 架构都提供镜像。完整参数表在快速开始文档。

习惯 Compose 管理容器的话，官方发布镜像配置在 deploy/docker-compose.release.yml，执行docker compose -f deploy/docker-compose.release.yml up -d即可。

👉 如果你选桌面路线：macOS 执行brew install --cask dbx，Windows 执行winget install t8y2.dbx，Linux 走 Flatpak，装完直接进入下一节。

最小闭环：连库、查数、导出第一份 CSV

🎯 目标很小：把一张orders表导出成 CSV 文件。

打开登录页。浏览器访问http://localhost:4224，出现登录页即容器已跑起来；输入密码进入主界面。打不开就执行docker logs dbx，通常是端口被占或镜像拉取失败。
新建连接。左侧点「新建连接」，选 MySQL，填主机、端口、账号密码。界面长这样：

测试并保存。点「测试」，通过后保存连接，左侧边栏随即出现数据库名。没出现说明测试没跑通，先回到上一步排查，别急着保存。
打开表。展开数据库，双击orders表，数据网格铺开数据，虚拟滚动让几万行也流畅。要服务端过滤，在工具栏 WHERE 条件里输入created_at > '2026-08-01'，这是在数据库侧真正减少返回量，不是客户端假筛选。

导出文件。点「导出」选 CSV。导出前先确认当前页、筛选条件与选择区域——「当前可见数据」不等于完整表，这是新手最容易踩的坑。TSV、JSON、XLSX 等全部格式说明见数据网格文档。

故障三行卡：超时、认证、驱动

连接超时症状：测试按钮长时间转圈后报超时。第一反应：主机、端口、防火墙、安全组逐项排查；内网库先确认隧道/代理是否已配置。深入排查：数据库在 Docker 宿主机上时，确认容器网络能路由到目标库。

认证失败症状：提示用户名或密码错误。第一反应：核对账号密码，确认该账号允许远程登录。深入排查：检查认证方式与 SSL 要求，先用本地账号验证以缩小范围。

提示驱动缺失症状：连接达梦、openGauss 等 JDBC 类数据库时提示缺驱动。第一反应：打开「设置 → 驱动」，在驱动商店一键安装。深入排查：无外网环境从别的机器下载匹配平台的离线驱动 ZIP，传输后选「导入离线包」，细节见驱动管理文档，驱动清单在 database-drivers.manifest.json。