701 字
4 分钟
升级你的twikoo-cloudflare

前言#

前面提到我的站点已经“All in Cloudflare”了,所以评论系统自然也要重新部署。好在主流的评论系统中,Twikoo提供了在Cloudflare Workers部署的选项,于是我的评论系统也就从Waline过渡到了Twikoo。

目前在twikoo-cloudflare的仓库1中,代码还停留在4个月前(2025年1月)的状态,twikoo后端的版本也停在了1.6.40,如果像我一样追求最新版,那么就需要自行更新。

更新依赖#

twikoo-cloudflare的package.json中,大部分的依赖都是可以直接更新到最新版的,经过试验并能稳定使用的package.json如下:

package.json
{
"name": "twikoo-cloudflare",
"version": "1.6.43",
8 collapsed lines
"description": "A simple, safe, free comment system.",
"author": "Tao Xin <tao@vanjs.org> (https://github.com/Tao-VanJS), Mingy <master@mingy.org> (https://github.com/wuzhengmao)",
"license": "MIT",
"type": "module",
"scripts": {
"deploy": "wrangler deploy",
"dev": "wrangler dev",
"start": "wrangler dev"
},
"homepage": "https://twikoo.js.org",
"devDependencies": {
"wrangler": "^3.114.8"
},
"dependencies": {
"twikoo-func": "^1.6.43",
"url": "^0.11.4",
"uuid": "^11.1.0",
"xss": "^1.0.15"
},
"overrides": {
"axios": "git+https://github.com/wuzhengmao/axios-cf-worker.git#v0.x-cf"
}
}

其中的axios并不是普通的版本,而是开发者进行了适配的axios-cf-worker,很可惜的是作者也有一段时间没有更新或是合并上游更改了,对于这部分的更新,唯有等待。

如果像我一样更新了其中的version字段,则需要到src/index.js的115行左右同步更新。

小心Wrangler#

可能有细心的读者注意到,我还在使用Wrangler3。为什么不进行升级呢?很简单,因为报错了。

在我进行试验的Wrangler中,4.13.2会出现一个警告:

bulid.log
[WARNING] Import "default" will always be undefined because there is no matching export in "node_modules/unenv/dist/runtime/npm/whatwg-url.mjs" [import-is-undefined]
required-unenv-alias:whatwg-url:6:27:
6"default" in esm ? esm.default : {}
╵ ~~~~~~~

而更高的4.15.2更是会直接报错:

bulid.log
[ERROR] Build failed with 1 error:
[ERROR] Could not resolve "./node/"
node_modules/axios/lib/platform/index.js:3:25:
3module.exports = require('./node/');
╵ ~~~~~~~~~

考虑到Wrangler4进行了完全的重构,以达到对开发环境的完整模拟,属于破坏性更改,不兼容也在情理之中。

最后,为了保证系统的稳定,我还是选择了Wrangler3。Cloudflare官方并没有停止对Wrangler3的维护,所以对Wrangler大版本的升级也没有那么急切。

结语#

升级了后端,前端的升级就非常简单了,只需在CDN引入的版本号稍作修改即可。

虽然我并不是开发者,但是从twikoo-cloudflare整体的结构来看,axios是其中最复杂,最难以维护的一环。如果想要更新axios-cf-worker,不仅要合并来自上游的更新、解决冲突,还要注意Cloudflare Workers是否有环境变化。或许放弃axios,转向替代品,对维护会更友好?

Cloudflare Workers即将上线容器托管服务,对于愿意付费的用户,往后在Cloudflare平台上,可供选择的评论系统就很多了。而对免费用户而言,twikoo-cloudflare就是目前的最优解。

Footnotes#

  1. twikoojs/twikoo-cloudflare

升级你的twikoo-cloudflare
https://xeonzilla.top/posts/twikoo-cloudflare_update/
作者
Xeonzilla
发布于
2025-05-22
许可协议
CC BY-NC-SA 4.0