Files

foxNG 1d3a7f2732 feat: 添加 Vercel Postgres 数据库支持

- 安装 @vercel/postgres 和 pg 依赖
- 创建 PostgresAdapter 适配器，兼容 D1 接口
- 创建 PostgresStorage 类，实现完整的 IStorage 接口
- 添加 Postgres 数据库初始化脚本和 schema
- 更 next.config.js 排除 Postgres 模块的客户端打包
- 添加 VERCEL_DEPLOYMENT.md 部署指南
- 支持 Vercel serverless 环境部署

注意事项：观影室功能在 Vercel 上不可用（需要 WebSocket 支持）

2026-02-08 00:37:37 +08:00

2.4 KiB

Raw Permalink Blame History

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 数据库

# 安装 Vercel CLI
npm i -g vercel

# 登录 Vercel
vercel login

# 创建 Postgres 数据库
vercel postgres create

# 选择数据库并连接到项目
vercel postgres connect

2. 初始化数据库表结构

# 运行数据库初始化脚本
pnpm init:postgres

3. 部署到 Vercel

# 部署项目
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，请使用管理后台的数据迁移功能。

注意事项

数据库配额：Vercel Postgres 免费版有 256 MB 存储限制
连接池：Vercel Postgres 自动管理连接池，无需手动配置
冷启动：首次请求可能需要几秒钟冷启动时间

2.4 KiB Raw Permalink Blame History Unescape Escape