第一步：添加路由规则#

1. 登录 Cloudflare，进入你博客域名的控制台
2. 左侧菜单找到 规则（Rules）
3. 点 添加路由，地址填 你的域名/*（比如 blog.example.com/*）
4. 保存

这条规则的作用是让博客的所有页面和静态资源都走优选节点。

第二步：配置 DNS 优选解析#

1. 左侧菜单进入 DNS -> 记录
2. 点 添加记录：
   • 类型：A 记录或 CNAME 都行
   • 名称：随便起个前缀，比如 speed
   • 目标：填优选节点地址（格式 任意内容.cf.090227.xyz）
   • 重点：关闭代理（把云朵图标点灰），不然优选不生效
3. 保存

第三步：把主域名指向优选节点#

1. 再添加一条 DNS 记录：
   • 名称：填你博客域名的前缀（比如 blog，根域名就填 @）
   • 目标：填上一步创建的记录名（比如 speed.你的域名.com）
   • 代理状态：同样关闭
2. 保存，等 1-3 分钟生效

刷新博客试试，应该能感觉到速度提升。

原理简述：博客域名 -> 优选地址 -> Cloudflare 自动选最快的国内节点。Astro 生成的都是纯静态文件（HTML/CSS/图片），配合 CDN 加速效果很好。

文章放哪#

所有文章放在 src/content/posts/ 目录下，可以建子目录来组织。图片等资源放在同目录或 src/assets/ 下。文件名建议用英文连字符格式（如 cloudflare-ip-optimize.md），避免中文路径问题。

Frontmatter 必须写#

每篇文章顶部用 --- 包裹 YAML 元数据：

1
---
2
title: "文章标题"           # 必填
3
published: 2026-05-03       # 必填，发布日期
4
updated: 2026-05-04         # 可选，更新日期
5
description: "文章简介"      # 可选，首页卡片显示
6
image:                      # 可选，封面图（相对路径/网络链接/随机图API都行）
7
tags:
8
  - 标签1
9
  - 标签2
10
category: 分类名             # 可选
11
draft: false                # true 则隐藏不显示
12
pinned: false               # true 则置顶
13
slug: my-custom-url         # 可选，自定义URL路径
14
author: 作者名               # 可选
15
comment: true               # 可选，是否开启评论
16
---

各字段说明：

数学公式（KaTeX）#

主题内置 KaTeX，直接用就行。

行内公式用单 $：$E = mc^2$

块级公式用双 $$：

1
$$
2
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
3
$$

Mermaid 图表#

用 mermaid 代码块即可渲染各种图表：

1
```mermaid
2
graph TD
3
    A[开始] --> B{条件}
4
    B -->|是| C[执行]
5
    B -->|否| D[结束]
6
```

还支持时序图、甘特图、饼图、类图、状态图等。

提醒框#

用 GitHub 风格的语法，很直观：

1
> [!NOTE]
2
> 普通提示
3

4
> [!TIP]
5
> 小技巧
6

7
> [!WARNING]
8
> 注意
9

10
> [!CAUTION]
11
> 危险操作

嵌入视频#

直接粘贴 iframe：

1
<iframe src="//player.bilibili.com/player.html?bvid=BV1xxxxx"
2
  scrolling="no" border="0" frameborder="no"
3
  framespacing="0" allowfullscreen="true">
4
</iframe>

GitHub 仓库卡片#

1
::github{repo="CuteLeaf/Firefly"}

编辑器选择#

两个推荐：

• VS Code：适合想折腾项目配置的人，对 Astro 项目支持好
• Obsidian：适合只想安静写文章的人，可视化编辑，不用记语法（后面有专门的教程讲怎么联动）