[ PROMPT_NODE_23564 ]
connection-methods
[ SKILL_DOCUMENTATION ]
# 连接方法
根据部署平台和运行环境,为您的 Neon Postgres 数据库选择最佳连接方法的指南。
获取官方文档:
bash
curl -H "Accept: text/markdown" https://neon.tech/docs/connect/choose-connection
## 决策树
遵循此流程确定正确的连接方式:
### 1. 您正在使用什么语言?
**非 TypeScript/JavaScript** → 使用来自安全服务器的 **带连接池的 TCP**。
对于非 TypeScript 语言,请使用您语言的原生 Postgres 驱动程序,并启用连接池,从安全的后端服务器进行连接。
| 语言/框架 | 文档 |
| ------------------- | ------------------------------------------- |
| Django (Python) | https://neon.tech/docs/guides/django |
| SQLAlchemy (Python) | https://neon.tech/docs/guides/sqlalchemy |
| Elixir Ecto | https://neon.tech/docs/guides/elixir-ecto |
| Laravel (PHP) | https://neon.tech/docs/guides/laravel |
| Ruby on Rails | https://neon.tech/docs/guides/ruby-on-rails |
| Go | https://neon.tech/docs/guides/go |
| Rust | https://neon.tech/docs/guides/rust |
| Java | https://neon.tech/docs/guides/java |
**TypeScript/JavaScript** → 进入第 2 步。
---
### 2. 没有后端的客户端应用?
**是** → 通过 `@neondatabase/neon-js` 使用 **Neon Data API**
这是客户端应用的唯一选择,因为浏览器无法直接与 Postgres 建立 TCP 连接。设置请参阅 `neon-js.md`。
bash
curl -H "Accept: text/markdown" https://neon.tech/docs/reference/javascript-sdk
**否** → 进入第 3 步。
---
### 3. 长时间运行的服务器?(Railway, Render, 传统 VPS)
**是** → 通过 `node-postgres`、`postgres.js` 或 `bun:pg` 使用 **带连接池的 TCP**
长时间运行的服务器会保持持久连接,因此使用连接池的标准 TCP 驱动程序是最佳选择。
**否** → 进入第 4 步。
---
### 4. 不支持 TCP 的边缘环境?
某些边缘运行时不支持 TCP 连接。这种情况现在很少见。
**是** → 进入第 5 步检查事务需求。
**否** → 进入第 6 步检查连接池支持。
---
### 5. 您的应用是否使用 SQL 事务?
**是** → 通过 `@neondatabase/serverless` 使用 **WebSocket 传输** 和 `Pool`
WebSocket 维护事务所需的连接状态。请参阅 `neon