dbx

❤️ Sponsors

	JumpServer 是一款具备 AI 能力的开源特权访问管理（PAM）平台，为 DevOps 和 IT 团队提供统一工作区，安全访问 SSH、RDP、Kubernetes、数据库、网站、RemoteApp、VirtualApp 等。 访问 JumpServer
	RainYun 是一家云服务提供商，提供云服务器、物理服务器、游戏托管和对开发者友好的基础设施服务。 访问 RainYun
	Jalapeño Cloud 是一个 AI 基础设施和 Token 计算平台，并提供专属 DBX 入口，可享免费额度和充值奖励。 访问 Jalapeño Cloud
	特别感谢 AICodeMirror 赞助本项目！AICodeMirror 为 Claude Code / Codex / Gemini CLI 提供高稳定性的官方中转服务，具备企业级并发能力、快速开票和 7×24 专属支持。Claude Code / Codex / Gemini 的官方渠道价格低至标价的 38% / 2% / 9%，充值还可享额外折扣！AICodeMirror 为 DBX 用户提供专属福利：通过此链接注册，首次充值可享 8 折，企业客户最高可享 75 折。 访问 AICodeMirror
	HuaLongAI 是专为高强度 AI 开发者打造的模型 API 中转服务，提供 100% 官方来源的 Codex 和 Claude 模型，支持透明的 Token 级计费、企业合同和开票。 访问 HuaLongAI
	HiAPI 是面向开发者的图像、视频、音频和文本模型 API 平台，提供 GPT Image 2.5（Flare 和 Sunburst）、兼容 OpenAI 的文本端点，以及适用于 Claude Code、Cursor 等产品的远程 MCP/Agent Skills。按使用量付费，无最低消费；新用户注册可获 200 Credits，充值还可获得 10% 额外 Credits。 访问 HiAPI
	UCloud 是首家在中国科创板上市的公有云服务商，拥有 28 个全球区域，提供云托管、数据库和 CDN 服务；其 AstraFlow 平台支持一键接入 200 多种主流大模型。 访问 UCloud

PackyCode 是稳定、高效的主流 AI 模型 API 中转服务。通过一个 API 端点和一个 API 密钥即可访问这些模型；自动故障切换可确保访问快速可靠，并为 Codex 和 Claude Code 提供专用高速线路。注册即可获得 1 美元免费额度、首次充值折扣，以及符合条件的线路高达 80% 的折扣；支持人民币支付，不收取货币转换加价或额外充值费用。 访问 PackyCode 太一智能体企业版是面向央国企的私有化智能体平台，采用“1+N+N”架构：1 个平台、N 个终端、N 个场景。可信：Java 微服务架构，私有化部署，全程留痕可审计。可控：关键操作人工审批，资料按密级管理。可达：按单位模板直接生成公文、台账和汇报材料。可复制：场景方案包化交付，便于推广和二次开发。欢迎预约演示，或在 GitHub 搜索 MateClaw。 访问太一企业版 TrustAsia 提供基于云的代码签名服务，适用于 DBX，可通过自动化 CI/CD 构建实现可信软件交付。 访问 TrustAsia Atlas Cloud 为开发者提供统一 API，可接入 400 多种 AI 模型，涵盖聊天、图像、视频和音频。 访问 Atlas Cloud Qiniu Cloud 为 DBX 提供对象存储、CDN 及其他云基础设施资源。 访问 Qiniu Cloud

🤝 合作伙伴

	1Panel 是一款现代化的开源 Linux 服务器管理面板和轻量级 AI 管理平台，提供直观的 Web 界面，可一站式管理 AI Agent、本地大模型、网站、数据库、容器、文件等。 访问 1Panel
	Easysearch 是一款企业级分布式搜索引擎，兼容 Elasticsearch API，将全文、向量和地理空间搜索、实时分析及 AI 能力整合于一个平台。 访问 Easysearch

## 为什么选择 DBX？

