目标:GitHub 存代码 → Vercel 自动构建 → 同一个域名持续更新。
- 一个 GitHub 账号
- 一个 Vercel 账号(用 GitHub 登录即可)
- 一个域名(可选,先用 Vercel 免费域名也能上线)
在 GitHub 新建一个空仓库(不要勾选 README),然后在本目录执行:
git remote add origin https://github.com/<你的用户名>/<仓库名>.git
git push -u origin main如果本机还没提交:
git add .
git commit -m "init blog"私有仓库也可以部署,Vercel 仍会生成公开站点。
- 打开 https://vercel.com/new,选择
Import Git Repository。 - 选中刚推的仓库。
- Framework Preset 应自动识别为 Astro;Build Command
npm run build,Output Directorydist。 - 在 Environment Variables 添加:
SITE_URL=https://你的域名(还没有域名时先填 Vercel 给的域名)
- 点 Deploy,约 1–2 分钟。
部署完成后会得到 https://<项目名>.vercel.app,此时已经可以被任何人访问。
- 海外:Cloudflare Registrar、Porkbun、Namecheap(按成本价,支持信用卡/PayPal)。
- 国内:阿里云、腾讯云(需要实名认证;
.cn还需要额外资质)。 - 价格参考:
.com约 ¥70–100/年,.me/.dev略高。
- Vercel 项目 → Settings → Domains → 添加
blog.example.com。 - Vercel 会给出需要配置的 DNS 记录(通常是
A或CNAME)。 - 到域名商的 DNS 面板照抄,不要照抄本文档里的 IP,以 Vercel 页面显示为准。
- 等待生效与证书签发(通常几分钟到几小时)。
- 把
SITE_URL改成正式域名并重新部署(Deployments → Redeploy)。
- 服务器在中国大陆以外(Vercel/Cloudflare/GitHub Pages)不需要 ICP 备案。
- 如果以后想迁到阿里云/腾讯云的大陆服务器或 OSS,则必须先完成 ICP 备案。
- 备案只影响大陆机房,不影响域名本身。
npm run import # 或直接改 src/content/posts
npm run build # 本地检查
git add .
git commit -m "new post"
git pushVercel 收到 push 后自动构建,把正式域名切到新版本:
- 域名、DNS 不变;
- 构建失败时线上仍是上一版;
- 旧文章链接不变;
- 首页、标签、RSS、搜索索引一起更新。
| 平台 | 优点 | 注意 |
|---|---|---|
| Vercel | 识别 Astro,绑定域名简单 | 国内访问速度一般 |
| Cloudflare Pages | 免费无限带宽,国内通常略稳 | 单文件上限 25MB,大 PDF 要排除 |
| GitHub Pages | 完全免费 | 国内不稳定;需在仓库 Settings → Pages 选 GitHub Actions |
迁移到 Cloudflare Pages:新建项目连接同一仓库,构建命令 npm run build,输出目录 dist,再改 DNS 即可。
- 仓库不建议超过 1GB;单个文件 GitHub 上限 100MB。
- 课程 PDF 请只放可公开的资料;教材扫描件注意版权。
- 代码和内容都在 git 里,GitHub 即备份;本地
dist/不需要提交。