drawDB 数据库图表编辑器

它是什么

drawDB 是一个在浏览器里运行的数据库图表编辑器，由 drawdb-io 制作。你添加表和字段，用关系把它们连起来，再导出 SQL。README 把它称作免费、简单、直观的数据库结构（schema）编辑器和 SQL 生成器。不用账号就能使用。

1. 选一种数据库类型，或选 Generic 画一张可移植的图
2. 添加表和字段，或导入 SQL、DBML、JSON
3. 从外键字段拖到它引用的字段
4. 用主题区域给表分组，再加备注
5. 导出 SQL、图片、DBML、Mermaid 或 Markdown

适合谁

想在动手建库前先画出草图或写好文档的开发者、学生和团队，或者想把一份旧的数据库结构看成一张图的人。你可以导入现有的 SQL，把其中的表和关系看成图表。托管编辑器的核心建模不需要账号，你也可以选择自己运行一份。

如果你需要一个能读取运行中数据库的工具，就不要选它。文档列出的导入只有 SQL 脚本、JSON、DDB 和 DBML 文件，没有实时连接。

用在哪里

你可以用托管编辑器，运行自己的一份，或者把 MCP 服务器接到 AI 工具上。文档列出七种数据库类型，其中 Oracle SQL 仍是测试版。

• 托管编辑器：在你的浏览器里打开 drawdb.app/editor，核心建模不需要账号
• 自己的一份：README 给出了开发服务器、生产构建和 Docker 镜像
• 分享：一个可选的 drawdb-server，用来让你的副本能分享图表
• AI 工具：@drawdb/mcp 服务器，让 Claude Desktop、Cursor、Cline、Goose 或 Windsurf 读取你在 drawDB Pro 里的云端图表
• drawDB Pro（付费方案）：Pro Solo 和 Pro Team 都有云端图表、AI 助手、API 密钥和 MCP，团队工作区和实时协作只有 Pro Team 有

如何设置

点“获取”会把一个装有 Mindket 安装说明的 zip 压缩包存进你的下载文件夹，里面有 drawDB 的 README 和文档里的步骤。最快的办法是用托管编辑器，不用安装。要从源码运行自己的一份，你需要 Git 和带 npm 的 Node.js。走 Docker 的路线改用 Docker，用预构建镜像连仓库都不用克隆。

1. 克隆仓库，进入它的文件夹。
2. 运行 npm install。
3. 运行 npm run dev 启动编辑器。

git clone https://github.com/drawdb-io/drawdb
cd drawdb
npm install
npm run dev

走 Docker 的话，README 给出了在克隆目录里运行的两行命令。-p 3000:80 把你电脑上的 3000 端口映射到容器的 80 端口。

docker build -t drawdb .
docker run -p 3000:80 drawdb

如果你运行可选的 drawdb-server 来做分享，就把它的地址传给预构建镜像。README 说不用重新构建。

docker run -p 3000:80 -e VITE_BACKEND_URL=https://your-drawdb-server.example.com ghcr.io/drawdb-io/drawdb:latest

如何使用

打开编辑器，选 File，再选 New，挑一张空白图或一个模板。先选数据库类型，因为它决定你能看到哪些字段类型和功能。

1. 从侧边栏或工具栏添加一张表，定义它的字段。
2. 从外键字段上的蓝色连接点拖到它引用的字段。
3. 打开 Relationships 标签页，可以重命名关系、交换两端或设置字段对。ON DELETE 和 ON UPDATE 各有这几个选项：no action、restrict、cascade、set null、set default。
4. 用主题区域给表分组，再加备注。
5. 按 Ctrl/Cmd + I，从 SQL、DBML 或 JSON 开始。

Ctrl/Cmd + S 保存，Ctrl/Cmd + Z 撤销，Alt + E 打开 DBML 编辑器，Ctrl/Cmd + Alt + W 把图缩放到窗口大小。

给 AI 工具用的话，把下面这段加进它的本地 MCP 服务器设置，把占位符换成你自己的 API 密钥。它需要 drawDB Pro。

{
  "mcpServers": {
    "drawdb": {
      "command": "npx",
      "args": ["-y", "@drawdb/mcp"],
      "env": {
        "DRAWDB_API_KEY": "ddb_your_key_here"
      }
    }
  }
}

示例