🪶 仅 25 MB，零运行时臃肿依赖 无需 Java JRE。无需 Python venv。无需捆绑 Chromium。DBX 以一个小巧的二进制文件形式提供——下载、安装、连接即可。DBeaver 需要 Java；TablePlus 是免费增值软件。DBX 无需额外组件，即可在任何地方运行。	🤖 融入编辑器的 AI 选中一个表，描述你的需求，即可获得 SQL——无需在工具之间复制粘贴。支持通过 Ollama 使用 Claude、OpenAI 或本地模型。内置安全检查会在运行 AI 生成的 SQL 前进行审查。
🔌 MCP：让你的数据库随时可供 AI 使用 DBX 支持 Model Context Protocol。Claude Code、Cursor、Windsurf 和其他 AI 编码 Agent 可以通过你已设置的连接查询数据库。一份配置，到处使用。	🌐 桌面应用 + Docker + Web 适用于 macOS、Windows 和 Linux 的原生应用。通过 Docker 自托管，供团队访问。也提供适用于仅支持浏览器环境的 Web 版本。功能集相同，连接也相同。
📨 不只有数据库 消息队列和中间件也配有一流的控制台：Kafka、RocketMQ、RabbitMQ、Pulsar 和 MQTT，以及 Nacos、Consul、ZooKeeper 和 etcd。无需额外工具，即可在数据库旁检查主题和消息。	🧩 插件生态 通过内置商店中的签名沙箱插件扩展 DBX，支持 S3、Kubernetes、LDAP 等。也可以使用 Go / TypeScript SDK 构建自己的插件。

功能

100+ 种数据库，一个工具

MySQL、PostgreSQL、SQLite、Cloudflare D1、Redis、MongoDB、DuckDB、ClickHouse、SQL Server、Oracle、Elasticsearch、Easysearch、Meilisearch、CouchDB、Qdrant、Milvus、Weaviate、MariaDB、TiDB、OceanBase、openGauss、GaussDB、KWDB、KingbaseES、Vastbase、GoldenDB、Doris、SelectDB、StarRocks、Manticore Search、Redshift、DM、TDengine、XuguDB、CockroachDB、Access、HighGo、UXDB、Dolt 等。基于 Agent 的配置文件可将 DBX 扩展至 H2、Snowflake、Trino、PrestoSQL、Hive、DB2、Informix、Neo4j、Cassandra、BigQuery、Cloud Spanner、Kylin、SunDB、JDBCX 和自定义 JDBC 连接。新的原生驱动和 Agent 驱动还支持 Databricks、SAP HANA、Teradata、Vertica、Firebird、Exasol、YashanDB、GBase 8a/8s、Databend、RQLite、Turso、InfluxDB、QuestDB、IoTDB、etcd、ZooKeeper、Nacos、Consul KV、IRIS 等。全部集成在一个约 25 MB 的应用中。无需捆绑 Chromium。

查询编辑器

基于 CodeMirror 6，提供 SQL 语法高亮、感知元数据的自动补全、Cmd+Enter 执行、选中 SQL 执行、SQL 格式化、诊断和 9 种编辑器主题。持久化查询历史、已保存的 SQL 片段、标签页恢复和 SQL 文件执行，让重复工作触手可及。

AI SQL 助手

用通俗语言描述你的需求，即可获得 SQL。DBX 可以解释查询、优化 SQL、修复错误，并通过内置安全检查运行 AI 生成的 SQL。支持 Claude、OpenAI、本地模型或任何兼容 OpenAI 的端点。

数据网格

采用虚拟滚动的表格，可处理大型结果集。支持行内编辑、保存前预览 SQL、WHERE / ORDER BY 控件、DataGrip 风格的筛选器、LIKE / NOT LIKE 上下文筛选、排序、全文搜索、分页、调整列宽、自动适配、行号、斑马纹和完整的单元格详情。可导出或复制为 CSV、JSON、Markdown、XLSX 或 INSERT 语句。

架构工具

• 架构浏览器 — 数据库、架构、表、列、索引、外键、触发器，支持侧边栏搜索和固定
• 对象浏览器 — 分组查看存储过程、函数和视图，并在支持的情况下编辑源代码
• 表结构编辑器 — 查看支持的数据库引擎中的列和索引变更
• ER 图 — 可视化表之间的关系
• 架构差异 — 比较不同连接中的结构
• 执行计划 — 可视化查询执行计划
• 字段血缘 — 列级血缘分析
• 数据库搜索 — 在大型架构中查找对象

数据操作

