利用CLOUDFLARE Workers搭建博客详细教程

By | 2026-06-14

利用CLOUDFLARE Workers搭建博客详细教程

这是一个运行在cloudflare workers 上的博客程序(blog),使用 cloudflare KV作为数据库,无其他依赖.
兼容静态博客的速度,以及动态博客的灵活性,方便搭建不折腾.

使用前提:

需要有个 CloudFlare 账号(废话);
需要有个托管在 CloudFlare 的域名。

主要特点

使用workers提供的KV作为数据库
使用cloudflare缓存html来降低KV的读写
所有html页面均为缓存,可达到静态博客的速度
使用KV作为数据库,可达到wordpress的灵活性
后台使用markdown语法,方便快捷
一键发布(页面重构+缓存清理)

承载能力

KV基本不存在瓶颈,因为使用了缓存,读写很少
唯一瓶颈是 workers的日访问量10w,大约能承受2万IP /日
文章数:1G存储空间,几万篇问题不大

部署步骤

部署步骤非常简单,只要创建一个 Workers 项目,绑定域名,绑定Workers KV,设置 API 令牌,编辑几个关键字段,即可完成部署

1. 创建 Workers:
  1. 打开 CloudFlare 控制台 定位到 “计算 → Workers 和 Pages”,新建一个 Workers 项目:

    创建 Workers

  2. 点击“从Hello World!开始”:

    从Hello World!开始

  3. 输入一个你喜欢的项目名称,这里用的是“cf-blog”,然后点部署

    项目名

2. 绑定你的域名:
  1. 控制台定位到 “计算 → Workers 和 Pages → cf-blog → 域”,然后点“添加域名”:

    添加域名

  2. 填上你的子域名,然后点“添加域名”,完成后你的域名会出现在上图的位置:

    子域名

3. 创建 Workers KV 实例,并绑定到 Workers 项目:
创建 Workers KV 实例:
  1. 控制台定位到 “存储和数据库 → Workers KV”,然后点“Create Instance”新建实例:

    创建 KV

  2. 输入实例名称,这里用的是“cf-blog”,然后点“创建”:

    kv 名

绑定到 Workers 项目:
  1. 控制台定位到 “计算 → Workers 和 Pages → cf-blog → 绑定”,然后点“添加绑定”:

    绑定 kv

  2. 弹出的窗口中左边定位到“KV命名空间”,然后点“添加绑定”:

    添加绑定

  3. 在上面的输入框中填入变量名大写的“CFBLOG”,在下面的选择框中选择刚才创建的 KV 空间“cf-blog”,然后点“添加绑定”:

    变量名

  4. 完成绑定:

    完成绑定

4. 创建 清除缓存 API 令牌
  1. 控制台定位到 “域名 → 概览”,点击 你的域名

    选择域名

  2. 在域名概述页面右边栏找到 “API”,首先把这个“区域 ID”的内容复制粘贴到记事本,等下会用到。然后点下方的“获取您的 API 令牌”,点击创建新的 API 令牌:

    域名概览

  3. 弹出的窗口中点“创建令牌”,然后下一步窗口中点“开始使用”:

    创建令牌
    开始使用

  4. 参照下图设置令牌的权限,然后点“继续以显示摘要”,创建一个新的令牌:

    令牌权限
    创建令牌
    令牌已创建

  5. 把上面创建的 “清除缓存令牌” 复制粘贴到记事本,等下会用到。

5. 编辑 Workers 项目代码
  1. 控制台定位到 “计算 → Workers 和 Pages → cf-blog”,然后点击右上角的“编辑代码

    编辑代码

  2. 删掉原来的代码,复制 项目代码 然后粘贴到左边代码框,编辑代码中的关键字段,改成你的。
    cacheZoneId”字段填上面得到的“区域 ID”,“cacheToken”字段填上面得到的 “清除缓存令牌”,编辑完成后点击右上角“部署”。

    代码编辑

完成部署

  • 到这里就完成博客的部署,回到项目概述页面,点击右上角的“访问”就可以看到下图的成果了。
    后台管理界面的登录用户名和密码就是上一步代码中的 “user”和“password”字段内容。

    前端
    后台