轻量级跨平台数据库客户端DBX

发表于 分类于 Waline： 阅读次数： 本文字数： 2.7k 阅读时长 ≈ 2 分钟
DBX 是一个 15MB 的轻量级跨平台数据库客户端，支持 40+ 种数据库，内置 AI SQL 助手。

简介

什么是 DBX ？

DBX 是一个开源的轻量级跨平台数据库客户端。它仅需 15MB，无需 Java、Python 等运行时依赖，即可管理 40+ 种数据库，支持桌面端、Docker 自托管和 Web 版本。

主要特点

  • 极致轻量：整个应用仅 15MB，无需 Java JRE、Python venv 或捆绑 Chromium，下载即用
  • 40+ 数据库支持：MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server、Oracle、Elasticsearch 等主流数据库一网打尽
  • AI SQL 助手：用自然语言描述需求，自动生成 SQL。支持 Claude、OpenAI、Ollama 等模型，内置安全检查机制
  • MCP 协议集成：支持 Model Context Protocol，Claude Code、Cursor、Windsurf 等 AI 编码工具可通过已有连接查询数据库
  • 多平台部署：桌面端（macOS/Windows/Linux）、Docker 自托管、Web 版本，功能一致
  • 强大的数据网格：虚拟滚动支持大结果集，内联编辑、多种导出格式（CSV/JSON/Markdown/XLSX）
  • Schema 工具：浏览器侧边栏、ER 图、Schema 对比、字段血缘分析、执行计划可视化
  • 开源免费：基于 AGPL-3.0 协议开源，可免费使用和修改

应用场景

  • 数据库管理员：通过一个工具管理 MySQL、PostgreSQL、Redis 等多种数据库，告别频繁切换客户端
  • 开发团队：通过 Docker 自托管部署，团队成员共享数据库连接配置，统一管理
  • AI 辅助开发：利用内置 AI 助手生成复杂查询 SQL，解释和优化现有查询，提升开发效率
  • 数据分析：支持 DuckDB、ClickHouse、StarRocks 等分析型数据库，配合数据导入导出功能进行数据探索
  • 数据库迁移：支持数据库间数据迁移和 Schema 对比，方便版本管理和跨环境同步
  • 远程服务器管理：支持 SSH 隧道连接，安全访问内网数据库

DBX 是一个功能全面、轻量高效的数据库管理工具，尤其适合追求极简部署和 AI 辅助的用户。

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 t8y2，选择第一个 t8y2/dbx，版本选择 latest。

本文写作时，latest 版本对应为 0.5.29；

卷

在 docker 文件夹中，创建一个新文件夹 dbx，并在其中建一个子文件夹 data

文件夹 装载路径 说明
docker/dbx/data /app/data 存放配置和数据

端口

本地端口不冲突就行，不确定的话可以用命令查一下

1
2
# 查看端口占用
netstat -tunlp | grep 端口号
本地端口 容器端口
4224 4224

命令行安装

docker cli 安装

如果你熟悉命令行，可能用 docker cli 更快捷

1
2
3
4
5
6
7
8
9
10
11
12
13
# 新建文件夹 dbx 和 子目录
mkdir -p /volume1/docker/dbx/data

# 进入 dbx 目录
cd /volume1/docker/dbx

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name dbx \
   -p 4224:4224  \
   -v $(pwd)/data:/app/data \
   t8y2/dbx

docker-compose 安装

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

1
2
3
4
5
6
7
8
9
services:
  dbx:
    image: t8y2/dbx
    container_name: dbx
    restart: unless-stopped
    ports:
      - "4224:4224"
    volumes:
      - ./data:/app/data

然后通过 SSH 登录到您的群晖，执行下面的命令：

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 dbx 和 子目录
mkdir -p /volume1/docker/dbx/data

# 进入 dbx 目录
cd /volume1/docker/dbx

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中访问 http://<群晖IP>:4224 ，首次需要设置访问密码

软件的主界面

点击左侧「新建连接」按钮创建新的数据库连接

以 umami 的 MariaDB 10 数据库为例

  • URL：是可选的，默认可以保持空白
  • 名称：用于区别不同的连接
  • 类型：选 MariaDB
  • 主机：填入 IP 和端口
  • 用户名：数据库用户
  • 密码：数据库密码
  • 数据库：数据库库名

可以 测试 一下连接，如果测试通过可以保存

可以直接查看表单

也可在 SQL 编辑器中执行查询

如果需要使用 AI 功能，需在设置中配置 AI Provider（支持 OpenAI、Claude 或本地 Ollama 模型）

还是以 硅基流动 为例

  • 提供商：选择 OpenAI Compatible
  • API Key：你的硅基流动的 API Key
  • Endpoint：硅基流动的地址是 https://api.siliconflow.cn/v1
  • 模型：如果 API Key 和 Endpoint ，没问题，点 浏览模型 可以选择模型

目前硅基流动（SiliconFlow）注册就送 16 元的代金券

注册地址：

https://cloud.siliconflow.cn/i/NkUiXVhQ

而且 nex-agi/Nex-N2-Pro 模型现在限免中

注册地址：

https://s.qiniu.com/2ENRR3

可以直接生成 SQL 并直接运行

如果你的数据库不在支持列表中，可以看看 驱动管理

注意事项

  1. 数据持久化：/app/data 目录存放所有配置和连接信息，建议挂载到群晖本地目录确保数据不丢失
  2. AI 功能：AI SQL 助手需要配置 AI Provider，如果不使用 AI 功能可以跳过配置
  3. MCP 集成：如需通过 AI 编码工具访问数据库，需额外配置 MCP Server（npx @dbx-app/mcp-server）
  4. 性能：15MB 极致轻量，即使在低配群晖上也能流畅运行

参考文档

t8y2/dbx: 15MB, lightweight, cross-platform database client. Supports MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, ClickHouse, SQL Server and more.
地址：https://github.com/t8y2/dbx

DBX 官方文档
地址：https://dbxio.com

DBX Getting Started
地址：https://dbxio.com/en/docs/getting-started