• 表导入 — CSV、Excel
• 数据传输 — 在数据库之间迁移
• 数据库导出 — 完整数据库转储
• 数据比较 — 比较表数据并查看同步输出
• SQL 文件执行 — 直接运行 .sql 文件
• 文件预览 — 拖放 Parquet、CSV、JSON 文件即可即时预览（由 DuckDB 提供支持）
• 连接导入 — 从 DBeaver 或 Navicat 导入连接配置文件

专用浏览器

• Redis — 键模式搜索、批量键操作、命令运行器、TTL 编辑，以及所有数据类型（String、Hash、List、Set、ZSet、Stream）
• MongoDB — 支持分页的文档 CRUD、Atlas 和副本集 URL 连接

消息队列和中间件控制台

• Kafka / RocketMQ / RabbitMQ / Pulsar — 主题、消费者组、消息浏览、查询和追踪、代理监控、权限和策略
• MQTT — 主题树导航、订阅和发布
• Nacos / Consul / ZooKeeper / etcd — 服务发现、KV / 配置浏览、健康状态和 ACL

插件系统

• 可扩展性是设计核心 — 新的连接类型和工具以插件形式提供：S3 浏览、Kubernetes、LDAP 等，均可从内置商店获取
• 签名验证且沙箱隔离 — 每个插件包在安装前都会进行签名验证；插件 UI 在独立的 Sidecar 进程中以沙箱方式运行
• 构建自己的插件 — 提供 Go / TypeScript SDK，并通过 npx @dbx-app/plugin-cli 脚手架快速搭建；通过 t8y2/dbx-store 发布到 Marketplace

安全与连接

SSH 隧道（密钥和密码）· 数据库和 AI 代理设置 · 连接丢失时自动重连 · 危险操作的确认对话框 · 加密配置导出/导入 · 连接颜色标识 · 驱动程序商店和可选 JDBC 插件

精致的 UI

深色模式与原生标题栏同步 · 9 种编辑器主题 · English、简体中文和 Español · 布局偏好设置 · 内置自动更新

AI Agent 集成（MCP）

DBX 提供了一个独立的 Rust 驱动的 MCP 服务，让 AI 编码 Agent 使用 DBX 中配置的连接查询数据库。MCP 服务独立于桌面应用发布，因此安装 DBX 不会自动安装 MCP 可执行文件。

npx @dbx-app/mcp-server

添加到你的 .mcp.json 中：

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

在 DBX 设置 → MCP 中管理连接允许列表以及 只读、数据读写 和 完全访问 模式。机器可读值仍为 read_only、safe_write 和 high_risk_write；客户端配置无需设置权限或连接范围环境变量。

为兼容升级，现有的 DBX_MCP_ALLOW_WRITES=0（或 false）仅在首次保存集中式 MCP 策略之前继续施加只读限制；它绝不会启用写入，也不会覆盖已保存的策略。

Windows 便携版需要在 MCP 配置中设置 DBX_DATA_DIR，指向 DBX.exe 同级的 data 目录（其中包含 dbx.db 的文件夹）。

对于 DBX Web 或 Docker 部署，请将 MCP 服务指向 Web 后端 API。如果 Web 登录页要求密码，请将 DBX_WEB_PASSWORD 设置为与该页面相同的密码：

{
  "mcpServers": {
    "dbx": {
      "command": "npx",
      "args": ["-y", "@dbx-app/mcp-server"],
      "env": {
        "DBX_WEB_URL": "http://localhost:4224",
        "DBX_WEB_PASSWORD": "your-web-login-password"
      }
    }
  }
}

兼容 Claude Code、Cursor、Windsurf 以及任何支持 MCP 的 Agent。支持列出连接、浏览表、执行 SQL，以及直接在 DBX 界面中打开表。

macOS、Linux 和 Windows 的预编译原生二进制文件也已发布在软件包发行页上。它们无需 Node.js 即可运行，适用于离线或服务器环境。npm 安装包通过一个小型 Node.js 启动器使用相同的 Rust 二进制文件。

DBX 还提供专用 CLI 软件包，适用于终端、脚本和 Codex 工作流：

npm install -g @dbx-app/cli
# or via Homebrew
brew tap t8y2/tap && brew install dbx-cli
dbx agent setup
dbx connections list --json
dbx query local "select 1" --json

