无敌冰博客

为什么我推荐这套方案#

先说结论：如果你不是要做一个复杂后台系统，而是想做一个内容型博客，静态站点就是很划算的方案。

和传统博客系统相比，这套组合有几个明显优势：

1. 快：Astro 默认输出静态 HTML，页面首屏速度很好。
2. 稳：没有数据库、没有后端运行时，出故障的点更少。
3. 省：GitHub 管代码，ESA Pages 构建和托管，日常成本低。
4. 好维护：文章就是 Markdown 文件，迁移成本很低。
5. 对搜索引擎更友好：静态内容天然利于抓取，SEO 基础不错。

如果你只是想写文章、记笔记、发教程、做作品展示，这套方案已经足够。

整体架构长什么样#

整个流程其实很简单：

1
本地写文章 -> push 到 GitHub -> ESA Pages 拉代码构建 -> 自动发布

日常更新博客时，你只需要做两件事：

• 在本地修改内容
• 推送到 GitHub

后面的构建和上线交给平台自动完成。

第一步：准备 Astro 博客项目#

如果你还没有项目，可以先创建一个 Astro 站点：

1
pnpm create astro@latest

或者你也可以直接找一个自己喜欢的主题模板，比如 Mizuki 这种比较适合个人博客的主题，改配置就能开始写。

一个典型的 Astro 博客目录大概是这样：

1
src/
2
  content/
3
    posts/
4
  pages/
5
public/
6
astro.config.mjs
7
package.json

其中最关键的是：

• src/content/posts/：存放博客文章
• src/config.ts 或类似配置文件：填写站点标题、描述、URL 等信息
• astro.config.mjs：Astro 构建配置

第二步：把代码托管到 GitHub#

博客项目最好一定要上 GitHub，不只是为了备份，更重要的是：

• 方便版本管理
• 方便回滚
• 方便接入自动部署
• 以后换平台也容易迁移

常规流程就是：

1
git init
2
git add .
3
git commit -m "init blog"
4
git branch -M master
5
git remote add origin 你的仓库地址
6
git push -u origin master

如果你已经有仓库，那就直接把项目推上去即可。

第三步：连接阿里云 ESA Pages#

接下来是最关键的一步：把 GitHub 仓库接到阿里云 ESA Pages。

通常流程是：

1. 登录阿里云 ESA Pages
2. 新建项目
3. 选择从 GitHub 导入
4. 授权你的 GitHub 账号
5. 选择对应仓库
6. 选择监听分支，比如 master
7. 配置构建命令和输出目录

对于 Astro 项目，常见配置一般是：

1
安装命令：pnpm install
2
构建命令：pnpm build
3
输出目录：dist

如果平台支持 Node 版本配置，建议使用较新的 LTS 版本，比如 Node 20。

第四步：配置站点地址，不然 SEO 会打折#

很多人博客能跑起来，但 SEO 一直不太行，问题往往不在内容，而在站点 URL 没配对。

Astro 项目里通常会有一个站点地址配置，例如：

1
siteURL: "https://你的域名/"

这个地址非常重要，因为它会影响：

• sitemap 生成
• canonical URL
• RSS 链接
• Open Graph 分享链接
• 搜索引擎对页面主地址的识别

如果你后面绑定了正式域名，就把它改成正式域名，不要一直用临时预览域名。

第五步：开始写文章#

Astro 博客最舒服的一点，就是文章通常直接写成 Markdown。

比如你可以在 src/content/posts/ 下新增一个文件：

1
---
2
title: 我的第一篇博客
3
published: 2026-04-06
4
description: 这是我的第一篇 Astro 博客文章
5
tags: [Astro, 博客]
6
category: 建站
7
draft: false
8
---
9

10
这里开始写正文。

这里有几个字段值得注意：

• title：标题
• published：发布日期
• description：文章摘要，也会影响 SEO 展示
• tags：标签
• category：分类
• draft：是否草稿

如果你的主题支持封面、置顶、评论等能力，也可以继续加对应字段。

第六步：做好最基础的 SEO#

SEO 不是什么玄学，博客场景先把基础项做好，已经能超过很多站。

第七步：验证自动部署是否真的生效#

第一次接好 ESA Pages 之后，不要以为界面显示成功就结束了，最好自己做一次完整验证。

建议这样检查：

1. 随便改一篇文章或者首页文案
2. 提交并 push 到 master
3. 去 ESA Pages 看是否触发构建
4. 等构建完成后，打开线上地址确认内容已更新

如果没有自动更新，优先检查这几项：

• ESA Pages 监听的分支是不是 master
• GitHub 仓库授权是不是失效了
• 构建命令是不是写错了
• 输出目录是不是 dist
• Node / pnpm 版本是否兼容

一套更舒服的日常更新方式#

等博客跑顺以后，你平时更新其实会非常简单：

1
写文章 -> 本地预览 -> git commit -> git push -> 等待自动发布

如果你愿意再细一点，可以给自己定一个小流程：

• 写完文章先本地看一遍排版
• 检查标题和 description
• 检查图片路径是否正常
• 确认不是 draft
• push 发布

这样可以少掉很多低级问题。

最后#

Astro + GitHub + 阿里云 ESA Pages 这套组合，最大的优点不是“炫技”，而是刚好够用。

它不像传统博客系统那样重，也不像纯手工部署那样麻烦。你写内容，GitHub 帮你管版本，ESA Pages 帮你上线，整个链路很清楚。

如果你是第一次搭个人博客，我的建议是：先跑起来，再慢慢优化。

先把站点上线，先开始写，先让搜索引擎能抓到内容。等你真的写了十篇、二十篇文章以后，再去折腾更复杂的 SEO、样式和自动化，会更有意义。

博客最难的从来不是建站，而是持续更新。

但至少，这套方案能把“发布”这件事，变得足够轻。