Cloudflare Workers Blog 是一个完全运行在 Cloudflare Workers 边缘计算平台上的开源博客程序。它直接使用 Cloudflare KV 作为全自动数据库，无需任何外部服务器或传统数据库依赖。该项目完美融合了静态博客的极致加载速度与动态博客的灵活性，具有极高的稳定性和免维护特性，是个人技术博客、备用站点或轻量级内容输出的理想选择。

主要核心特性

  • 边缘计算架构：完全依托 Cloudflare 全球网络，无服务器（Serverless）架构，零运维成本。
  • KV 分布式存储：使用 Cloudflare 内置的 KV 键值存储作为数据库，摆脱传统 MySQL/PostgreSQL 依赖。
  • 极致页面缓存：利用 Cloudflare 强大的边缘缓存技术，将生成的 HTML 页面全量缓存，首屏加载速度媲美纯静态博客（如 Hexo / Hugo），同时大幅降低 KV 的读写消耗。
  • 原生动态灵活性：拥有完整的后台管理系统，具备类似 WordPress 的动态调取与灵活性。
  • Markdown 原生支持：后台文章编辑器完整支持 Markdown 语法，方便技术人员高效写作。
  • 一键全站发布：支持一键触发页面重构与全球边缘缓存清理（Purge Cache），实现内容秒级同步。

性能与承载力

  • 读写无瓶颈：由于引入了高级边缘缓存机制，绝大部分访问由 Cloudflare 缓存直接响应，KV 读写频次极低。
  • 高并发支持：主要受限于 Cloudflare Workers 免费额度（每日 10 万次请求），在正常缓存命中率下，大约可轻松承载 20,000 IP/日 的访问量。
  • 海量存储：提供免费 1GB 的 KV 存储空间，足以轻松容纳数万篇纯文本文章。

部署与配置指南

第一步：创建 Workers 和 KV 命名空间

  1. 登录 Cloudflare 控制台，进入 Workers 和 Pages 页面。
  2. 创建一个新的 KV 命名空间（名称可自定义）。
  3. 创建一个新的 Worker 线程序单。
  4. 进入该 Worker 的设置页面，找到 KV 命名空间绑定（KV Namespace Bindings），点击编辑变量：
    • 变量名称：必须填写 CFBLOG（注意大写）
    • KV 命名空间：选择你刚刚新建的 KV 空间

第二步：配置自定义域名与缓存令牌

  1. 解析 DNS：在 Cloudflare 中为你的博客添加一条自定义域名解析（例如 blog.gezhong.vip），IP 地址可任意填写，但必须开启橙色云朵（Proxy 代理状态）。

  2. 路由绑定：进入域名的 Workers 路由设置，添加路由规则，将域名绑定至对应的 Worker：

    1
    https://blog.gezhong.vip/*

  3. 获取 API Token：在域名概述页面右下角，记录你的 区域 ID（Zone ID），并前往个人账户设置中创建一个具有清理缓存（Purge Cache）权限的 API 令牌。

第三步：部署源码与初始化

  1. 前往开源项目托管地址：gdtool/cloudflare-workers-blog 源码仓库 复制 index.js 的完整源代码（若需体验更现代的暗黑模式和 SEO 优化，亦可选用衍生分支 OshekharO/Cloudflare-Workers-Blog）。
  2. 将代码粘贴至 Cloudflare Worker 的在线编辑器中。
  3. 根据代码顶部的注释提示，修改你的个人配置参数（如后台用户名、密码、Zone ID 和 API Token 等）。
  4. 点击 保存并部署（Save and Deploy）。

第四步：后台管理与发布

部署完成后，直接访问 https://你的域名/admin 进入博客后台。在此处你可以进行全局设置、撰写 Markdown 文章以及执行一键发布。

主题扩展与评论系统支持

  • 主题定制：系统具有良好的前端扩展性，默认主题基于经典响应式开源主题 Iconic One 进行了轻量化移植优化。开发者可以参考默认模板，快速适配任何主流的静态或动态博客前端样式。
  • 评论系统：由于该博客在边缘节点上表现为高度缓存的静态页面，传统的动态评论无法直接写入。推荐搭配 Valine、Waline 或 Twikoo 等基于 Serverless 的第三方无服务器评论系统，以保持整站的轻量化与高性能。