Whodb

WhoDB 为你提供一个统一空间，用于浏览数据库、编辑数据、运行查询，并了解架构如何组织在一起。它在浏览器中运行，易于自托管，也提供桌面应用和终端命令行版本。

你可以用它检查本地数据库、帮助队友探索陌生数据，或在不安装笨重数据库客户端的情况下开展工作。AI 功能为可选项：如果你想用日常语言提问，可以连接 Ollama、OpenAI、Anthropic、LM Studio 或其他兼容 OpenAI 的提供商。

快速开始

使用 Docker 运行 WhoDB：

docker run --rm -it -p 8080:8080 clidey/whodb

然后打开 http://localhost:8080，并输入数据库连接详细信息。

想先看看吗？试试在线演示或观看视频演示。

你可以做什么

• 浏览和编辑数据：在类似电子表格的网格中排序、筛选、分页和直接编辑。
• 直观了解架构：通过交互式图表查看表和关系。
• 在草稿区中处理查询：使用多个单元格、自动补全和历史记录，并将结果与对应查询放在一起。
• 导入和导出数据：通过导入、导出和生成模拟数据，满足开发和测试需求。
• 用自然语言提问：使用你选择的本地或托管 AI 提供商。
• 在终端中工作：使用 WhoDB CLI 及其 MCP 服务。

浏览、筛选和编辑数据	通过架构图查看关系

支持的数据库

WhoDB Community 支持：

• PostgreSQL、CockroachDB、YugabyteDB 和 QuestDB
• MySQL、MariaDB 和 TiDB
• SQLite 和 DuckDB
• MongoDB 和 FerretDB
• Redis、Valkey 和 Dragonfly
• Elasticsearch 和 OpenSearch
• ClickHouse 和 Memcached

不同数据库的支持情况有所差异，因为并非所有系统都具备相同的概念或功能。连接页面会显示每种数据源可用的选项。

安装选项

使用 Docker 并保留会话

单行 Docker 命令适合用于试用 WhoDB。若要在容器替换后保留加密的登录会话，请先生成密钥并将其保存在安全的位置：

openssl rand -hex 32

然后挂载 /data，并在每次启动容器时重复使用该密钥：

docker run -it -p 8080:8080 \
  -v whodb-data:/data \
  -e WHODB_ENCRYPTION_KEY=your_saved_64_character_hex_key \
  clidey/whodb

请妥善保管该密钥。更换密钥会使现有会话失效。如果 WhoDB 通过 HTTPS 反向代理提供服务，还请设置 WHODB_SECURE=true，确保浏览器仅通过 HTTPS 发送会话 Cookie。

如需了解 Docker Compose、连接配置文件、SSL、AI 提供商和其他配置选项，请参阅文档。

桌面版

• macOS
• Windows
• Snap

CLI 和 MCP 服务

CLI 包含交互式终端 UI，以及供 AI 工具使用的 MCP 服务：

# macOS and Linux
curl -fsSL https://raw.githubusercontent.com/clidey/whodb/main/cli/install/install.sh | bash

# or install with npm
npm install -g @clidey/whodb

whodb             # open the terminal UI
whodb mcp serve   # start the MCP server

有关连接示例和完整命令参考，请参阅 CLI 指南。

AI 提供商

你可以直接在 WhoDB 中添加托管 AI 提供商，无需配置后端或重启。打开 Chat，从提供商菜单中选择 添加提供商，然后选择 OpenAI、Anthropic 或 Gemini 并输入 API 密钥。WhoDB 会从该提供商获取可用模型。

Ollama 和 LM Studio 可作为 WhoDB Community 中的本地选项使用。默认情况下，后端会在 localhost:11434 查找 Ollama，在 localhost:1234/v1 查找 LM Studio，并自动调整 Docker 和 WSL 的本地地址。仅当这些默认值不适用于你的设置时，才使用 WHODB_OLLAMA_HOST、WHODB_OLLAMA_PORT 或 WHODB_LMSTUDIO_BASE_URL。

可选的后端提供方配置

环境变量允许部署管理员在服务启动时声明提供方。这适用于预先配置 OpenAI 或 Anthropic、更改提供方端点，或为使用该部署的所有人添加 OpenAI 兼容服务：

• WHODB_OPENAI_* 用于 OpenAI
• WHODB_ANTHROPIC_* 用于 Anthropic
• WHODB_OLLAMA_* 用于 Ollama 连接设置
• WHODB_LMSTUDIO_* 用于 LM Studio 连接设置
• WHODB_AI_GENERIC_<ID>_* 用于 OpenAI 兼容提供方

完整的环境变量列表请参阅安装指南，设置示例请参阅 AI 提供方指南。

WhoDB Community 和 WhoDB Platform

此代码仓库包含 WhoDB Community，即上文介绍的采用 Apache-2.0 许可的数据库工作空间。它可免费自托管；如果你想探索和使用数据库，这是最好的起点。

WhoDB Platform 是面向需要共享项目、更多数据源、SSO、精细访问控制、审计日志、流水线、报告和内部应用的组织推出的商业版可自托管产品。你可以阅读 WhoDB 概览，或在定价页面比较各个方案。

开发

WhoDB 包含 Go 后端和 React/TypeScript 前端。本地开发时，请在不同的终端中分别运行它们。

要求：

• Go
• Node.js 和 pnpm

启动后端：

cd core
go run ./cmd/whodb

启动前端：

cd frontend
pnpm install
pnpm start

前端会在 http://localhost:3000 打开，并连接到 8080 端口上的后端。生成和构建命令请参阅 CE 构建与运行指南。

贡献

欢迎提交错误报告、功能创意、文档改进和代码贡献。

• 遇到错误或有具体需求，请提交 issue。
• 有问题或想法，请发起讨论。
• 提交 pull request 前，请阅读 CONTRIBUTING.md。

更多截图

查看 WhoDB 的实际效果

查询草稿区

添加和编辑记录

以可视化方式构建筛选条件

导出数据

支持

• 文档
• GitHub Issues
• [email protected]

WhoDB 采用 Apache License 2.0 许可。