部署准备
部署准备
0. 部署准备
| 项 | 说明 |
|---|---|
| GitHub 账号 | 保存本站代码,并授权 Vercel 读取对应仓库 |
| Supabase 账号 | https://supabase.com;创建项目前以 Dashboard 显示的可用项目额度与费用为准 |
| Vercel 账号 | https://vercel.com,建议用 GitHub 登录(免配 token) |
| 自有域名(推荐) | 正式上线推荐先准备域名与 DNS 管理权限,第 4 节完成网站绑定;本指南的 Resend 登录邮件还需验证自有发件域名。网站演练可先用 *.vercel.app,但它不能作为自有发件域名 |
| 本机环境 | Node.js ≥ 22(与 CI 一致)、git、一个 IDE |
自查命令:
node --version # 期望 v22.x 或更高
git --version
1. 获取源码与安装工具
可通过 README 的部署按钮创建自己的仓库,也可 fork 后克隆到本机。使用指定版本的源码包时,按下面的方法创建仓库,后续在 Vercel 导入这个仓库即可。
在 GitHub 创建空白私有仓库,不要勾选自动生成 README、.gitignore 或 License。将以下 ZIP 文件名替换为实际文件名,先核对随包提供的 SHA-256;GitHub 地址替换为刚创建的仓库地址。发布源码包包含顶层 wanyouai/ 文件夹:
shasum -a 256 ./wanyouai-source.zip # 与随包提供的 SHA-256 比对
unzip ./wanyouai-source.zip -d ./wanyou-source
cd ./wanyou-source/wanyouai
git init -b main
git add .
git commit -m "Import wanyouai source"
git remote add origin https://github.com/<YOUR_ACCOUNT>/<YOUR_REPO>.git
git push -u origin main
若使用 GitHub 的 Download ZIP,顶层文件夹名称可能不同。进入同时包含 README.md、package.json 和 supabase/ 的目录后再执行初始化和安装命令;不要在它的外层目录运行 npm ci。
进入本机源码根目录,安装后续预检和图片桶配置工具需要的依赖,再复制环境模板:
npm ci
cp .env.example .env.local
建议从现在起,将 .env.local 作为本站环境变量的本机配置底稿:每完成一个基础服务平台的配置,就立即填写模板中对应的变量,不等到 Vercel 部署时再集中回忆和查找。 部分 API Key 只在创建时完整显示一次,创建后及时记录原值,并在自己的密码管理器中保留安全备份,可避免因找不到密钥而重建、再逐处同步。
- 按模板用途记录完整的一组参数。例如应用事务邮件需要同时填写
RESEND_API_KEY和EMAIL_FROM,不能只记录密钥、遗漏发件人。 - 只填写准备启用的功能;仅在平台后台配置的项目(如 Supabase SMTP、本站后台的分身模型密钥)仍在对应后台保存,不自行增加环境变量。
- 后续修改或轮换变量时,同步更新这份本机底稿和 Vercel 对应环境,保存后重新部署;导入前按已启用的功能逐组核对,避免本机与线上记录不一致。
.env.local 是保存在本机的实际配置文件,用途取决于运行位置:
| 使用场景 | 配置从哪里读取 |
|---|---|
| 本机运行预检、图片桶配置工具或网站 | 、 和本机 Next.js 会读取 ,填写的值会实际用于这些操作 |