## 功能特性
### 17+ 种数据库,一个工具搞定
MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server、Oracle、Elasticsearch、MariaDB、TiDB、OceanBase、openGauss、GaussDB、KingBase、Vastbase、GoldenDB — 全部在一个约 15 MB 的应用中连接。不内嵌 Chromium。
### 查询编辑器
CodeMirror 6 语法高亮、智能自动补全(表名和字段)、`Cmd+Enter` 执行、选中 SQL 执行、SQL 格式化,9 种编辑器主题。查询历史持久化存储,支持搜索和恢复。
### AI SQL 助手
用自然语言描述你的需求,直接生成 SQL。还能解释、优化、修复错误。支持 Claude、OpenAI 或任何 OpenAI 兼容端点。
### 数据表格
虚拟滚动,轻松应对百万行数据。行内编辑、排序、全文搜索、分页、列宽调整、行号、斑马纹。支持导出为 CSV、JSON、Markdown。
### Schema 工具
- **结构浏览** — 数据库、Schema、表、字段、索引、外键、触发器,支持侧边栏搜索和置顶
- **ER 关系图** — 可视化表间关联
- **Schema 对比** — 跨连接对比表结构差异
- **执行计划** — 可视化查询执行计划
- **字段血缘** — 字段级血缘分析
### 数据操作
- **数据导入** — CSV、Excel
- **数据迁移** — 在数据库之间迁移数据
- **数据库导出** — 完整数据库导出
- **SQL 文件执行** — 直接执行 `.sql` 文件
- **文件预览** — 拖入 Parquet、CSV、JSON 即时预览(基于 DuckDB)
### 专项浏览器
- **Redis** — 模式匹配搜索,全数据类型支持(String、Hash、List、Set、ZSet、Stream)
- **MongoDB** — 文档增删改查、分页浏览,支持 Atlas 和副本集 URL 直连
### 安全与连接
SSH 隧道(密钥和密码认证)· 断线自动重连 · 危险操作确认对话框 · 加密导出/导入连接配置 · 连接颜色标记
### 精致 UI
深色模式原生标题栏同步 · 9 种编辑器主题 · English & 简体中文 · 内置自动更新
## AI 编程助手集成 (MCP)
DBX 提供 [MCP Server](mcp/),让 AI 编程助手直接使用 DBX 中已配置的数据库连接查询数据。
```bash
npx @dbx-app/mcp-server
```
在 `.mcp.json` 中添加:
```json
{
"mcpServers": {
"dbx": { "command": "npx", "args": ["-y", "@dbx-app/mcp-server"] }
}
}
```
支持 Claude Code、Cursor、Windsurf 等 MCP 兼容的 AI 助手。可列出连接、浏览表、执行 SQL,还能直接在 DBX 界面中打开表。
详见 [MCP Server 说明](mcp/README.md)。
## 安装
从 [Releases](https://github.com/t8y2/dbx/releases/latest) 页面下载最新版本。
**Homebrew (macOS):**
```bash
brew install --cask t8y2/tap/dbx
```
**Scoop (Windows):**
```bash
scoop bucket add dbx https://github.com/t8y2/scoop-bucket
scoop install dbx
```
## 自托管 (Docker)
DBX 提供 Web 版本,可通过 Docker 部署。
```bash
docker run -d --name dbx -p 4224:4224 -v dbx-data:/app/data t8y2/dbx
```
或使用 Docker Compose:
```yaml
services:
dbx:
image: t8y2/dbx
ports:
- "4224:4224"
volumes:
- dbx-data:/app/data
restart: unless-stopped
volumes:
dbx-data:
```
浏览器访问 `http://localhost:4224`。支持 amd64 / arm64 双架构镜像。
## 快速开始
### 环境要求
- [Node.js](https://nodejs.org/) >= 18
- [pnpm](https://pnpm.io/)
- [Rust](https://www.rust-lang.org/tools/install) >= 1.77
#### 系统依赖
**macOS:**
无需额外安装。
**Linux (Ubuntu/Debian):**
```bash
sudo apt-get install -y libwebkit2gtk-4.1-dev libgtk-3-dev libappindicator3-dev librsvg2-dev patchelf libssl-dev
```
**Windows:**
无需额外安装。
### 开发
```bash
pnpm install
pnpm dev:tauri
```
Web 版本:
```bash
pnpm dev:web # 前端
pnpm dev:backend # 后端
```
### 构建
```bash
pnpm tauri build
```
安装包输出在 `src-tauri/target/release/bundle/` 目录。
## 技术栈
| 层级 | 技术 |
|------|------|
| 框架 | [Tauri 2](https://tauri.app/) |
| 前端 | [Vue 3](https://vuejs.org/) + TypeScript |
| UI | [shadcn-vue](https://www.shadcn-vue.com/) + Tailwind CSS |
| 编辑器 | [CodeMirror 6](https://codemirror.net/) |
| 后端 | Rust + [sqlx](https://github.com/launchbadge/sqlx) / [tiberius](https://github.com/prisma/tiberius) / [redis-rs](https://github.com/redis-rs/redis-rs) / [mongodb](https://github.com/mongodb/mongo-rust-driver) |
## 社区