Vercel 部署

最适合第一次上线的路线：绑定 GitHub 后，每次 push 自动构建部署，全程不需要碰服务器。

前置准备

• 代码已推到 GitHub 仓库
• 一个 Vercel 账号（直接用 GitHub 登录）
• 一个自己的域名（正式上线必需，见下文国内访问一节）

第一步：导入项目

1. Vercel 控制台 → Add New → Project → 选择你的 GitHub 仓库
2. 框架预设会自动识别（Next.js / Vite 等），构建命令一般不用改
3. 点 Deploy，等 1-2 分钟，拿到一个 xxx.vercel.app 的预览地址

这个 *.vercel.app 地址在国内基本打不开，属于正常现象——继续往下配域名。

第二步：环境变量

项目里用到的密钥（数据库连接串、API Key 等）在 Settings → Environment Variables 里配置：

• NEXT_PUBLIC_ 开头的变量会打进前端代码，不要放密钥
• 改完环境变量需要 Redeploy 才生效（Deployments → 最新一条 → Redeploy）

第三步：自定义域名 + 国内优选（关键）

1. Settings → Domains 添加你的域名（建议同时加 xxx.com 和 www.xxx.com）
2. 到你的 DNS 服务商按 Vercel 给的提示配置解析。国内访问的关键在这里：
   • 不要用 Vercel 默认提示的 cname.vercel-dns.com
   • 改用 Vercel 的国内优化入口：cname-china.vercel-dns.com（CNAME，不开代理/灰云）
   • 顶级域名（apex）用 A 记录时填 76.76.21.241，但更推荐把主站放 www、apex 做跳转
3. 等几分钟 DNS 生效，用手机蜂窝网络（不挂代理）实测能否打开

实测效果：cname-china.vercel-dns.com 优选在国内三大运营商的可用性和速度都明显好于默认入口。

第四步：验收清单

• https://你的域名 国内蜂窝网络可打开
• 环境变量齐全，功能（登录/接口）正常
• push 一个小改动，确认自动部署触发并生效

常见坑

改了代码没生效？ 看 Deployments 列表里最新构建是否成功（红色 Error 点进去看日志）。

接口报跨域/回调地址不对？ 检查环境变量里的站点地址是否还写着 localhost 或 vercel.app 预览域名。