本地跑通之后，部署本身只有几步。但有几个坑值得提前知道。

前置检查

先在本地确认构建产物是干净的：

pnpm install
pnpm build

构建完成后会生成 out 目录。这个目录就是最终要部署的文件，里面只有静态资源，没有任何服务端代码。

推到 Git 仓库

git init
git add .
git commit -m "init"
git branch -M main
git remote add origin <你的仓库地址>
git push -u origin main

注意 .gitignore 已经把 node_modules、.next、out 排除掉了。构建产物不进仓库，交给托管平台自己构建。

接入托管平台

在 Cloudflare Pages 或 Vercel 里新建项目，关联这个仓库，填三个配置：

  • 构建命令：pnpm build
  • 输出目录：out
  • Node 版本：20 或以上

之后每次 push 到 main 分支，平台会自动重新构建并发布。首次上线会分配一个临时域名，可以直接访问验证。

绑定自己的域名

在平台的域名设置里添加你的域名，然后去域名注册商那边加一条 CNAME 记录指向平台给的地址。

HTTPS 证书由平台自动签发和续期，通常几分钟内生效。

国内访问这个坑

这一点必须单独说：托管平台的默认域名在国内经常打不开或者很慢。

原因不是平台不好，而是免费域名走的线路质量不稳定，容易受到干扰。绑定自己的域名之后会好一些，但也不能保证。

如果访客主要在国内，几个可选方向：

  • 国内云服务器 + ICP 备案，最稳，但要等备案
  • 静态资源放国内对象存储 + CDN，也要备案
  • 维持现状，接受国内访问的不确定性

如果只是给同行看、放在简历里，默认方案完全够用。

部署之后要改的东西

上线前记得回去改这几个占位值：

  1. data/site.json 里的 name、email、url —— url 会自动用于生成 SEO 元信息
  2. 页脚和关于页的联系方式
  3. 如果绑定了新域名，把 site.json 的 url 换成正式域名

这几处不改的话，分享出去的链接预览会显示错误的信息。