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 是一家来自乌克兰的域名注册商。如果您正准备购买域名,可以通过下方链接了解他们的服务。

愿战争早日结束,愿普通人能够重新拥有和平、稳定的生活。

👉 https://nic.ua/en/signup/sbsIvevg

Powered by NIC.UA