CLI 包含官方 DBX Agent Skill。dbx agent setup 可离线安装或更新此 Skill，路径为 ~/.agents/skills/dbx，让支持 Shell 的 AI Agent 安全地使用 DBX CLI。

详情请参阅 MCP 服务 README 和 CLI README。

安装

从 Releases 页面下载最新版本。

Homebrew（macOS）：

brew install --cask dbx

Scoop（Windows）：

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

WinGet（Windows）：

winget install t8y2.dbx

Flatpak（Linux）：

flatpak remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo
flatpak install flatpark com.dbxio.dbx

之后可通过常规的 flatpak update 获取更新。详情请参阅 FlatPark 上的 DBX 页面。

自托管（Docker）

如需在关闭桌面应用或浏览器后执行计划备份，请参阅 后台数据库备份，其中包括 Windows/macOS/Linux 启动设置和持久化容器备份卷。

DBX 提供可通过 Docker 部署的 Web 版本。以下示例使用 latest 标签拉取当前版本。

# The default keeps the key in the persistent /app/data volume.
docker run -d --pull=always --name dbx -p 4224:4224 \
  -v dbx-data:/app/data \
  t8y2/dbx:latest

此配置使用跨平台的 dbx-data 命名卷。中国用户可以使用 CNB 镜像 docker.cnb.cool/dbxio.com/dbx:latest，以加快拉取速度。

对于 Docker Compose，deploy/docker-compose.yml 仍是源码构建 配置。要部署已发布的镜像，请使用 deploy/docker-compose.release.yml：

docker compose -f deploy/docker-compose.release.yml up -d

services:
  dbx:
    image: t8y2/dbx:latest
    # For faster pulls in China, use the CNB image instead:
    # image: docker.cnb.cool/dbxio.com/dbx:latest
    pull_policy: always
    ports:
      - "4224:4224"
    volumes:
      - dbx-data:/app/data
    restart: unless-stopped

volumes:
  dbx-data:

在浏览器中打开 http://localhost:4224。提供多架构镜像（amd64 / arm64）。

连接、插件、AI 和隧道凭据会先经过加密，再写入 dbx.db。桌面版使用本地平台凭据存储 （macOS Keychain、Windows Credential Manager 或 Linux Secret Service）。 Web/Docker 和直接运行的 dbx-web 默认使用同一个受管理的数据目录密钥：${DBX_DATA_DIR}/.dbx/secret.key。只有在 迁移开始或首次写入敏感值时才会创建此密钥，且必须与 dbx.db 一起备份。因此，对于常规 Docker 部署， 持久化 /app/data 即可。此密钥可以保护数据库内容，但如果整个数据卷被复制或暴露，则无法保护该数据卷。 Windows 便携版是桌面平台密钥规则的例外。 为确保能在不同电脑间便携使用，它们会将本地存储密钥保存在 data/.dbx/secret.key；请移动并备份完整的 data 目录。如果 旧的便携版配置文件中已有由 Windows Credential Manager 保护的密文，请在原电脑上启动一次新版，以便 DBX 验证并将该密钥复制到 U 盘。如果原电脑或密钥已丢失，则无法自动恢复密文；请还原原始密钥或迁移前的备份。将密钥保存在数据库旁，意味着任何获取或复制整个驱动器的人也能解密其中的凭据。

对于生产环境部署，请通过设置 DBX_SECRET_KEY_FILE，将托管密钥替换为 Docker/Kubernetes Secret，或通过密钥管理器提供 DBX_SECRET_KEY。显式指定的密钥优先级最高；加密数据仍在使用时，绝不能轮换密钥。如果没有可用密钥，业务 API 将继续被阻止，浏览器会显示数据安全升级界面。

直接运行二进制文件时，设置 DBX_DATA_DIR=/var/lib/dbx，即可使用 /var/lib/dbx/.dbx/secret.key，并遵循相同的生命周期和备份规则。

从以明文存储凭据的版本升级时，Desktop 和 Web 会在打开主应用程序前显示数据安全升级向导。选择开始升级，即可创建受限备份、迁移旧版数据库/JSON 凭据，并验证加密值是否可读。如果失败，原始数据和备份都会保留；请修复向导中显示的问题，然后选择重试。成功后会显示备份路径。验证连接后，选择删除迁移备份，系统会请求确认，并删除迁移备份目录及此次迁移创建的旧版 JSON .bak 文件。其他无关的备份文件会保留。没有旧版数据的用户通过初始检查后即可直接继续。

