Skip to content

VERCEL_DEPLOYMENT.md

Latest commit

 

History

History
88 lines (61 loc) · 2.36 KB

VERCEL_DEPLOYMENT.md

File metadata and controls

88 lines (61 loc) · 2.36 KB
Raw

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

注意事项

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