SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场neon

neon

通用与其它

查看项目

更新于 10-14 22:04

技能介绍

用途

Neon 是 Databricks 提供的一整套围绕 Lakebase Postgres 的云后端原语。它面向构建应用与智能体的场景，把数据库、认证、对象存储、无服务器函数和 AI 模型网关组合在一起，并让这些资源可以分支（branch）。Neon 本身不托管前端，需与 Vercel、Netlify、Cloudflare 等应用平台组合使用。

需要说明的是：Lakebase Postgres 是数据库本身，它是一个产品，有两种访问路径——通过 Neon（含免费方案及上述后端原语），或通过 Databricks。文档建议称数据库为 Lakebase Postgres，而用 “Neon” 指代品牌及这种访问路径。

主要能力

  • Lakebase Postgres：基于 lakebase 架构的 Postgres，直接在云对象存储上运行 OLTP，存储与计算解耦；可随应用扩展与分支。
  • 分支（Branch）：分支是数据的隔离写时复制（copy-on-write）克隆，可取自当前状态，也可取自项目保留历史窗口内的过去状态。可自由修改或删除；在写入导致分歧前与父分支共享数据，分歧后的写入以增量形式独立存储。
  • Auth：托管版 Better Auth，用户与会话存储在 Postgres 中。
  • Object Storage：兼容 S3 的对象存储，可随项目一起分支。
  • Functions：Neon 的计算产品，长时运行的无服务器函数，运行位置靠近数据库，适用于 WebSocket 服务器、长时智能体 HTTP 流、API 和服务器发送事件（SSE）服务器。Function Trigger 会按 cron 向函数发起 POST 请求。函数必须在 15 分钟内开始返回响应；WebSocket 连接与 HTTP 流在数据传输期间保持打开，需至少每 15 分钟发送一个字节以保持静默流存活。
  • AI Gateway：面向前沿与开源模型的统一 API，支持 chat completions API 和 responses API，由 Databricks Unity AI Gateway 驱动。
  • Data API：可选的 PostgREST 兼容 HTTP 接口，仅在应用已使用 PostgREST 或 Supabase 数据库客户端，或正在迁移该客户端时使用。新应用应从 Functions 或现有处理器查询 Postgres。文档说明没有 neon-data-api 技能，配置项为 neon.ts 中的 dataApi。

区域可用性

Object Storage、Functions 和 AI Gateway 目前仅在 aws-us-east-2、aws-us-east-1、aws-eu-central-1 和 aws-ap-southeast-1 区域的项目中可用。在引导用户使用这些服务前，需确认用户处于上述受支持区域；若不在，则需在受支持区域新建项目。

使用方式

推荐架构：以 Neon 为后端的全栈应用，默认为 Vercel 上的 Next.js（或 Netlify、Cloudflare 等平台）。优先 Next.js + Vercel；TanStack Start、Nuxt、SvelteKit 是替代方案。由应用负责 UI 与服务端，从路由处理器、服务器函数或 Neon Functions 查询 Lakebase Postgres。可在 Web 应用与 Lakebase Postgres、Object Storage、Auth、AI Gateway 之间增加 Neon Functions 作为后端层。

次优架构：纯客户端应用 + Functions 后端，将 SPA 托管在 Vercel 等平台，从浏览器调用 Functions。

将应用迁移到 Neon：先检查代码仓库，再梳理所需能力（登录、文件、HTTP API、LLM 调用、SQL），复用已有资源（DATABASE_URL、现有 ORM/驱动、Better Auth、Clerk、S3 等），只为尚未确定的能力选择 Neon 原语，仅在基础设施缺失时进行开通（neon init / neon link / Claimable，然后 neon.ts，再 neon deploy）。文档强调：除非用户要求，不要替换可用的 Better Auth、Clerk、Supabase Auth、S3 或已提供的 DATABASE_URL；不要重写已有的 neon.ts。若已有账户的 Neon 凭据失败，应停止并请用户登录，而不是创建 Claimable 项目替代。使用了 IP Allow 或 Private Networking 的项目无法启用托管版 Better Auth，应保留这些保护。新项目创建在 AWS 区域，应用流量优先使用 pooled DATABASE_URL。

能力与对应技能对照（节选）：登录/用户/会话（无现有提供方）用 neon-auth；文件/上传用 Object Storage；HTTP API/cron/WebSocket/SSE/长时智能体用 Functions；LLM 调用用 AI Gateway；SQL/模式用 neon-postgres；现有 PostgREST/Supabase 客户端用 Data API。

文档获取：Neon 文档是相关信息的权威来源，响应前应核对官方文档。文档索引见 https://neon.com/docs/llms.txt。任意文档页可通过在 URL 后加 .md，或用 curl -H "Accept: text/markdown" <URL> 获取 markdown 内容。

技能安装：先检查目标技能是否已安装，否则用 neon skills -s <skill-name> 安装。常用参数：--global、-y、--agent <agent-name>。示例：neon skills -s neon-object-storage --global -y --agent <agent-name>。neon-auth 不在当前 CLI 技能目录中，不要执行 neon skills -s neon-auth，而应从 https://neon.com/docs/ai/skills/neon-auth/SKILL.md 获取。若 Neon CLI 不可用，可访问 https://neon.com/.well-known/agent-skills 获取技能注册表。更新技能：neon skills update 或 neon skills update -y。

CLI 与配置：优先使用 CLI 而非 MCP 服务器（除非用户另有指示、CLI 不可用或未认证）。检查 neon --version；未安装则通过 npm i -g neon（或 bun/pnpm）安装。已有凭据则复用，不要启动浏览器。未认证无人值守智能体不得启动浏览器认证。组合安装用 neon init，可用 --agent、-y、--org-id、--project-id、--project-name、--region-id、--services 等参数。MCP 服务器安装：neon mcp --agent <agent> -y（加 --oauth 则只存服务器 URL），neon mcp --help 列出其他参数。安装技能：neon skills -s neon --agent cursor -y。链接项目：neon link --project-id <project-id> -y。

与 neon.ts 相关：neon init 会写入 neon.ts，但不会部署或接线应用；--services 可声明 auth、data-api、functions、object-storage、ai-gateway。选择 data-api 也会声明 Auth。不要重写已有的 neon.ts。

适用场景

适用于为应用或智能体提供即时可用的 Postgres、写时复制分支与快照、可缩至零的计算（存储仍计费），以及与任意驱动或 ORM 兼容的标准 Postgres 的场景。典型包括：全栈 Web 应用后端、纯客户端应用后端、长时运行或流式服务器（WebSocket/SSE）、LLM 调用路由，以及从 Supabase/PostgREST 迁移。

限制

  • Neon 不托管前端。
  • Object Storage、Functions、AI Gateway 仅在列出的四个 AWS 区域可用。
  • Functions 必须在 15 分钟内开始返回响应；静默流需至少每 15 分钟发送一个字节。
  • 托管版 Better Auth 无法在启用 IP Allow 或 Private Networking 的项目上启用。
  • 不建议为新应用在浏览器中使用 PostgREST + RLS。
  • Data API 仅作为 Supabase/PostgREST 迁移路径。
  • 具体收费、价格、性能或效果资料暂未提供。