database.build（前身为 postgres.new）(#为什么重命名postgresnew)

带有 AI 辅助的浏览器内 Postgres 沙盒。

借助 database.build，您可以立即启动无限数量的 Postgres 数据库，这些数据库直接在您的浏览器中运行（不久还将支持部署到 S3）。

每个数据库都配有一个大型语言模型 (LLM)，这为一些有趣的用例打开了大门：

• 拖放式 CSV 导入（即时生成表）
• 生成并导出报表
• 生成图表
• 构建数据库关系图

工作原理

database.build 中的所有查询都直接在您的浏览器中执行。没有远程的 Postgres 容器或 WebSocket 代理。

这是如何实现的呢？通过 PGlite——一个可以在浏览器中直接运行的 WASM 版本的 Postgres。您创建的每一个数据库都会启动一个新的 PGlite 实例，该实例暴露了一个功能齐全的 Postgres 数据库。数据存储在 IndexedDB 中，因此即使刷新页面，更改也会保留。

单体仓库

这是一个单体仓库，拆分为以下项目：

• Web：使用 Next.js 构建的主要 Web 应用程序
• 浏览器代理：使用 pg-gateway 和 WebSockets 将 Postgres TCP 连接代理回浏览器
• 部署 Worker：将浏览器内的数据库部署到数据库平台（目前支持 Supabase）

设置

从单体仓库根目录开始：

1. 安装依赖项

   npm i
   

2. 启动本地 Supabase 堆栈：

   npx supabase start
   

3. 将本地 Supabase URL/匿名密钥存储到 ./apps/web/.env.local 中：

   npx supabase status -o env \
     --override-name api.url=NEXT_PUBLIC_SUPABASE_URL \
     --override-name auth.anon_key=NEXT_PUBLIC_SUPABASE_ANON_KEY |
       grep NEXT_PUBLIC >> ./apps/web/.env.local
   

4. 创建一个 OpenAI API 密钥，并保存到 ./apps/web/.env.local 中：

   echo 'OPENAI_API_KEY="<openai-api-key>"' >> ./apps/web/.env.local
   

5. 存储本地 KV（Redis）变量。请使用以下确切值：

   echo 'KV_REST_API_URL="http://localhost:8080"' >> ./apps/web/.env.local
   echo 'KV_REST_API_TOKEN="local_token"' >> ./apps/web/.env.local
   

6. 启动本地 Redis 容器（用于限流）。它在端口 8080 上提供 API：

   docker compose -f ./apps/web/docker-compose.yml up -d
   

7. 根据以下文件填写各个应用的剩余变量：

   • ./apps/web/.env.example
   • ./apps/browser-proxy/.env.example
   • ./apps/deploy-worker/.env.example

开发

从单体仓库根目录开始：

npm run dev

重要提示： 此命令底层使用了 turbo，它可以理解单体仓库中各依赖项之间的关系，并自动相应地构建它们（即 ./packages/*）。如果您绕过 turbo，则需要在每个 ./app/* 使用之前手动构建每个 ./packages/*。

为什么要把 postgres.new 重命名为 database.build？

该项目并非官方的 Postgres 项目，我们也不希望误导任何人！我们将更名为 database.build，因为这就是它的用途。它仍将 100% 专注于 Postgres，只是 URL 不同而已。

视频

许可证

Apache 2.0

database.build 快速上手指南

database.build 是一个基于浏览器的 Postgres 沙盒环境，集成了 AI 辅助功能。它利用 PGlite（Postgres 的 WASM 版本）直接在浏览器中运行完整的 Postgres 实例，数据持久化存储在 IndexedDB 中，无需远程容器或 WebSocket 代理。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS 或 Linux
• Node.js：建议安装 LTS 版本 (v18+)
• Docker & Docker Compose：用于运行本地 Supabase 栈和 Redis 容器
• Supabase CLI：用于管理本地数据库服务
• OpenAI API Key：用于启用 AI 辅助功能（如生成图表、报告等）

安装步骤

本项目采用 Monorepo 结构，请在项目根目录下执行以下操作：

1. 安装依赖

   npm i
   

2. 启动本地 Supabase 服务

   npx supabase start
   

3. 配置 Supabase 环境变量 将本地 Supabase 的 URL 和匿名密钥写入 ./apps/web/.env.local：

   npx supabase status -o env \
     --override-name api.url=NEXT_PUBLIC_SUPABASE_URL \
     --override-name auth.anon_key=NEXT_PUBLIC_SUPABASE_ANON_KEY |
       grep NEXT_PUBLIC >> ./apps/web/.env.local
   

4. 配置 OpenAI API Key 替换 <openai-api-key> 为您的实际密钥：

   echo 'OPENAI_API_KEY="<openai-api-key>"' >> ./apps/web/.env.local
   

5. 配置本地 KV (Redis) 变量 使用以下固定值进行配置：

   echo 'KV_REST_API_URL="http://localhost:8080"' >> ./apps/web/.env.local
   echo 'KV_REST_API_TOKEN="local_token"' >> ./apps/web/.env.local
   

6. 启动本地 Redis 容器 用于速率限制，服务将监听 8080 端口：

   docker compose -f ./apps/web/docker-compose.yml up -d
   

7. 完善其他配置 检查并填写以下文件中剩余的环境变量（参考对应的 .env.example）：

   • ./apps/web/.env.local
   • ./apps/browser-proxy/.env.local
   • ./apps/deploy-worker/.env.local

基本使用

完成上述配置后，即可启动开发服务器。

1. 启动开发环境 在项目根目录运行：

   npm run dev
   

   注意：该命令底层使用 turbo 构建工具，它会自动处理 Monorepo 中各包（./packages/*）之间的依赖关系和构建顺序。请勿跳过此命令直接构建子应用，否则可能导致依赖缺失。

2. 访问应用 启动成功后，通常在浏览器访问 http://localhost:3000（具体端口视终端输出而定）。

3. 核心功能体验

   • 创建数据库：页面加载后会自动在浏览器内初始化一个全新的 Postgres 实例。
   • 导入数据：尝试拖拽 CSV 文件到界面，系统将自动建表并导入数据。
   • AI 交互：利用集成的 LLM 生成 SQL 查询、导出数据报告、绘制图表或生成数据库架构图。