Neon Serverless Postgres 无服务器数据库 | 自动扩缩容、分支、即时恢复

neon-postgres by neondatabase/agent-skills

14,000 周安装量

43 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/neondatabase/agent-skills --skill neon-postgres

开发云服务开发运维

🇨🇳中文介绍

Neon Serverless Postgres

Neon 是一个无服务器 Postgres 平台，它通过分离计算和存储来提供自动扩缩容、分支、即时恢复和缩容至零的能力。它完全兼容 Postgres，并支持任何支持 Postgres 的语言、框架或 ORM。

Neon 文档

Neon 文档是所有 Neon 相关信息的权威来源。在回答之前，请务必根据官方文档核实相关说法。Neon 的功能和 API 在不断演进，因此请优先获取最新的文档，而不是依赖训练数据。

以 Markdown 格式获取文档

可以通过两种方式将任何 Neon 文档页面以 markdown 格式获取：

在 URL 后追加.md（最简单）：https://neon.com/docs/introduction/branching.md
在标准 URL 上请求text/markdown：curl -H "Accept: text/markdown" https://neon.com/docs/introduction/branching

两种方法返回相同的 markdown 内容。请使用您的工具支持的方法。

查找正确的页面

文档索引列出了每个可用页面及其 URL 和简短描述：

https://neon.com/docs/llms.txt

常见的文档 URL 组织在下面的主题链接中。如果您需要的页面未在此列出，请搜索文档索引：https://neon.com/docs/llms.txt — 不要猜测 URL。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

连接方法与驱动程序

当您需要根据运行时约束（TCP、HTTP、WebSocket、边缘环境、无服务器、长时间运行）选择正确的传输方式和驱动程序时，请使用此部分。

无服务器驱动程序

用于 @neondatabase/serverless 模式，包括 HTTP 查询、WebSocket 事务和针对特定运行时的优化。

用于结合 Neon Auth 和数据 API 的工作流，支持 PostgREST 风格的查询和类型化客户端设置。

用于本地开发启用，包括 npx neonctl@latest init、VSCode 扩展设置和 Neon MCP 服务器配置。

用于终端优先的工作流、脚本以及使用 neonctl 的 CI/CD 自动化。

Neon 管理 API 可用于以编程方式管理 Neon 资源。Neon CLI 和 MCP 服务器在后台使用它，但也可以直接用于更复杂的自动化工作流或将 Neon 嵌入其他应用程序的场景。

用于直接的 HTTP 自动化、端点级别的控制、API 密钥认证、速率限制处理和操作轮询。

当需要通过 @neondatabase/api-client 在 TypeScript 中以类型安全的方式编程控制 Neon 资源时使用。

当需要使用 neon-api 包在 Python 中编程管理 Neon 时使用。

用于托管用户身份验证设置、UI 组件、身份验证方法，以及在 Next.js 和 React 应用中集成 Neon Auth 时可能遇到的陷阱。

Neon Auth 也内嵌在 Neon JS SDK 中 - 因此根据您的使用场景，您可能希望使用 Neon JS SDK 而不是 Neon Auth。更多详情请参阅 https://neon.com/docs/ai/skills/neon-postgres/references/connection-methods.md。

当用户计划创建隔离环境、进行模式迁移测试、预览部署或自动化分支生命周期时使用。

分支是即时创建的、写时复制的克隆（无需完整的数据复制）。
每个分支都有自己的计算端点。
使用 neonctl CLI 或 MCP 服务器来创建、检查和比较分支。

当用户需要计算资源随工作负载自动扩展，并希望获得关于计算单元（CU）大小和运行时行为的指导时使用。

当优化闲置成本并讨论挂起/恢复行为（包括冷启动的权衡）时使用。

闲置的计算节点会自动挂起（默认 5 分钟，可配置）（除非已禁用 - 仅限启动与扩展计划）
挂起后的首次查询通常会有冷启动惩罚（大约几百毫秒）
计算节点挂起时，存储保持活动状态。

当用户需要时间点恢复，或者希望无需传统备份恢复工作流即可恢复数据状态时使用。

