简介什么是 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
存放配置和数据
端口本地端口不冲突就行，不确定的话可以用命令查一下
12# 查看端口占用netstat -tunlp | grep 端口号
本地端口
容器端口
4224
4224
命令行安装docker cli 安装如果你熟悉命令行，可能用 docker cli 更快捷
12345678910111213# 新建文件夹 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 文件
123456789services: dbx: image: t8y2/dbx container_name: dbx restart: unless-stopped ports: - "4224:4224" volumes: - ./data:/app/data
然后通过 SSH 登录到您的群晖，执行下面的命令：
12345678910# 新建文件夹 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 并直接运行
如果你的数据库不在支持列表中，可以看看 驱动管理
注意事项
数据持久化：/app/data 目录存放所有配置和连接信息，建议挂载到群晖本地目录确保数据不丢失
AI 功能：AI SQL 助手需要配置 AI Provider，如果不使用 AI 功能可以跳过配置
MCP 集成：如需通过 AI 编码工具访问数据库，需额外配置 MCP Server（npx @dbx-app/mcp-server）
性能：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