本地 CLI 和独立 MCP 可在同一设备上复用现有的平台凭据存储，或读取显式配置的 DBX_SECRET_KEY_FILE/DBX_SECRET_KEY。它们不会在启动检查期间创建密钥，也不会自动迁移旧版数据。出现 DATA_MIGRATION_REQUIRED 错误表示你必须先在 Desktop 或 Web 中打开同一数据目录，并完成升级向导。对于没有平台凭据存储的无头主机，请配置持久密钥。

跨设备导出使用单独的同步密码，不包含本地存储密钥。对于安装版，或仅复制 dbx.db 的情况，平台密钥不会随数据库迁移；请改用加密导出/导入。Windows 便携版必须移动包含 dbx.db 和 .dbx/secret.key 的完整 data 目录。

有关完整设计、迁移状态机、实现映射、故障排除和测试计划，请参阅 DBX 数据安全升级与迁移。

要通过反向代理上下文路径（例如 /dbx）发布 DBX，请设置运行时基础路径，并将相同前缀代理到容器：

environment:
  - DBX_PUBLIC_BASE_PATH=/dbx

如果自行构建前端并使用绝对资源基础路径，请在运行 pnpm build 前设置 VITE_DBX_BASE_PATH=/dbx/。

快速开始

先决条件

• Node.js >= 18
• pnpm
• Rust >= 1.88

系统依赖

macOS：

无需其他依赖。

Linux（Ubuntu/Debian）：

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

NIXOS/NIX：

请参阅 README-NIX.md

Windows：

无需其他依赖。

开发

make

make 会在需要时安装根目录依赖，并启动本地 Tauri 桌面开发环境。

开发版本可以与已安装的 DBX 实例同时运行，并共享其本地数据，包括连接和历史记录。请避免同时在两个窗口中更改同一连接或全局设置。

提示

DuckDB 编译需要一些时间。如果你当前不在开发 DuckDB 相关功能， 可以跳过编译以加快本地构建：

# 快速检查（跳过 DuckDB）
make cargo-check-fast
make cargo-test-fast

# 不包含 DuckDB 的 Tauri 开发模式
make dev-fast

--no-default-features 标志仅影响本地开发。 发布构建（pnpm tauri build）始终包含 DuckDB。

Web 版本：

make dev-web       # frontend
make dev-backend   # backend

文档站点：

make docs

DBX 官方文档站点的内容位于 docs/。如果你想改进网站内容或文档页面，请编辑 docs/ 下的文件，并运行 make docs 在本地预览站点。

插件作者应从 Develop and Submit DBX Plugins 开始。插件源代码通常保存在独立的代码仓库中；Marketplace 列表的拉取请求应提交到 t8y2/dbx-store，而插件宿主、SDK 和 CLI 的更改应提交到此代码仓库。

如需创建干净、可复现的本地数据库实例，请使用 deploy/database/ 下按版本管理的 Docker Compose 配置：

make db-list
make db-verify [email protected]

JDBC Agent 驱动开发项目位于 agents/：

cd agents
./gradlew test

如果本地驱动安装流程需要，便会从 agents/drivers/<db-type>/build/libs/ 获取构建产物。

构建

make package

安装程序位于 src-tauri/target/release/bundle/。

技术栈

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

文档

• 官方文档 — 功能指南和教程
• 插件开发 — 创建插件，并将 Marketplace 列表提交到正确的代码仓库
• 数据库测试实验室 — 用于开发和验证的本地数据库配置
• 贡献指南 — 如何认领问题并提交 PR
• Web API 参考 — 面向 Docker/Web 部署的 HTTP API
• 示例 — CLI、MCP、Docker 和 API 示例

支持 DBX

DBX 免费且开源，但持续维护、数据库兼容性测试、基础设施和版本发布工作都需要长期投入时间和资源。

• 支持 DBX — 通过微信或支付宝自愿捐赠
• 赞助方与合作伙伴 — 赞助、基础设施、工具和社区协作

贡献者

## Community

Star History

License

Apache-2.0