部署指南

本地开发

安装依赖、配置 .dev.vars 并启动开发服务器。

快速开始

bash
pnpm install
cp .env.example .dev.vars
pnpm db:migrate:local
pnpm dev

默认地址：http://localhost:3000

.dev.vars 说明

.env.example 是字段模板；实际本地配置写入 .dev.vars，且不要提交 Git。

文件用途
.env.example文档参考，可提交
.dev.varsWrangler + Vite 读取，禁止提交

重要

仓库中的 .env.example 可能含示例值，部署时请替换为你自己的密钥。

最小可运行配置

仅体验 UI 时，可先配置：

  • BETTER_AUTH_SECRET — openssl rand -base64 32
  • BETTER_AUTH_URL / SERVER_URL — http://localhost:3000
  • VITE_SITE_URL — http://localhost:3000

启用登录、支付、邮件等功能时，还需 Google OAuth、Resend、Stripe 等，见 密钥页 与 Resend 集成。

常用命令

命令说明
pnpm dev开发服务器（端口 3000）
pnpm db:migrate:local本地 D1 迁移
pnpm testVitest 单元测试
pnpm lintESLint
pnpm build生产构建（不部署）

本地 D1

迁移文件位于 migrations/。每次拉取含新迁移的代码后执行：

bash
pnpm db:migrate:local

查看本地表：

bash
pnpm db:studio

须知

本地 D1 数据与生产隔离。生产迁移使用 pnpm db:migrate:remote，见 生产部署。