dbx/README.zh-CN.md

12 KiB
Raw Blame History

DBX

15 MB 驾驭 25+ 种数据库。桌面端 & Docker 自托管,内置 AI 助手。

加入 Discord 加入 QQ 群

English | 简体中文

功能特性

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,让 AI 编程助手直接使用 DBX 中已配置的数据库连接查询数据。

npx @dbx-app/mcp-server

.mcp.json 中添加:

{
  "mcpServers": {
    "dbx": { "command": "npx", "args": ["-y", "@dbx-app/mcp-server"] }
  }
}

支持 Claude Code、Cursor、Windsurf 等 MCP 兼容的 AI 助手。可列出连接、浏览表、执行 SQL还能直接在 DBX 界面中打开表。

详见 MCP Server 说明

安装

Releases 页面下载最新版本。

Homebrew (macOS)

brew install --cask t8y2/tap/dbx

Scoop (Windows)

scoop bucket add dbx https://github.com/t8y2/scoop-bucket
scoop install dbx

自托管 (Docker)

DBX 提供 Web 版本,可通过 Docker 部署。

docker run -d --name dbx -p 4224:4224 -v dbx-data:/app/data t8y2/dbx

或使用 Docker Compose

services:
  dbx:
    image: t8y2/dbx
    ports:
      - "4224:4224"
    volumes:
      - dbx-data:/app/data
    restart: unless-stopped

volumes:
  dbx-data:

浏览器访问 http://localhost:4224。支持 amd64 / arm64 双架构镜像。

快速开始

环境要求

系统依赖

macOS

brew install unixodbc

Linux (Ubuntu/Debian)

sudo apt-get install -y libwebkit2gtk-4.1-dev libgtk-3-dev libappindicator3-dev librsvg2-dev patchelf libssl-dev unixodbc-dev

Windows

无需额外安装ODBC 已内置于 Windows

开发

pnpm install
pnpm dev:tauri

Web 版本:

pnpm dev:web       # 前端
pnpm dev:backend   # 后端

构建

pnpm tauri build

安装包输出在 src-tauri/target/release/bundle/ 目录。

技术栈

层级 技术
框架 Tauri 2
前端 Vue 3 + TypeScript
UI shadcn-vue + Tailwind CSS
编辑器 CodeMirror 6
后端 Rust + sqlx / tiberius / redis-rs / mongodb

社区

Discord QQ 群 LINUX DO

贡献者

Star History

Star History Chart

开源协议

AGPL-3.0