恢复窗口取决于计划限制。
用户可以从历史时间点创建分支。
时间旅行查询可用于历史检查工作流。

用于读密集型工作负载，用户需要专用的只读计算节点而无需复制存储。

副本是共享同一存储的只读计算端点。
创建速度快，扩缩容独立于主计算节点。
典型用例：分析、报告和读密集型的 API。

当用户处于无服务器或高并发环境，需要安全、可扩展的 Postgres 连接管理时使用。

Neon 的连接池使用 PgBouncer。
在端点主机名后添加 -pooler 以使用池化连接。
在具有突发并发性的无服务器运行时中，连接池尤其重要。

当用户需要按受信任的网络、IP 或 CIDR 范围限制数据库访问时使用。

当集成变更数据捕获（CDC）管道、外部 Postgres 同步或基于复制的数据移动时使用。

Neon 支持原生的逻辑复制工作流。
适用于与外部 Postgres 系统进行复制。

🇺🇸English

Neon Serverless Postgres

Neon is a serverless Postgres platform that separates compute and storage to offer autoscaling, branching, instant restore, and scale-to-zero. It's fully compatible with Postgres and works with any language, framework, or ORM that supports Postgres.

Neon Documentation

The Neon documentation is the source of truth for all Neon-related information. Always verify claims against the official docs before responding. Neon features and APIs evolve, so prefer fetching current docs over relying on training data.

Fetching Docs as Markdown

Any Neon doc page can be fetched as markdown in two ways:

Append.md to the URL (simplest): https://neon.com/docs/introduction/branching.md
Requesttext/markdown on the standard URL: curl -H "Accept: text/markdown" https://neon.com/docs/introduction/branching

Both return the same markdown content. Use whichever method your tools support.

Finding the Right Page

The docs index lists every available page with its URL and a short description:

https://neon.com/docs/llms.txt

Common doc URLs are organized in the topic links below. If you need a page not listed here, search the docs index: https://neon.com/docs/llms.txt — don't guess URLs.

What Is Neon

Use this for architecture explanations and terminology (organizations, projects, branches, endpoints) before giving implementation advice.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/what-is-neon.md

Getting Started

Use this for first-time setup: org/project selection, connection strings, driver installation, optional auth, and initial schema setup.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/getting-started.md

Connection Methods & Drivers

Use this when you need to pick the correct transport and driver based on runtime constraints (TCP, HTTP, WebSocket, edge, serverless, long-running).

Link: https://neon.com/docs/ai/skills/neon-postgres/references/connection-methods.md

Serverless Driver

Use this for @neondatabase/serverless patterns, including HTTP queries, WebSocket transactions, and runtime-specific optimizations.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/neon-serverless.md

Neon JS SDK

Use this for combined Neon Auth + Data API workflows with PostgREST-style querying and typed client setup.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/neon-js.md

Developer Tools

Use this for local development enablement with npx neonctl@latest init, VSCode extension setup, and Neon MCP server configuration.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/devtools.md

Neon CLI

Use this for terminal-first workflows, scripts, and CI/CD automation with neonctl.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/neon-cli.md

Neon Admin API

The Neon Admin API can be used to manage Neon resources programmatically. It is used behind the scenes by the Neon CLI and MCP server, but can also be used directly for more complex automation workflows or when embedding Neon in other applications.

Neon REST API

Use this for direct HTTP automation, endpoint-level control, API key auth, rate-limit handling, and operation polling.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/neon-rest-api.md

Neon TypeScript SDK

Use this when implementing typed programmatic control of Neon resources in TypeScript via @neondatabase/api-client.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/neon-typescript-sdk.md

Neon Python SDK

Use this when implementing programmatic Neon management in Python with the neon-api package.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/neon-python-sdk.md

Neon Auth

Use this for managed user authentication setup, UI components, auth methods, and Neon Auth integration pitfalls in Next.js and React apps.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/neon-auth.md

