网站部署与邮箱登录 · 万有AI新个体网站部署与邮箱登录
3. Vercel 部署
数据库安装和两个图片桶完成后,先部署网站以取得固定的 Production 地址,再设置 Auth 和登录邮件。首次构建与匿名首页访问不依赖 SMTP;发起登录前须完成后面的邮箱配置。
3.1 导入仓库
- 打开 https://vercel.com/new → Import Git Repository,选择第 1 节准备的仓库。通过 README 部署按钮已创建 Vercel 项目时,进入该项目继续配置。
- Framework Preset 自动识别 Next.js,Root Directory 保持
./,不要改构建命令(package.json 已指定 webpack 构建)。首次使用自己的 main 分支;页面显示 Source / Branch 时核对为 main,创建项目后再按 3.4 节核对生产分支设置。
- 在 Project Name 填写自己的 Vercel 项目名,例如
my-opc-site。先按 https://my-opc-site.vercel.app 预填下面的 SITE_URL;最终网址须在部署成功后从 Domains 复制确认,名称冲突等情况可能使实际地址不同。
3.2 导入 .env.local(在 Import Repository 配置页完成)
留在导入仓库后的项目配置页,先导入已经填写好的本机文件,再点击 Deploy,无需逐项重新输入:
- 在本机编辑源码根目录的
.env.local:填好下面六项基础变量,将 SITE_URL 改为 3.1 节预填的网站地址,必填项不得保留模板占位值;删除未启用的可选空值行(如 ZPAY_KEY=)及开发测试专用变量。使用默认图片桶时,SUPABASE_STORAGE_MEDIA_BUCKET=media 可保留。
- 展开 Environment Variables,点击 Import .env / Import,选择这份
.env.local。Mac 文件选择框可用 ⌘ + Shift + . 显示隐藏文件。如果该界面只有粘贴提示,复制文件全文粘贴到 Key / Name 输入框,面板会拆分成多条变量;不粘贴到单个 Value 中。创建页的粘贴方式见 Vercel 官方说明。
- 核对解析后的列表:每行是一个变量,六项基础变量齐全,没有空值或占位值;两项 Supabase 密钥属于
NEXT_PUBLIC_SUPABASE_URL 指向的 Supabase 项目。文件中可保留正常 .env 引号写法;解析后的 Value 应是原值,不包含包裹引号、KEY= 或额外的 Bearer。手动补填时也只在 Value 中填写原值。
- 如有 Environments 选项,本次选择 Production。本文件含生产凭据,不整组勾选 Preview / Development;若创建页没有作用域选项,首次部署后到 Settings → Environments → Production → Environment Variables 核对,移除这些值在 Preview / Development 中的副本,再单独配置测试环境。
下表的 Type 是推荐分类:地址、名称和公开标识用 Config,私有密钥用 Secret。.env.local 不携带 Type;若整批导入后全部显示为 Secret,可以保留并继续部署,两种类型都能供构建和服务端读取,无需为分类删除重建或拆成两次导入。区别主要在保存后能否查看原值:Secret 不回显,须自行保管原始配置。Type 与 Production / Preview 作用域是两个独立选项。规则见 Vercel Config / Secret。
下表是首次部署所需的六项基础变量与默认图片桶。可选功能在第 6 节开通时再补入,无需为首次部署填写全部模板:
| 变量 | Type | 值 | 说明 |
|---|
SITE_URL | Config | 按 Project Name 预填,如 https://my-opc-site.vercel.app | 必须填写,末尾不带 /;部署后核对实际固定地址 |
NEXT_PUBLIC_SUPABASE_URL | Config | 2.2 节 Project URL | 可进浏览器 |
NEXT_PUBLIC_SUPABASE_ANON_KEY | Config | 2.2 节 Publishable / Legacy anon key | 可进浏览器;不是服务端密钥 |
SUPABASE_SERVICE_ROLE_KEY | Secret | 2.2 节 Secret / Legacy service_role key | 仅服务端 |
PUBLISH_TOKEN | Secret | 自生成随机串(openssl rand -hex 32) | 发布工具的授权令牌 |
OWNER_EMAIL | Config | 本站站主邮箱 | 全新部署首次认领只允许这个邮箱;验证码或链接登录前先配置 |
SUPABASE_STORAGE_MEDIA_BUCKET | Config | media | 与「配置图片存储」中的桶名一致,使用默认名称时可省 |
变量名以 NEXT_PUBLIC_ 开头,表示该值可供访客浏览器中的网页代码使用,应当视为公开信息。 即使在 Vercel 将它设为 Secret,也不会改变这一点;Secret 只是不在 Vercel 管理界面回显原值,不会把网页需要使用的值隐藏起来。
例如,NEXT_PUBLIC_SUPABASE_ANON_KEY 应填可公开的 Supabase Publishable key(sb_publishable_ 开头);私有 Secret key(sb_secret_ 开头)只填在 SUPABASE_SERVICE_ROLE_KEY,不能填进前者。按模板保留变量名,不要给私有密钥的变量名加上 NEXT_PUBLIC_。机制见 Next.js 环境变量说明,其余变量的推荐 Type 见环境变量契约。
首次部署只需填写六项基础变量和图片桶名。第 6 节按功能说明其余变量如何取得和使用,启用时再批量补填;环境变量契约提供完整格式、Type 和轮换规则。
Import .env 是把文件中的值保存到 Vercel 的这一次操作;Vercel 不会持续读取本机文件。文件不需要提交 Git,后续只改本机文件不会更新线上配置;线上值在项目的 Environment Variables 中编辑,保存后重新部署对应环境。http://localhost:3000 不作为线上 SITE_URL。参见 Vercel 环境变量。
如需本机配置预检,保存 .env.local 后可从源码根目录运行 npm run doctor,按输出修正 error / incomplete 项。该命令只检查本机配置形态,不会替你保存 Vercel 变量,也不验证 Dashboard 设置或外部连通性。
3.3 部署并确认固定地址
- Deploy。打开 Vercel 项目 → Deployments,确认最新部署详情为 Ready / Production,Source 是自己仓库的
main 及预期提交。
- 从项目 Overview → Production Deployment → Domains 复制固定站点根地址,如
https://my-opc-site.vercel.app。选择网站的固定地址,不使用含提交哈希的临时部署地址或分支 Preview 地址;类型说明见 Vercel 部署地址。
- 与 Vercel Production 的
SITE_URL 比对。若不同,在 Vercel 修正 SITE_URL 并从 main 重新部署,同时更新本机配置记录。
- 在无痕窗口打开固定 Production 地址,确认首页正常加载、空站显示空态,且不会要求登录 Vercel。邮箱登录在完成第 5 节后测试。
正式上线推荐先完成第 4 节,绑定自有域名后再配置第 5 节的 Auth 回调和登录邮件,减少后续换址操作。暂时只做安装演练时,可用固定 *.vercel.app 地址继续;使用 Resend 发信仍需准备并验证自有发件域名。3.4 节用于说明后续更新与预览,不是首次安装的额外步骤。
3.4 部署分支、Preview 与 Production
首次安装使用 main → Production 即可,不必先建立 Preview。Vercel 新项目的首个部署会成为 Production;后续默认按生产分支区分环境,规则见 Vercel 部署环境。
| 环境 | 默认触发方式 | 使用的变量 | 访问入口 |
|---|
| Production(正式站点) | 向生产分支 main 推送或合并代码 | Production 变量 | 固定 项目名.vercel.app 和绑定的正式域名 |
| Preview(改动预览) | 向其他分支(如 feat/update-site)推送代码或创建 PR | Preview 变量,可为指定分支单独设置 | 分支预览地址或该次部署地址,不替换正式域名 |
项目建立后,打开 Settings → Environments → Production → Branch Tracking,确认启用且跟踪 main,保存。Preview 默认跟踪 All unassigned git branches,即未分配给其他环境的分支。更换生产分支在这里修改;日常上线保持 main 不变,将改动合并回 main。本机 git checkout 或 GitHub 页面切换分支,只是在切换查看/编辑的代码,不会切换线上站点。生产分支设置见 Vercel Git 部署。
- 准备测试配置:按第 2 节为另一个测试 Supabase 项目初始化数据库和图片桶。在 Settings → Environments → Preview → Environment Variables 保存该测试项目的 URL、anon key、service-role key,以及测试用
OWNER_EMAIL、PUBLISH_TOKEN 和 Preview 的 SITE_URL;可把变量限定到 feat/update-site 分支。取得分支固定地址后,核对 SITE_URL 并重新部署,在该测试 Supabase 项目追加两条精确 Auth 回调、配置登录邮件。支付、事务邮件等可选功能按测试用途另配,生产凭据不复制到 Preview。
- 验证改动:推送该分支,打开生成的 Preview,核对 Source 分支/提交、Environment = Preview、Ready,再测试登录与相关功能。Preview 若要求登录 Vercel,属于部署访问保护;它与应用自己的站主/普通用户登录不同。
- 合并上线:验证通过后,在 GitHub 创建目标分支为
main 的 Pull Request(PR),检查 CI 后合并。Vercel 会用 Production 变量重新构建生产部署;需要数据库升级时,先按版本的升级说明处理正式库,再让依赖新结构的应用上线。
- 核对正式站点:在 Overview 的 Production Deployment 确认 Source 为预期的
main 提交;详情应为 Ready / Production / Current,再从固定正式域名复查。Ready 只表示该部署可用,较早部署或 Preview 的 Ready 不表示它正在承接正式流量。
Preview 与 Production 的区分不会自动隔离数据:应用使用哪份 Supabase 数据库、Auth 与 Storage,取决于该环境实际保存的 URL 和密钥。合并代码、切换部署或提升部署都不会复制测试内容、用户、订单或执行数据库迁移。
手动部署与切换:在 Deployments → Create Deployment 填入目标分支或提交,确认 Source 和目标环境后创建;对已有部署点击 Redeploy 是重建所选提交,不会合并 Git 分支。若使用 Promote to Production,Vercel 会以 Production 变量重新构建 Preview,并将正式域名切到新部署;这不会把代码合并回 main,之后推送 main 仍会触发正式部署。因此日常更新采用上面的 PR 合并流程。操作区别见 Vercel 提升部署。
4. 配置自有域名(推荐)
推荐在配置第 5 节的 Auth 回调和登录邮件前,先确定正式网站地址并完成绑定。网站域名和邮件发件域名用途不同,可以使用同一自有根域名的不同子域:
| 用途 | 示例 | 配置位置与要求 |
|---|
| 网站访问与登录回跳 | www.example.com | 在 Vercel 绑定,确认 HTTPS;推荐作为正式网站主地址 |
| Resend 登录邮件发件 | auth.example.com,发件人如 no-reply@auth.example.com | 在 Resend 添加域名,并在 DNS 服务商保存验证记录;本指南公开登录发信的前置条件 |
两者无需同名,也不必购买两个根域名。自有网站域名是上线建议,不是应用运行的硬性条件;如果网站暂用 Vercel 默认地址,仍可用自己控制的其他域名发邮件。Resend 要求发件域可由你添加 DNS 验证记录,不能用 Vercel 分配的 *.vercel.app 子域代替。依据见 Resend 域名说明。
- Vercel 项目 → Settings → Domains → Add,输入你的域名(如
www.example.com);
- 到域名服务商,按 Vercel 页面为该域名给出的记录类型、名称和值配置 DNS;
- 等待 Vercel 签发 HTTPS 证书(通常几分钟);
- 将 Vercel Settings → Environments → Production → Environment Variables 中的环境变量
SITE_URL 和本机 .env.local 的同名变量改为 https://www.example.com,然后 Redeploy。确认新地址可访问后,继续第 5 节,首次填写 Auth 的 Site URL 与两条 Redirect URLs 时直接使用这个域名。
- 国内受众注意:域名需备案且 Vercel 访问性不稳定时,另行评估地区可达性与部署合规要求,本指南步骤不变、仅平台替换。
已运行的网站日后换域名时,按 5.1 节的「后续改用自有域名」操作,先添加新回调,再切换主地址并验证,最后清理不用的旧回调。已启用 zpay 时,新订单使用新的 SITE_URL 生成回调与返回地址;仍有待支付订单时保留旧域名可访问,直到这些订单完成处理。Auth 回调白名单的删除不等于停用旧域名或支付通知接口。
5. 邮箱登录与 Auth 回调
前置条件:Vercel Production 已 Ready,已选定可访问的固定 HTTPS 根地址,Vercel 的 SITE_URL 与它一致。正式上线推荐先按第 4 节完成自有网站域名绑定;按本指南使用 Resend 时,还需准备可验证的自有发件域名。完成本节后再请求登录邮件。
5.1 设置 Auth 地址
打开 Supabase 项目 → Authentication → URL Configuration。以下以第 4 节绑定的网站 https://www.example.com 为例,三处均替换为自己的实际地址;若暂用 Vercel 默认域名,则三处都使用其固定 HTTPS 地址。然后保存:
Site URL: https://www.example.com
Redirect URLs: https://www.example.com/auth/callback
https://www.example.com/login/callback
/auth/callback 用于站主,/login/callback 用于普通用户。正式站点使用两条精确回调,不使用 /** 通配;本地开发或独立 Preview 需要时再单独追加对应地址。规则见 Supabase Auth 回调说明。
后续改用自有域名
Site URL 是一个默认主地址,Redirect URLs 是允许回跳的地址清单。建议切换期间先增加新地址,验证成功后删除不再使用的旧地址:
| 配置项 | 从默认 Vercel 域名改为 https://www.example.com 时 |
|---|
| Supabase Site URL | 替换为 https://www.example.com,保留一个主地址 |
| Supabase Redirect URLs | 先新增 https://www.example.com/auth/callback 和 https://www.example.com/login/callback;原 Vercel 两条暂时保留 |
| Vercel Production SITE_URL | 替换为 https://www.example.com,同步本机记录并重新部署 |
- 先在 Vercel 绑定自有域名,确认 HTTPS 和页面访问正常。
- 在 Supabase 保存新域名的两条精确 Redirect URLs,再更新 Site URL 和 Vercel
SITE_URL,重新部署。
- 从新域名的
/admin 与 /login 发起登录,分别核对验证码和邮件链接回跳;链接仍在发起请求的同一浏览器打开。
- 将对外登录入口改为新域名;新域名登录通过,且旧域名不再作为登录入口、此前邮件已按实际 Email OTP expiration 过期、没有待完成登录流程后,删除旧 Vercel 域名的两条回调。若确有旧地址兼容用途,可暂留对应精确路径;不用的地址不长期积累,也不扩大成
*.vercel.app/**。
本应用以 SITE_URL 生成登录回跳,采用一个主登录域名。不同域名的浏览器会话不会因白名单中同时存在两个域名而自动共享;仅保留旧回调也不能保证切换前的邮件链接继续完成登录。切换后从新域名重新请求验证码/链接。机制见 Supabase PKCE。
5.2 配置登录邮件
开始前确认:网站已选定第 5.1 节中的最终地址,且具备自有发件域名的 DNS 管理权限。网站推荐先绑定自有域名;Resend 发件域则必须验证,不能用默认测试发件地址向本站所有用户发送登录邮件。两种域名的关系见第 4 节,Resend 对接前置条件见官方 SMTP 指南。
新建 Supabase Free 项目使用默认 SMTP 时,Email Templates 不可编辑。先在 Supabase 启用并保存自定义 SMTP,再编辑模板。 本指南使用 Resend,其他兼容 SMTP 服务也能满足此前置条件,无需仅为模板编辑升级 Supabase。适用范围见官方规则。
- 注册并登录 Resend,打开 Domains → Add Domain,填写自己控制的发件域,例如
auth.example.com。到域名服务商的 DNS 管理页,逐条添加 Resend 给出的类型、名称、值和优先级;返回 Resend 核验,等状态成为 Verified。然后在 API Keys → Create API Key 创建 Sending access 密钥,限定到该域,立即复制完整原值并保管。发件地址可自行选为 no-reply@auth.example.com,无需先创建同名收件邮箱。网站可以使用 www.example.com 或 Vercel 默认域名,发件域验证一次即可。
- Supabase Authentication → Emails → SMTP Settings 启用自定义 SMTP。Host 填
smtp.resend.com,Port number 填 465(SSL/TLS),Username 填 resend,Password 填完整 Resend API Key(不加 Bearer);Sender email address 使用已验证域下的发件地址,Sender name 填自己的站名。点击 Save changes,确认保存成功且 Enable custom SMTP 保持开启。
- 确认自定义 SMTP 已保存后,在 Email Templates 的 Confirm sign up 和 Magic link or OTP 两处,都粘贴 login.html 的完整内容并保存。保留
{{ .Token }} 和 {{ .ConfirmationURL }},分别覆盖新用户首次与已有用户再次登录;不要只修改其中一处。
- 打开 Authentication → Sign In / Providers → Auth Providers → Email(部分界面直接显示 Email),确认 Email 登录启用、允许新用户注册且邮箱验证开启。将 Email OTP length 设为 6 并保存;这是验证码的数字位数,不是 Minimum password length(密码长度),也不是在模板里写“6 位”就会生效。Email OTP expiration 另管有效期,单位为秒,例如
600 为 10 分钟。在 Rate Limits 核对发信限额,Resend 关闭链接跟踪。保存后申请一封新邮件,实际核对位数并完成登录,不使用保存设置前的旧验证码。设置位置与免密登录规则见 Supabase OTP。
Supabase 默认 SMTP 只向项目组织成员发信,不能用于公开登录。登录邮件不由 Vercel 的 RESEND_API_KEY / EMAIL_FROM 控制,不依赖应用邮件队列;只设置这些应用变量也不会解锁 Auth 模板。电脑发起登录、手机收信时可直接在电脑输入验证码;邮件链接须在发起登录的同一浏览器及设备打开。各项限制与官方依据见上述邮箱登录指南。