# QoreDB

**Repository Path**: gooree/QoreDB

## Basic Information

- **Project Name**: QoreDB
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-12
- **Last Updated**: 2026-05-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
  <img src="public/logo.png" alt="QoreDB 标志" width="120" />

# QoreDB

**一个应用，管理所有数据库。**

使用 Rust 构建的快速、开源数据库客户端。通过统一、美观的界面连接到 **12 种原生驱动**。本地优先：数据归您所有。

[![许可证](https://img.shields.io/badge/license-Apache--2.0%20%2F%20BUSL--1.1-blue?style=flat-square)](LICENSE)
[![版本](https://img.shields.io/github/v/release/raphplt/QoreDB?style=flat-square&color=8b5cf6)](https://github.com/raphplt/QoreDB/releases)
[![下载量](https://img.shields.io/github/downloads/raphplt/QoreDB/total?style=flat-square&color=10b981)](https://github.com/raphplt/QoreDB/releases)
[![星标](https://img.shields.io/github/stars/raphplt/QoreDB?style=flat-square&color=facc15)](https://github.com/raphplt/QoreDB/stargazers)
[![问题](https://img.shields.io/github/issues/raphplt/QoreDB?style=flat-square)](https://github.com/raphplt/QoreDB/issues)
[![平台](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey?style=flat-square)](#安装)

[**官网**](https://qoredb.com) · [**下载**](https://qoredb.com/download) · [**文档**](https://qoredb.com/docs) · [**路线图**](https://qoredb.com/roadmap) · [**Discord**](https://discord.gg/Yr6P3wuZDt)

  <img src="docs/screenshots/query-screen.png" alt="QoreDB SQL 编辑器和结果网格" width="100%" />

</div>

---

## 为什么选择 QoreDB？

DBeaver、pgAdmin、phpMyAdmin 能完成工作 —— 但它们感觉缓慢、过时，充满了来自另一个时代的对话框。QoreDB 是我们希望存在的工具：一个你每天早上真正喜欢打开的工具。

| | |
|---|---|
| ⚡ **原生性能** | Rust + Tauri。无 Electron 负担 —— 小巧的二进制文件、即时启动、低内存占用。在真实工作负载下比之前的基准快约 25%（Apple Silicon）。 |
| 🔒 **本地优先且安全** | 凭证存储在您的操作系统钥匙串中（Argon2）。开发/预发布/生产环境防护、危险查询检测、只读模式。默认情况下，任何数据都不会离开您的机器。 |
| 🧩 **SQL + NoSQL，统一界面** | 一个 UI 管理 PostgreSQL、MySQL、SQL Server、SQLite、DuckDB、CockroachDB、MongoDB 和 Redis ——  plus 对 Supabase、Neon 和 TimescaleDB 的一流支持。 |
| 📓 **内置笔记本** | 可执行的 SQL/Mongo + Markdown 文档，支持参数、图表和 Git 可差异化的 `.qnb` 文件。 |
| 🛡️ **安全优先** | 通用查询拦截器、审计日志、带迁移生成的沙箱模式。更难意外损坏生产环境数据。 |
| 🤝 **开放核心** | Apache 2.0 核心，可读且可审计。BUSL-1.1 下的高级附加功能 —— 绝不以牺牲开源体验为代价。 |

---

## 支持的数据库

<div align="center">
  <img src="public/databases/postgresql.png" alt="PostgreSQL" height="40" />&nbsp;&nbsp;
  <img src="public/databases/mysql.png" alt="MySQL" height="40" />&nbsp;&nbsp;
  <img src="public/databases/mariadb.png" alt="MariaDB" height="40" />&nbsp;&nbsp;
  <img src="public/databases/sqlserver.png" alt="SQL Server" height="40" />&nbsp;&nbsp;
  <img src="public/databases/sqlite.png" alt="SQLite" height="40" />&nbsp;&nbsp;
  <img src="public/databases/duckdb.png" alt="DuckDB" height="40" />&nbsp;&nbsp;
  <img src="public/databases/cockroachdb.png" alt="CockroachDB" height="40" />&nbsp;&nbsp;
  <img src="public/databases/mongodb.png" alt="MongoDB" height="40" />&nbsp;&nbsp;
  <img src="public/databases/redis.png" alt="Redis" height="40" />&nbsp;&nbsp;
  <img src="public/databases/supabase.png" alt="Supabase" height="40" />&nbsp;&nbsp;
  <img src="public/databases/neon.png" alt="Neon" height="40" />&nbsp;&nbsp;
  <img src="public/databases/timescaledb.png" alt="TimescaleDB" height="40" />
</div>

<div align="center">
  <sub>从 DSN 自动检测驱动 —— 粘贴连接字符串，QoreDB 会选择正确的驱动。</sub>
</div>

---

## 截图

<table>
  <tr>
    <td width="50%"><img src="docs/screenshots/database-screen.png" alt="数据库浏览器" /><br/><sub><b>数据库浏览器</b> — 多连接侧边栏、表预览、面包屑导航。</sub></td>
    <td width="50%"><img src="docs/screenshots/query-screen.png" alt="SQL 编辑器" /><br/><sub><b>SQL 编辑器</b> — 自动补全、格式化、多语句执行、虚拟化结果网格。</sub></td>
  </tr>
  <tr>
    <td width="50%"><img src="docs/screenshots/er-diagram-screen.png" alt="ER 图" /><br/><sub><b>ER 图</b> — 交互式模式图，支持隔离/聚焦工作流。</sub></td>
    <td width="50%"><img src="docs/screenshots/table-screen.png" alt="数据网格" /><br/><sub><b>数据网格</b> — 虚拟化、列固定、高级筛选、内联编辑。</sub></td>
  </tr>
</table>

---

## 功能

<details open>
<summary><b>查询和模式</b></summary>

- **SQL 编辑器** — 语法高亮、格式化、代码片段、多语句执行
- **MongoDB 编辑器** — 自动补全（集合、方法、操作符）、实时 JSON 检查器、聚合管道验证（含阶段分类和示例）
- **QoreQuery** — 类型安全的多方言查询构建器（JOIN、子查询、聚合、CAST、COALESCE、LIKE/ILIKE），支持 PostgreSQL、MySQL、SQLite、DuckDB 和 SQL Server
- **查询库** — 文件夹、标签、JSON 导入/导出、可复用查询
- **ER 图** — 交互式模式图，支持隔离/聚焦工作流 _[专业版]_
- **可视化 DDL 编辑器** — 从 UI 完整创建和修改表：列、外键、索引、检查约束，带实时驱动特定 SQL 预览
- **执行计划可视化** — 交互式执行计划树，带成本高亮（PostgreSQL、MySQL、SQL Server）
- **可视化数据差异** — 表/查询结果的并排比较 _[专业版]_
- **全局全文搜索** — 在所有表和列中搜索值
- **外键查看 + 虚拟关系** — 即使没有原生 FK 约束也可导航
- **存储过程、触发器、函数、事件** — 使用 SQL 模板列出、创建和编辑存储对象
</details>

<details>
<summary><b>数据操作</b></summary>

- **高性能数据网格** — 虚拟化、服务器端筛选/排序、分页、无限滚动、列固定
- **高级列筛选** — 跨所有驱动支持 `包含`、`正则`、`大于`、`介于` 等
- **内联编辑** — 直接在 SQL 和 NoSQL 数据集中编辑行
- **批量编辑** — 从网格进行多行列更新，带实时 SQL 预览（核心版 ≤ 5 行，专业版更多）
- **时间旅行** — 使用可视化时间线浏览任何行的历史，比较两个时间点之间的差异，在回滚前预览回滚 SQL _[专业版]_
- **Blob/二进制查看器** — 十六进制 / base64 / 图像预览（PNG、JPEG、GIF、SVG、BMP、ICO），支持复制为数据 URI
- **CSV 导入** — 自动分隔符/编码检测、列映射、导入前预览
- **事务管理** — 切换自动提交、显式提交/回滚、活动事务指示器
- **导出管道** — CSV、JSON、SQL、HTML、独立 HTML（专业版还有 XLSX/Parquet）
- **跨数据库联邦** — 通过 DuckDB 查询和连接活动连接
- **沙箱模式** — 隔离的本地更改，带迁移生成
</details>

<details>
<summary><b>笔记本</b></summary>

- 可执行的文档，混合 SQL/Mongo 和 Markdown 单元格，连接到实时数据库
- 参数化变量（`$customer_id`、`{{date_from}}`），带类型化输入
- 全部运行 / 从此处运行，支持遇错停止
- 单元格间引用和图表单元格（柱状图、折线图、饼图、散点图）_[专业版]_
- 从 `.sql` / `.md` 导入，导出为 Markdown 或独立 HTML
- `.qnb` 文件格式，Git 可差异化
</details>

<details>
<summary><b>MongoDB 和 Redis</b></summary>

- **MongoDB** — 批量写入/查找、聚合管道验证、正则和文本搜索、原生索引管理 UI
- **Redis** — 从 UI 跨所有 Redis 类型创建、编辑和删除键和值，支持 Lua 脚本评估
</details>

<details>
<summary><b>安全和可靠性</b></summary>

- **安全保险库** — 原生操作系统钥匙串存储（Argon2）+ 可选应用锁定
- **SSH 隧道** — 原生 OpenSSH 客户端，支持代理跳转
- **SQL Server Windows 身份验证** — NTLM（用户名/密码）和 SSPI/Kerberos（集成，无凭证）
- **环境安全** — 开发/预发布/生产环境防护、危险查询检测、只读模式
- **通用查询拦截器** — 用于安全、审计和性能分析的中心钩子
- **审计日志** — 日志中的敏感内容编辑
- **连接弹性** — 自动重新连接、健康检查、智能保活
- **后台作业管理器** — 长时间运行任务的异步执行，带错误恢复
</details>

<details>
<summary><b>用户体验</b></summary>

- **工作区** — 按项目分组连接、查询、笔记本和历史记录
- **多标签页工作区** — 拖放重新排序、固定标签页、跨连接切换的持久化上下文
- **标签页组** — 按连接分组的标签页，可折叠，每个标签页的上下文菜单
- **会话恢复** — 应用重启时标签页及其状态持久化
- **全局搜索** — `Cmd/Ctrl + K` 跨连接、历史记录、命令、库
- **面包屑导航** — `连接 > 数据库 > 模式 > 表` 可点击路径
- **深色 / 浅色主题**
- **9 种语言** — 英语、法语、西班牙语、德语、葡萄牙语（巴西）、俄语、日语、韩语、简体中文
</details>

<details>
<summary><b>AI 助手 <i>[专业版]</i></b></summary>

- 上下文查询生成和错误纠正
- 模式感知建议
- 自带密钥（OpenAI、Anthropic 等）
</details>

<details>
<summary><b>性能</b></summary>

- 在真实工作负载下快约 25%（Apple Silicon），得益于每列解码器、Rust 和前端之间的 MessagePack 流式传输、批量流式传输、扩展的 LRU 缓存、`mimalloc` 分配器和 PGO 发布构建
- 延迟加载 — 重型前端模块按需加载，加快启动速度
</details>

---

## QoreDB 对比

| | **QoreDB** | DBeaver | TablePlus | pgAdmin |
|---|---|---|---|---|
| 开源核心 | ✅ Apache 2.0 | ⚪ 社区版 | ❌ 否 | ✅ 是 |
| 多数据库（SQL + NoSQL） | ✅ 12 种驱动 | ✅ 是 | ⚪ 有限 | ❌ 仅 PG |
| 原生性能 | ✅ Rust/Tauri | ❌ Java/Swing | ✅ 原生 | ❌ 基于 Web |
| 本地优先 / 无云 | ✅ 是 | ✅ 是 | ✅ 是 | ✅ 是 |
| 加密凭证保险库 | ✅ Argon2 | ⚪ 基础 | ✅ 钥匙串 | ❌ 否 |
| 生产安全防护 | ✅ 是 | ❌ 否 | ⚪ 部分 | ❌ 否 |
| 沙箱模式 + 迁移 | ✅ 专业版 | ❌ 否 | ❌ 否 | ❌ 否 |
| 全文搜索（所有表） | ✅ 是 | ❌ 否 | ❌ 否 | ❌ 否 |
| 交互式 ER 图 | ✅ 是 | ✅ 是 | ❌ 否 | ⚪ 部分 |
| 跨数据库联邦 | ✅ 专业版 | ❌ 否 | ❌ 否 | ❌ 否 |
| AI 查询助手 | ✅ BYOK | ❌ 否 | ❌ 否 | ❌ 否 |
| 现代、快速 UI | ✅ 是 | ❌ 过时 | ✅ 是 | ❌ 否 |
| 成熟度 / 生态系统 | ⚪ 新兴 | ✅ 15+ 年 | ⚪ 成熟 | ✅ 20+ 年 |
| 价格（个人使用） | **免费 / 专业版** | 免费 / $199 | $89 | 免费 |

我们很年轻，但发展很快 —— 查看[公开路线图](https://qoredb.com/roadmap)。

---

## 安装

### 下载

从[发布页面](https://github.com/raphplt/QoreDB/releases)或 [qoredb.com/download](https://qoredb.com/download)获取适用于您平台的最新版本。

| 平台 | 格式 |
|---|---|
| **macOS** | `.dmg`（Apple Silicon 和 Intel） |
| **Windows** | `.msi` / `.exe` |
| **Linux** | `.deb` / `.AppImage` |

### Arch Linux (AUR)

```bash
yay -S qoredb-bin
```

### 从源码构建

**前置条件：** Node.js 18+、pnpm、Rust 1.70+、[Tauri 系统依赖](https://tauri.app/start/prerequisites/)。

```bash
git clone https://github.com/raphplt/QoreDB.git
cd QoreDB
pnpm install
pnpm tauri dev      # 开发模式
pnpm tauri build    # 生产构建
```

<details>
<summary>Ubuntu / Debian 系统包</summary>

```bash
sudo apt-get update
sudo apt-get install -y \
  pkg-config \
  libglib2.0-dev \
  libgtk-3-dev \
  libwebkit2gtk-4.1-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev
```
</details>

---

## 快速开始

1. **启动 QoreDB**
2. **添加连接** — 点击侧边栏中的 `+`，或粘贴 DSN
3. **连接** — 在侧边栏中选择连接
4. **探索** — 浏览数据库、表，运行查询或打开笔记本

### 键盘快捷键

| 快捷键 | 操作 |
|---|---|
| `Cmd/Ctrl + K` | 全局搜索 |
| `Cmd/Ctrl + N` | 新查询标签页 |
| `Cmd/Ctrl + W` | 关闭当前标签页 |
| `Cmd/Ctrl + Enter` | 执行查询 |
| `Cmd/Ctrl + S` | 保存 |
| `Cmd/Ctrl + ,` | 设置 |

---

## 开发

**前端：** React 19 · TypeScript 5.9 · Vite 8 · Tailwind CSS 4 · Radix UI · CodeMirror 6 · TanStack Table · i18next
**后端：** Rust 2021 · Tauri 2.10 · Tokio · SQLx (PostgreSQL, MySQL, SQLite) · Tiberius + bb8 (SQL Server) · MongoDB 和 Redis 原生驱动 · DuckDB（嵌入式分析 + 联邦）

```bash
pnpm tauri dev              # 开发模式运行应用（热重载）
pnpm tauri build            # 构建生产应用
pnpm lint:fix               # 代码检查 + 自动修复
pnpm format:write           # 格式化代码
pnpm test                   # 运行 Rust 测试
docker-compose up -d        # 启动开发数据库
```

有关项目结构、架构说明和贡献工作流，请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 和 [`doc/`](doc/)。

---

## 路线图和社区

- 🗺️ [公开路线图](https://qoredb.com/roadmap) — 已发布的功能，接下来的计划
- 📝 [更新日志](https://github.com/raphplt/QoreDB/releases) — GitHub 上的发布说明
- 💬 [Discord](https://discord.gg/Yr6P3wuZDt) — 获取帮助、分享反馈
- 🐛 [问题](https://github.com/raphplt/QoreDB/issues) — 报告错误或请求功能
- 💼 [LinkedIn](https://www.linkedin.com/company/qoredb/) — 关注项目更新

---

## 贡献

欢迎贡献！在打开 PR 之前，请阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。简而言之：

1. Fork 仓库并创建功能分支
2. 在推送前运行 `pnpm lint:fix` 和 `pnpm test`
3. 为新文件添加 SPDX 许可证头（`Apache-2.0` 用于核心，`BUSL-1.1` 用于专业版）
4. 打开 PR —— 我们将审查、建议更改并发布

安全问题应私下报告 —— 请参阅 [SECURITY.md](SECURITY.md)。

---

## 许可证

QoreDB 是**开放核心**：

- 核心文件 — [Apache 2.0](LICENSE)
- 专业版文件（ER 图、数据差异、性能分析、时间旅行等）— [Business Source License 1.1](LICENSE-BSL)

边界在 [`CLAUDE.md`](CLAUDE.md) 中记录，并通过每个源文件中的 SPDX 头注释标识。

---

## 致谢

站在巨人的肩膀上构建：
[Tauri](https://tauri.app/) ·
[CodeMirror](https://codemirror.net/) ·
[Radix UI](https://www.radix-ui.com/) ·
[Tailwind CSS](https://tailwindcss.com/) ·
[SQLx](https://github.com/launchbadge/sqlx) ·
[DuckDB](https://duckdb.org/) ·
[TanStack Table](https://tanstack.com/table) ·
[i18next](https://www.i18next.com/)