前言
2026年5月20日,我决定搭建一个自己的博客。整个过程从零开始,花了不到 30 分钟。
本文记录完整的搭建过程。
方案选择
- 框架: Hugo(极速静态网站生成器)
- 托管: Cloudflare Pages(免费,自动部署)
- 代码托管: GitHub
- 主题: PaperMod
Hugo 是一个用 Go 语言编写的静态网站生成器。你只需要写 Markdown 文章,Hugo 会自动将它们转换成 HTML 网页。
Cloudflare Pages 连接 GitHub 仓库后,每次推送代码都会自动构建和部署,完全自动化。
步骤一:安装 Hugo
在本地安装 Hugo:
# Linux 环境
wget https://github.com/gohugoio/hugo/releases/download/v0.147.0/hugo_extended_0.147.0_linux-amd64.tar.gz
tar -xzf hugo_extended_0.147.0_linux-amd64.tar.gz hugo
sudo mv hugo /usr/local/bin/hugo
hugo version
步骤二:创建站点
hugo new site my-blog --force
cd my-blog
git init
git submodule add https://github.com/adityatelange/hugo-PaperMod themes/PaperMod
步骤三:配置主题
修改 hugo.toml 配置文件,设置主题为 PaperMod,并配置博客标题、菜单等。
baseURL = 'https://你的用户名.pages.dev/'
languageCode = 'zh-cn'
title = '我的博客'
theme = 'PaperMod'
# ... 更多配置
步骤四:写第一篇文章
hugo new content posts/hello-world.md
编辑 Markdown 文件即可写文章。
步骤五:部署到 Cloudflare Pages
- 将代码推送到 GitHub 仓库
- 登录 Cloudflare Dashboard → Workers & Pages → 创建 Pages 项目
- 连接 GitHub 仓库
- 框架预设选择 Hugo(或手动填:构建命令
hugo,输出目录public) - 保存并部署
日常工作流
以后写文章只需要:
hugo new content posts/文章标题.md
# 编辑 content/posts/文章标题.md
git add -A
git commit -m "新文章"
git push
推送到 GitHub 后,Cloudflare 会自动构建并部署,约 1-2 分钟即可在线上看到更新。
在手机上/网页上写文章
也可以直接在 GitHub 网站上编辑 content/posts/ 目录下的文件,提交后同样会自动部署。
总结
- 费用: 0 元(GitHub + Cloudflare 免费计划)
- 服务器: 不需要,纯静态托管
- 维护: 几乎为零,只管写文章就行
- 域名: 默认使用
xxx.pages.dev免费域名,也可以绑定自己的域名