手冊 · Vercel
用 Vercel 部署網站 — 先 Preview
先上預覽 URL，準備好先 promote 去 production。
2026-10-16
一句承諾
把網站放到 Vercel 做 Preview（有得撳嘅預覽 URL）。Secret 唔好寫入 git。買域名同 promote 上 production，你準備好先做。
適合／唔適合
| 適合 | 唔適合 |
|---|---|
| 已有 Next.js app、想要 preview URL | 當呢頁係合規／法律認證，或者要 VPC 級 hosting |
| 「bot 打 checklist、你控帳號／錢／上線」節奏 | 唔係用 Vercel 託管 |
| 只講 hosting：project 同 preview URL | Plugin／MCP／AI Gateway → 去 Vercel agent toolchain |
Stack
- Vercel project + Preview／Production
- Environment variables（Config vs Secret；按環境 scope）
- 可選 Git 自動 preview
- 之後先至：Resend／Stripe 嘅 Production env（跟各自 playbook 嘅 human gate）
Bot vs 你
| Bot | 你（human） |
|---|---|
| 寫 playbook／SEO／步驟草稿 | 開／擁有 Vercel 帳號 |
| 建議 env 名（值可留空） | 自己喺 Dashboard／CLI 貼 Secret；唔好貼去 chat／git |
| 協助／記錄 preview deploy | 自己按 Promote／vercel --prod／merge production branch |
| 唔會代你買域名 | 域名錢同 DNS 你控 |
步驟
- 本地
npm run build過關。 - Import Git 或
vercellink／Vercel Drop → 建 project（deployments overview）。 - 加 Preview／Development 環境變數（env）。準備好先加 Production。
vercel env pull拉本地，保持 gitignore。 - 推非 production 分支或
vercel deploy（唔加--prod）→ 開 preview URL 驗/、/zh、/playbooks。 - 只喺 Preview 迭代。
- 域名： 先用
*.vercel.app。買／綁 custom domain（domains、working with domains）你自己決定同操作。 - Production： 你準備好先 promote／
--prod／merge production branch（promote）。Promote 會用 Production env 重建。
失敗模式／注意
- Secret 入 git → 立即 rotate。
- 唔小心
--prod或 auto-assign domain → 真流量。 - Preview OK、prod 掛 → Production env 唔同。
- Domain Invalid Configuration → 對 DNS／nameserver。
- 唔好用 preview URL 假稱 production SEO／訪客數。
- 「免費域名」等 offer 以你帳戶當日為準——你必須核對。
Newsletter CTA
Preview 睇得順，你自己 promote。下一篇可以係 Resend 或者 Stripe Payment Links。
你必須核對
同上 EN「Human must verify」清單 1–8。
引用文件
- Deploying to Vercel — overview · 2026-10-16
- Promoting a preview deployment to production · 2026-10-16
- Environment variables · 2026-10-16
- Domains overview · 2026-10-16
- Working with domains · 2026-10-16
- Projects overview · 2026-10-16