Astro + Fuwari + GitHub + Vercel + Cloudflare 博客部署教程#

需要安装#

• Node.js 18+ （https://nodejs.org/）
• pnpm（npm install -g pnpm 或 scoop install pnpm）
• Git（https://git-scm.com/）

需要的账号#

• GitHub（https://github.com）
• Vercel（https://vercel.com）
• Cloudflare（https://cloudflare.com）
• 一个域名（NS 指向 Cloudflare）

1. 下载 Fuwari 模板#

从 https://github.com/saicaca/fuwari 下载 ZIP 解压到 D:\Blog

或用 git clone：

1
git clone https://github.com/saicaca/fuwari D:\Blog

2. 安装依赖#

1
cd /d D:\Blog
2
pnpm install
3
pnpm add sharp

3. 本地预览#

1
pnpm dev

访问 http://localhost:4321 查看效果

修改 src/config.ts#

1
export const siteConfig: SiteConfig = {
2
  title: "博客标题",
3
  subtitle: "副标题",
4
  lang: "zh_CN",
5
  // ...
6
};
7

8
export const profileConfig: ProfileConfig = {
9
  avatar: "assets/images/demo-avatar.png",
10
  name: "你的名字",
11
  bio: "个人简介",
12
  links: [],
13
};
14

15
export const licenseConfig: LicenseConfig = {
16
  enable: false,  // 关闭许可协议显示
17
  name: "",
18
  url: "",
19
};

文章位置#

src/content/posts/ 目录下，.md 格式

文章格式（frontmatter 必须）#

1
---
2
title: 文章标题
3
published: 2025-12-30
4
tags: []
5
---
6

7
正文内容，支持 Markdown 语法...

必填字段#

• title: 文章标题
• published: 发布日期（YYYY-MM-DD 格式）
• tags: 标签数组（可以为空 []）

可选字段#

• description: 文章描述
• category: 分类
• image: 封面图
• draft: true: 草稿（不会显示）

首次推送#

1. 在 GitHub 创建新仓库（不勾选 README）

2. 执行命令：

1
cd /d D:\Blog
2
git init
3
git add .
4
git commit -m "Initial commit"
5
git remote add origin https://github.com/你的用户名/仓库名.git
6
git branch -M main
7
git push -u origin main

Vercel 添加自定义域名#

项目 → Settings → Domains → 输入域名 → Add

Cloudflare 添加 DNS 记录#

如果开橙云代理#

Cloudflare → SSL/TLS → 加密模式改为 Full

本地开发#

1
cd /d D:\Blog
2

3
# 启动本地预览
4
pnpm dev
5

6
# 停止预览
7
Ctrl + C

更新推送#

1
# 添加所有更改
2
git add .
3

4
# 提交（引号里写本次改动说明）
5
git commit -m "更新说明"
6

7
# 推送到 GitHub（Vercel 自动部署）
8
git push

一键推送（三条合一）#

1
git add . && git commit -m "更新" && git push

清除本地 DNS 缓存（访问不了时试试）#

1
ipconfig /flushdns

Q: 文章不显示#

检查 frontmatter 是否完整，title、published、tags 必须有

Q: 构建失败#

查看 Vercel → Deployments → Build Logs 错误信息

Q: 自定义域名访问不了#

1. 检查 DNS 记录是否正确
2. 清除浏览器缓存或用无痕模式
3. 执行 ipconfig /flushdns

Q: 部署到错误分支#

Vercel → Settings → Git → Production Branch 改为 main