1d3a7f2732
- 安装 @vercel/postgres 和 pg 依赖 - 创建 PostgresAdapter 适配器，兼容 D1 接口 - 创建 PostgresStorage 类，实现完整的 IStorage 接口 - 添加 Postgres 数据库初始化脚本和 schema - 更 next.config.js 排除 Postgres 模块的客户端打包 - 添加 VERCEL_DEPLOYMENT.md 部署指南 - 支持 Vercel serverless 环境部署 注意事项：观影室功能在 Vercel 上不可用（需要 WebSocket 支持）
89 lines
2.4 KiB
Markdown
89 lines
2.4 KiB
Markdown
# Vercel 部署指南
|
||
|
||
本项目已支持使用 **Vercel Postgres** 作为数据库后端，可在 Vercel 平台上稳定部署。
|
||
|
||
## 环境变量配置
|
||
|
||
在 Vercel 项目设置中添加以下环境变量：
|
||
|
||
### 必需的环境变量
|
||
|
||
| 变量名 | 说明 | 示例值 |
|
||
|--------|------|--------|
|
||
| `NEXT_PUBLIC_STORAGE_TYPE` | 存储类型 | `postgres` |
|
||
| `POSTGRES_URL` | Vercel Postgres 连接字符串 | `postgres://...` |
|
||
| `USERNAME` | 管理员用户名 | `admin` |
|
||
| `PASSWORD` | 管理员密码 | `your_password` |
|
||
|
||
### Vercel Postgres 连接字符串
|
||
|
||
Vercel Postgres 会自动提供以下环境变量：
|
||
- `POSTGRES_URL` - 完整连接字符串
|
||
- `POSTGRES_PRISMA_URL` - Prisma 兼容连接字符串
|
||
- `POSTGRES_URL_NON_POOLING` - 无连接池连接字符串
|
||
- `POSTGRES_USER` - 数据库用户名
|
||
- `POSTGRES_HOST` - 数据库主机
|
||
- `POSTGRES_PASSWORD` - 数据库密码
|
||
- `POSTGRES_DATABASE` - 数据库名称
|
||
|
||
通常只需要使用 `POSTGRES_URL` 即可。
|
||
|
||
## 部署步骤
|
||
|
||
### 1. 创建 Vercel Postgres 数据库
|
||
|
||
```bash
|
||
# 安装 Vercel CLI
|
||
npm i -g vercel
|
||
|
||
# 登录 Vercel
|
||
vercel login
|
||
|
||
# 创建 Postgres 数据库
|
||
vercel postgres create
|
||
|
||
# 选择数据库并连接到项目
|
||
vercel postgres connect
|
||
```
|
||
|
||
### 2. 初始化数据库表结构
|
||
|
||
```bash
|
||
# 运行数据库初始化脚本
|
||
pnpm init:postgres
|
||
```
|
||
|
||
### 3. 部署到 Vercel
|
||
|
||
```bash
|
||
# 部署项目
|
||
vercel --prod
|
||
```
|
||
|
||
## 功能限制
|
||
|
||
由于 Vercel 的 serverless 环境限制，以下功能不可用：
|
||
|
||
- **观影室** (Watch Room) - 需要 WebSocket 支持，Vercel serverless 不支持长时间运行的连接
|
||
|
||
## 存储类型对比
|
||
|
||
| 存储类型 | 部署平台 | 数据持久化 | 说明 |
|
||
|---------|---------|-----------|------|
|
||
| `localstorage` | 任意 | ❌ 浏览器本地 | 仅用于测试 |
|
||
| `d1` | Cloudflare | ✅ | Cloudflare D1 数据库 |
|
||
| `postgres` | Vercel | ✅ | Vercel Postgres 数据库 |
|
||
| `redis` | 自建服务器 | ✅ | Redis 数据库 |
|
||
| `upstash` | Vercel | ✅ | Upstash Redis |
|
||
| `kvrocks` | 自建服务器 | ✅ | Kvrocks 数据库 |
|
||
|
||
## 数据迁移
|
||
|
||
如果需要从其他存储类型迁移数据到 Vercel Postgres，请使用管理后台的数据迁移功能。
|
||
|
||
## 注意事项
|
||
|
||
1. **数据库配额**：Vercel Postgres 免费版有 256 MB 存储限制
|
||
2. **连接池**：Vercel Postgres 自动管理连接池，无需手动配置
|
||
3. **冷启动**：首次请求可能需要几秒钟冷启动时间
|