Neon Auth is also embedded in the Neon JS SDK - so depending on your use case, you may want to use the Neon JS SDK instead of Neon Auth. See https://neon.com/docs/ai/skills/neon-postgres/references/connection-methods.md for more details.

Branching

Use this when the user is planning isolated environments, schema migration testing, preview deployments, or branch lifecycle automation.

Key points:

Branches are instant, copy-on-write clones (no full data copy).
Each branch has its own compute endpoint.
Use the neonctl CLI or MCP server to create, inspect, and compare branches.

Link: https://neon.com/docs/ai/skills/neon-postgres/references/branching.md

Autoscaling

Use this when the user needs compute to scale automatically with workload and wants guidance on CU sizing and runtime behavior.

Link: https://neon.com/docs/introduction/autoscaling.md

Scale to Zero

Use this when optimizing idle costs and discussing suspend/resume behavior, including cold-start trade-offs.

Key points:

Idle computes suspend automatically (default 5 minutes, configurable) (unless disabled - launch & scale plan only)
First query after suspend typically has a cold-start penalty (around hundreds of ms)
Storage remains active while compute is suspended.

Link: https://neon.com/docs/introduction/scale-to-zero.md

Instant Restore

Use this when the user needs point-in-time recovery or wants to restore data state without traditional backup restore workflows.

Key points:

Restore windows depend on plan limits.
Users can create branches from historical points-in-time.
Time Travel queries can be used for historical inspection workflows.

Link: https://neon.com/docs/introduction/branch-restore.md

Read Replicas

Use this for read-heavy workloads where the user needs dedicated read-only compute without duplicating storage.

Key points:

Replicas are read-only compute endpoints sharing the same storage.
Creation is fast and scaling is independent from primary compute.
Typical use cases: analytics, reporting, and read-heavy APIs.

Link: https://neon.com/docs/introduction/read-replicas.md

Connection Pooling

Use this when the user is in serverless or high-concurrency environments and needs safe, scalable Postgres connection management.

Key points:

Neon pooling uses PgBouncer.
Add -pooler to endpoint hostnames to use pooled connections.
Pooling is especially important in serverless runtimes with bursty concurrency.

Link: https://neon.com/docs/connect/connection-pooling.md

IP Allow Lists

Use this when the user needs to restrict database access by trusted networks, IPs, or CIDR ranges.

Link: https://neon.com/docs/introduction/ip-allow.md

Logical Replication

Use this when integrating CDC pipelines, external Postgres sync, or replication-based data movement.

Key points:

Neon supports native logical replication workflows.
Useful for replicating to/from external Postgres systems.

Link: https://neon.com/docs/guides/logical-replication-guide.md

Weekly Installs

14.0K

Repository

neondatabase/ag…t-skills

GitHub Stars

First Seen

Jan 21, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

claude-code8.8K

github-copilot7.4K

cursor5.5K

codex2.8K

opencode2.7K

gemini-cli2.5K

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

102,200 周安装

Neon Serverless Postgres 无服务器数据库 | 自动扩缩容、分支、即时恢复

🇨🇳中文介绍

Neon Serverless Postgres

Neon 文档

以 Markdown 格式获取文档

查找正确的页面

相关 Skills

什么是 Neon

快速开始

连接方法与驱动程序

无服务器驱动程序

Neon JS SDK

开发者工具

Neon CLI

Neon 管理 API

Neon REST API

Neon TypeScript SDK

Neon Python SDK

Neon Auth

分支

自动扩缩容

缩容至零

即时恢复

只读副本

连接池

IP 允许列表

逻辑复制

🇺🇸English

Neon Serverless Postgres

Neon Documentation

Fetching Docs as Markdown

Finding the Right Page

What Is Neon

Getting Started

Connection Methods & Drivers

Serverless Driver

Neon JS SDK

Developer Tools

Neon CLI

Neon Admin API

Neon REST API

Neon TypeScript SDK

Neon Python SDK

Neon Auth

Branching

Autoscaling

Scale to Zero

Instant Restore

Read Replicas

Connection Pooling

IP Allow Lists

Logical Replication

最新 Skills