你想做一个小型博客的数据库结构。你打开编辑器，选 File，再选 New，挑一张空白的 PostgreSQL 图。你加上 users 表和 posts 表，给 posts 加一个 user_id 字段，然后从 user_id 上的蓝色连接点拖到 users.id。

文档用的也是这一对表做例子。drawDB 会根据主键和唯一约束推断基数，你之后还可以调整。导出时，SQL 由 PostgreSQL 的生成器产生。

有了 drawDB Pro，AI 工具还能通过 MCP 服务器读取云端图表。你这样问：

List my drawDB diagrams, then summarize the schema of the diagram named “Orders”.

文档说智能体会先调用 list_diagrams，再用拿到的图表 ID 去调用其他工具。

新手与专家

新手：数据库结构（schema）就是一个数据库里的表，以及它们之间怎么相连。实体关系图用方框和线把它画出来。主键标识一行，外键指向另一张表里的一行。先在托管编辑器里试，还没选好数据库的话就选 Generic。复制（fork）六个内置模板中的一个，看看一张画好的图是什么样。清空浏览器数据之前先导出图表，因为开源编辑器只把它们存在浏览器里。

专家：开源编辑器是一个用 Vite 构建的 React 应用。编辑器状态放在 React Context 提供者里，没有 Redux 或 Zustand。画布是一张由指针事件驱动的 SVG。表通过 foreignObject 元素绘制，关系是根据字段位置算出来的 SVG 路径。

图表和自定义模板通过 Dexie 存进 IndexedDB，偏好设置和自定义数据类型别名存进 local storage。SQL 先解析成抽象语法树，再在方言提供足够信息的地方转换成表、字段、索引、枚举、类型和关系。检查约束会原样插进生成的 SQL，所以要用目标数据库的语法来写。PostgreSQL 图表还支持表继承、数组维度和枚举。PostgreSQL 和 Generic 图表都有 Types 标签页，用来定义复合类型。

加一种新语言要四步：以 src/i18n/locales/en.js 为底本新建一个翻译好的语言文件，在 src/i18n/i18n.js 里导入，把它加进语言列表，再注册到 i18next 的 resources 映射里。

注意事项

drawDB 在你的浏览器里运行，它有几个部分会连到浏览器之外。

• 许可证：AGPL-3.0。第 13 条说，如果你修改了这个程序，你的版本必须向每一位通过网络与它交互的用户提供源码。要把改过的副本托管给别人用之前，先读一遍 LICENSE 文件
• 你的作品存在哪：开源编辑器把图表和模板存在浏览器的 IndexedDB 里。设置里有 Export saved data，Flush storage 会永久删除本地图表
• 分享：文档说 Share 会发布一个私有的 GitHub Gist。如果是你自己运行的副本，README 说要启用分享得搭 drawdb-server。私有不等于加密，拿到链接的人可能都能读到。不要把机密放进分享的图表
• drawDB Pro：付费方案（网站的常见问题里写着“drawDB Pro adds paid plans”，意思是 drawDB Pro 增加了付费方案）。文档列出 Pro Solo 和 Pro Team 两种。两者都有云端图表、AI 结构助手、版本历史、API 密钥和 MCP。团队工作区、按图表设置的权限和实时协作只有 Pro Team 有。文档说方案的提供情况和价格可能变
• 托管网站：drawDB 的隐私政策列出它会收集产品事件、存在 local storage 里的设备标识、你的 IP 地址和浏览器信息，配置了的话还会用 Amplitude 和 Sentry 做分析和错误监控。你用 AI 助手时，你的提示词和图表上下文会发给 Anthropic。这份政策不涵盖你自己托管的副本
• MCP：它是只读的，用你的 API 密钥在你的电脑上运行。这个密钥可以列出你所在各个团队里的图表名称，并读取密钥主人有权打开的 schema，所以要像对待密码一样对待它。目前不支持纯网页客户端
• 缺口：README 没给更新步骤，也没写 Node.js 版本，文档里也没有 Claude Code、Codex 或 Gemini CLI 的步骤
• 移除：README 和文档没有给出移除步骤。删除克隆下来的文件夹。在设置里先用 Export saved data 导出，再用 Flush storage 清掉存在浏览器里的图表。如果你配过 MCP，就删掉它的 API 密钥（在密钥的操作菜单里选 Delete）