部署到 Vercel
方式一:Vercel CLI(推荐)
# 1. 安装 CLI(已安装可跳过)
npm i -g vercel
# 2. 关联项目
vercel link
# 3. 创建公开的 Blob Store(或复用已有 Store)
vercel blob create-store filebox --access public --yes
# 4. 添加环境变量(production 与 preview)
vercel env add ADMIN_PASSWORD production
vercel env add ADMIN_PASSWORD preview
vercel env add UPSTASH_REDIS_REST_URL production
vercel env add UPSTASH_REDIS_REST_TOKEN production
# 5. 部署
vercel --prod --yes
方式二:GitHub 导入
- 把仓库推送到 GitHub
- 在 Vercel 控制台 → Add New Project → Import 该仓库
- 存储 → Create Blob Store 并关联到项目(自动注入
BLOB_READ_WRITE_TOKEN);如需多存储另配 Backblaze B2 / GitHub - Environment Variables 添加
ADMIN_PASSWORD,可选UPSTASH_REDIS_REST_URL/TOKEN、B2 项、GITHUB_TOKEN - Deploy
环境变量
| 变量 | 必需 | 说明 |
|---|---|---|
| BLOB_READ_WRITE_TOKEN | 是 | Blob Store 关联后自动注入;本地开发需手动填入 |
| ADMIN_PASSWORD | 是 | 管理后台密码(务必修改默认值) |
| UPSTASH_REDIS_REST_URL / UPSTASH_REDIS_REST_TOKEN | 推荐 | Upstash 状态存储:授权码发放/使用、元数据索引、存储配额统计 |
| B2_APPLICATION_KEY_ID | 可选 | Backblaze B2 应用密钥 ID(多存储之一) |
| B2_APPLICATION_KEY | 可选 | Backblaze B2 应用密钥 |
| B2_BUCKET_NAME | 可选 | B2 Bucket 名(本部署为 fliebox) |
| B2_ENDPOINT | 可选 | B2 S3 Endpoint,如 https://s3.us-east-005.backblazeb2.com |
| GITHUB_TOKEN/GITHUB_USER | 可选 | GitHub 绑定:上传小文件至私有仓库 + 国内镜像测速 |
常见检查项
- 部署后首页可访问,但取件码创建失败?→ 检查
BLOB_READ_WRITE_TOKEN是否正确注入 - 管理后台报「管理员密码未配置」→ 检查
ADMIN_PASSWORD - 上传报「文件过大」→ 在后台调整文件大小上限
Blob Store 推荐与项目同一区域(本项目默认
iad1),读写延迟最低且保证读后写一致性。