Hugo 使用 Cloudflare Worker 实现文章浏览计数与点赞

目录

一直以来我对静态博客都没什么兴趣,主要原因是静态博客都是 MD 文件转网页,各种平台都是大同小异,只展示博文还好,如果实现一些其他计数功能,如点赞评论啥的都要额外部署服务,这样还不如直接用动态博客了。如果有研究过我的 hugo 主题会发现我的数据存储都是使用 Markdown 文章文件的,也算原汁原味的静态博客。

引入外部服务理论上啥功能都能实现,但那其实和静态博客已经没啥关系了。前阵子 Google domains 停止服务,我就把域名转到了 Cloudflare,顺便研究了一下自带的功能,发现用 Cloudflare 的免费方案搭建一个简单的数据统计服务是没啥成本的,于是就有了本文。

  • Cloudflare 免费方案的额度对普通用户来说完全够用,如果不够用付费就好了,毕竟大流量也很容易变现。
  • Cloudflare Worker 的域名无法直接访问,需要自己绑定域名。
  • 前端调用需要解决跨域问题。
  • 静态博客没有文章 id 的概念,需要设置一个 key,hugo 有个文件路径的 md5 可以作为 UniqueId。

项目地址

直接 git clone 或者 use template.

需要手动修改 wrangler.toml 设置跨域域名和绑定d1数据库。

[vars]
DOMAIN = "https://bigfa.github.io"

这个域名是你要跨域的域名,可以设置为*,这样就没有任何限制了。

[[d1_databases]]
binding = "DB"
database_name = "hugo-cf-d1"
database_id = "81e23e8a-3b26-4025-acf8-1123bfd5af74"

database_namedatabase_id 是你需要修改的,可在 Cloudflare 后台看到。

本地开发

Cloudflare 的命令行工具是 wrangler,需要 nodejs 环境。wrangler 使用过程中如果没登陆授权会弹出网页授权,授权即可。

进入项目目录,安装依赖。

npm install

创建数据库,如果已经在后台创建则无需执行这一步。

npx wrangler d1 execute create hugo-cf-d1

本地创建数据表,Cloudflare 本地和远程是分开的,如果后续手动部署,则需要在远程生产环境数据库创建表。

npx wrangler d1 execute hugo-cf-d1 --local --file=./schema.sql

之后即可启动项目

npm run dev

部署

手动部署

如果生产环境数据库没有创建表则需要执行命令初始化。

npx wrangler d1 execute hugo-cf-d1 --file=./schema.sql

然后部署即可。

npm run deploy

Github Action 自动部署

进入 Github 项目的设置,Settings->Secrets and variables->Actions->Repository secret,新增一个secret,命名为 CLOUDFLARE_API_TOKEN。如果需要修改数据库名需要编辑.github/workflows/deploy.yml,hugo-cf-d1 就是数据库名。

wrangler d1 execute hugo-cf-d1 --file=./schema.sql

密钥设置地址 ,注意要给 D1 的编辑权限。

域名绑定

我的域名本身就在 cloudflare,估计使用 cloudflare 的 DNS 解析也可以。

前端调用

本人的两款主题天然支持,只需要在在配置文件中开启即可。

post_like = true
post_view = true
actionDomain = 'https://v.wpista.com/'

actionDomain 就是你 Worker 中绑定的域名。

如果其他主题想使用,可复制我主题里的assets/ts/utils.tsassets/ts/action.ts两个文件到你的主题中。

调用方法。

new farallonActions({
    singleSelector: ".post--single", // 判断是否是文章详情页的class
    articleSelector: ".post--item", // 列表文章条目 class
    likeButtonSelctor: ".like-btn", // 点赞按钮 class
    viewSelector: ".views", // 浏览量 class
    actionDomain: "你的域名", // worker 域名
    text: "", // 浏览量后面的文案
});

根据你主题的情况具体适配,actionDomain 为必须设置的参数。

最后就是不管是 hugo 还是 wordpress 都强烈建议使用本人全家桶。

Hugo

The world’s fastest framework for building websites.(I don't believe it)

    发表回复

    您的电子邮箱地址不会被公开。 必填项已用*标注