# dbx **Repository Path**: anydev/dbx ## Basic Information - **Project Name**: dbx - **Description**: 轻量级跨平台数据库桌面客户端。这是一款轻量级、跨平台、可离线使用的数据库桌面客户端，支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB 等 40+ 种数据库。它集成了连接管理、SQL 编辑、数据表格和 AI 助手功能，并提供 Docker 自托管、Web 版、MCP Server 和 CLI。 - **Primary Language**: Unknown - **License**: AGPL-3.0 - **Default Branch**: main - **Homepage**: https://dbxio.com/ - **GVP Project**: No ## Statistics - **Stars**: 3 - **Forks**: 1 - **Created**: 2026-06-01 - **Last Updated**: 2026-06-06 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

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

DBX 截图

加入 Discord 加入 QQ 群 加入微信交流群

English | 简体中文

## 为什么选择 DBX？

🪶 15 MB，极致轻量

无需 Java 运行环境，无需 Python 虚拟环境，不内嵌 Chromium。DBX 是单个小巧的二进制文件——下载、安装、连接。DBeaver 依赖 Java；TablePlus 仅限 macOS。DBX 全平台可用，无需额外运行时。

🤖 AI 原生集成在编辑器里

选中一张表，描述你想要什么，直接得到 SQL——无需在工具之间复制粘贴。支持 Claude、OpenAI，或通过 Ollama 使用本地模型。内置安全检查会在执行前审查 AI 生成的 SQL。

🔌 MCP 协议：你的数据库，AI 就绪

DBX 原生支持 Model Context Protocol。Claude Code、Cursor、Windsurf 等 AI 编程助手可以直接通过你已配置的数据库连接查询数据。一次配置，处处可用。

🌐 桌面端 + Docker + Web

macOS、Windows、Linux 原生应用。通过 Docker 自托管供团队访问。Web 版本适配纯浏览器环境。同样的功能，同样的连接配置。
## 功能特性 ### 40+ 种数据库，一个工具搞定 MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server、Oracle、Elasticsearch、MariaDB、TiDB、OceanBase、openGauss、GaussDB、KingBase、Vastbase、GoldenDB、Doris、SelectDB、StarRocks、Redshift、DM、TDengine、虚谷 XuguDB、CockroachDB、Access、HighGo 等数据库都能直接连接。Agent/JDBC 方向的配置还可扩展到 H2、Snowflake、Trino、Hive、DB2、Informix、Neo4j、Cassandra、BigQuery、Kylin、SunDB 和自定义 JDBC。全部装进约 15 MB 的应用里，不内嵌 Chromium。 ### 查询编辑器 CodeMirror 6 语法高亮、元数据感知自动补全、`Cmd+Enter` 执行、选中 SQL 执行、SQL 格式化、诊断提示，9 种编辑器主题。查询历史、常用 SQL 片段、标签页恢复和 SQL 文件执行让重复工作更顺手。 ### AI SQL 助手 用自然语言描述你的需求，直接生成 SQL。还能解释查询、优化 SQL、修复错误，并通过内置安全检查执行 AI 生成的 SQL。支持 Claude、OpenAI、本地模型或任何 OpenAI 兼容端点。 ### 数据表格 虚拟滚动，轻松应对大型结果集。行内编辑、保存前 SQL 预览、WHERE / ORDER BY 控件、DataGrip 风格过滤器、LIKE / NOT LIKE 右键过滤、排序、全文搜索、分页、列宽调整、自动列宽、行号、斑马纹和完整单元格详情。支持导出或复制为 CSV、JSON、Markdown、XLSX、INSERT 语句。 ### Schema 工具 - **结构浏览** — 数据库、Schema、表、字段、索引、外键、触发器，支持侧边栏搜索和置顶 - **对象浏览** — 按类型分组查看过程、函数、视图，并在支持的数据库中编辑源码 - **表结构编辑器** — 对支持的数据库执行可审查的字段和索引变更 - **ER 关系图** — 可视化表间关联 - **Schema 对比** — 跨连接对比表结构差异 - **执行计划** — 可视化查询执行计划 - **字段血缘** — 字段级血缘分析 - **数据库搜索** — 在大型 Schema 中快速查找对象 ### 数据操作 - **数据导入** — CSV、Excel - **数据迁移** — 在数据库之间迁移数据 - **数据库导出** — 完整数据库导出 - **数据对比** — 对比表数据并审查同步结果 - **SQL 文件执行** — 直接执行 `.sql` 文件 - **文件预览** — 拖入 Parquet、CSV、JSON 即时预览（基于 DuckDB） - **连接导入** — 从 DBeaver 或 Navicat 导入连接配置 ### 专项浏览器 - **Redis** — 模式匹配搜索、批量键操作、命令执行器、TTL 编辑，全数据类型支持（String、Hash、List、Set、ZSet、Stream） - **MongoDB** — 文档增删改查、分页浏览，支持 Atlas 和副本集 URL 直连 ### 安全与连接 SSH 隧道（密钥和密码认证）· 数据库和 AI 代理设置 · 断线自动重连 · 危险操作确认对话框 · 加密导出/导入连接配置 · 连接颜色标记 · 驱动商店与可选 JDBC 插件 ### 精致 UI 深色模式原生标题栏同步 · 9 种编辑器主题 · English、简体中文、Español · 布局偏好设置 · 内置自动更新 ## AI 编程助手集成 (MCP) DBX 提供 [MCP Server](packages/mcp-server/)，让 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 界面中打开表。 DBX 也提供独立 CLI 包，适合终端、脚本和 Codex 工作流： ```bash npm install -g @dbx-app/cli dbx connections list --json dbx query local "select 1" --json ``` 详见 [MCP Server 说明](packages/mcp-server/README.md) 和 [CLI 说明](packages/cli/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，示例文件位于 `deploy/docker-compose.yml`： ```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) | ## 社区 Discord QQ 群 微信交流群 [![LINUX DO](https://img.shields.io/badge/LINUX%20DO-社区-blue)](https://linux.do) ## 常见问题
DBX 是免费的吗？ 是的。DBX 基于 AGPL-3.0 协议开源，所有功能均免费使用。
DBX 会收集用户数据吗？ 不会。DBX 不收集任何遥测数据。自动更新功能仅检查 GitHub Releases 获取新版本——你可以在设置中禁用它。
可以离线使用吗？ 可以。桌面端完全支持离线使用。AI 功能需要网络访问模型端点（或通过 Ollama 使用本地模型）。
DBX 和 DBeaver / TablePlus / Beekeeper Studio 有什么区别？ DBX 仅 15 MB，无需运行时依赖（无需 Java、无需 Python）。AI 和 MCP 是原生内置功能，不是插件。单一代码库同时支持 40+ 数据库、桌面端、Docker 和 Web。
支持哪些数据库？ MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server、Oracle、Elasticsearch、MariaDB、TiDB、OceanBase、openGauss、GaussDB、KingBase、Vastbase、GoldenDB、Doris、SelectDB、StarRocks、Redshift、DM、TDengine、虚谷 XuguDB、CockroachDB、Access、HighGo 等。JDBC 方向配置可扩展到 H2、Snowflake、Trino、Hive、DB2、Informix、Neo4j、Cassandra、BigQuery、Kylin、SunDB 及自定义 JDBC 连接。
如何报告 Bug 或请求新功能？ 在 GitHub Issues 提交 Issue。
## 贡献者 ## Star History Star History Chart ## 开源协议 [AGPL-3.0](LICENSE)