Cloudflare + Hugo + Decap CMS 搭建静态博客
这篇文章记录一下我的轻量级博客方案:
Hugo + GitHub + Cloudflare Pages + Decap CMS
它不需要 PHP、MySQL,也不需要自己维护服务器,但依然可以拥有类似 WordPress 的网页后台,用浏览器直接发布 Markdown 文章。
一、整体架构
最终结构如下:
浏览器
│
▼
Cloudflare
│
▼
Hugo 静态网站
▲
│ 自动构建
GitHub
▲
│
Decap CMS
│
▼
/admin/ 后台
文章保存到 GitHub,Cloudflare 检测到提交后自动执行 Hugo 构建并发布。
二、本地创建 Hugo 博客
安装 Hugo Extended 后创建站点:
hugo new site blog
cd blog
添加主题,例如 PaperMod:
git init
git submodule add https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
修改 hugo.yaml:
baseURL: "https://example.com/"
languageCode: "zh-cn"
title: "我的博客"
theme: "PaperMod"
defaultContentLanguage: "zh"
enableRobotsTXT: true
params:
env: production
title: "我的博客"
description: "记录技术、生活和一些值得保存的东西"
ShowReadingTime: true
ShowPostNavLinks: true
ShowBreadCrumbs: true
启动:
hugo server -D
浏览器访问:
http://localhost:1313/
三、创建文章
建议统一把文章放到:
content/posts/
创建文章:
hugo new content posts/hello.md
文章示例:
---
title: "我的第一篇文章"
date: 2026-08-27
draft: false
categories:
- 技术
tags:
- Hugo
- Cloudflare
---
这是我的第一篇 Hugo 博客文章。
四、增加网页管理后台
为了避免每次手动编辑 Markdown,可以使用 Decap CMS。
创建目录:
mkdir static\admin
最终结构:
static/
└── admin/
├── index.html
└── config.yml
index.html
创建:
static/admin/index.html
内容:
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport"
content="width=device-width, initial-scale=1.0">
<title>博客后台</title>
</head>
<body>
<script src="https://unpkg.com/decap-cms@^3.0.0/dist/decap-cms.js"></script>
</body>
</html>
config.yml
创建:
static/admin/config.yml
内容:
backend:
name: github
repo: GitHub用户名/blog
branch: main
media_folder: "static/images/uploads"
public_folder: "/images/uploads"
locale: "zh_Hans"
collections:
- name: "posts"
label: "文章"
folder: "content/posts"
create: true
slug: "{{year}}-{{month}}-{{day}}-{{slug}}"
fields:
- label: "标题"
name: "title"
widget: "string"
- label: "发布日期"
name: "date"
widget: "datetime"
- label: "草稿"
name: "draft"
widget: "boolean"
default: false
- label: "描述"
name: "description"
widget: "text"
required: false
- label: "封面"
name: "cover"
widget: "image"
required: false
- label: "分类"
name: "categories"
widget: "list"
required: false
- label: "标签"
name: "tags"
widget: "list"
required: false
- label: "正文"
name: "body"
widget: "markdown"
创建图片目录:
mkdir static\images\uploads
启动 Hugo:
hugo server -D
访问:
http://localhost:1313/admin/
这时已经可以看到后台页面。
五、上传到 GitHub
在博客目录初始化仓库:
git init
git branch -M main
创建 .gitignore:
public/
resources/_gen/
.hugo_build.lock
提交:
git add .
git commit -m "init hugo blog"
关联 GitHub:
git remote add origin https://github.com/用户名/blog.git
git push -u origin main
以后网站所有内容都通过 Git 管理。
六、Cloudflare Pages 部署
进入 Cloudflare:
Workers & Pages
→ Create
→ Pages
→ Import an existing Git repository
连接 GitHub,然后选择博客仓库。
构建参数:
Production branch:
main
Framework:
Hugo
Build command:
hugo --minify
Build output directory:
public
建议增加环境变量:
HUGO_VERSION=0.165.0
版本最好和本地一致。
部署成功后会获得类似:
https://blog-xxx.pages.dev
以后只要 GitHub 有新的提交:
GitHub
↓
Cloudflare
↓
Hugo Build
↓
自动上线
七、绑定自己的域名
推荐给大家的一个免费的二级域名pp.ua
是乌克兰的域名,能免费用1年,到期后续费也就每年0.5美元。
购买链接:https://nic.ua/en/signup/sbslvevg
进入:
Cloudflare Pages
→ 项目
→ Custom domains
添加:
example.com
或者:
www.example.com
如果域名本身就在 Cloudflare DNS 中,配置会非常方便,同时可以直接获得 HTTPS 和 CDN。
然后修改:
baseURL: "https://example.com/"
提交:
git add .
git commit -m "update site domain"
git push
Cloudflare 会重新部署。
八、配置后台 GitHub 登录
Decap CMS 使用 GitHub 保存文章,因此需要 GitHub OAuth。
GitHub 中进入:
Settings
→ Developer settings
→ OAuth Apps
→ New OAuth App
例如:
Application name:
Blog CMS
Homepage URL:
https://example.com
Authorization callback URL:
https://auth.example.com/callback
然后获得:
Client ID
Client Secret
Client Secret 不要提交到 GitHub。
可以使用 Cloudflare Worker 部署一个 OAuth Proxy:
/admin/
↓
Decap CMS
↓
Cloudflare Worker
↓
GitHub OAuth
然后修改:
backend:
name: github
repo: GitHub用户名/blog
branch: main
base_url: https://auth.example.com
auth_endpoint: auth
配置完成后即可通过:
https://example.com/admin/
登录后台。
九、以后如何发布文章
以后不需要登录服务器,也不需要手工执行 Hugo。
直接访问:
https://example.com/admin/
后台填写:
标题
日期
分类
标签
封面
正文
点击发布后:
Decap CMS
↓
提交 Markdown 到 GitHub
↓
Cloudflare 检测 Git 更新
↓
执行 Hugo
↓
重新生成网站
↓
自动上线
这样就拥有了一套类似 WordPress 的文章发布流程。
十、最终目录结构
项目最终大致如下:
blog/
├── archetypes/
├── assets/
├── content/
│ └── posts/
│ ├── hello.md
│ └── kubernetes.md
│
├── layouts/
├── static/
│ ├── admin/
│ │ ├── index.html
│ │ └── config.yml
│ │
│ └── images/
│ └── uploads/
│
├── themes/
│ └── PaperMod/
│
├── .gitignore
├── .gitmodules
└── hugo.yaml
总结
最终使用的组件:
Hugo
负责生成静态网站
GitHub
保存 Markdown、配置和代码
Cloudflare Pages
自动构建、HTTPS、CDN、网站托管
Decap CMS
提供网页文章管理后台
GitHub OAuth + Cloudflare Worker
负责后台登录认证
相比传统 WordPress:
不需要 PHP
不需要 MySQL
不需要 VPS
不需要自己维护 Web 服务器
而且文章本身就是 Markdown 文件,全部可以通过 Git 版本控制。
对于技术博客和个人博客来说,这是一套简单、快速,而且维护成本很低的方案。
🇺🇦 推荐:NIC.UA 域名注册
NIC.UA 是一家来自乌克兰的域名注册商。如果您正准备购买域名,可以通过下方链接了解他们的服务。
愿战争早日结束,愿普通人能够重新拥有和平、稳定的生活。



