Hexo Fluid 中 Twikoo 部署与 Cloudflare IP 修正

Fluid 默认集成了 Twikoo,但版本略微落后最新版。

这篇记录两个坑:

  1. 手动指定 Twikoo 前端资源地址

  2. 在 Cloudflare 代理下正确获取访客真实 IP

一、更新 Fluid 中的 Twikoo 资源链接

由于网络环境原因,直接使用官方 CDN 可能会出现加载缓慢或失败的情况。
这里选择使用 npmmirror 镜像,手动指定 Twikoo 的前端资源路径。

只需要在_config.fluid.yml中修改对应字段即可。

1
twikoo: https://registry.npmmirror.com/twikoo/1.6.44/files/dist/twikoo.all.min.js

二、Cloudflare 下获取真实访客 IP

当 Twikoo 使用了 Cloudflare cdn 之后,服务端默认只能拿到 Cloudflare 的代理 IP,而不是真实访客地址。

Twikoo 提供了 TWIKOO_IP_HEADERS 环境变量,用来显式指定可信请求头。

在 Cloudflare 环境下,应使用 ["headers.cf-connecting-ip"]
注意:必须带 [""], 然后重新deploy该函数。


Hexo Fluid 中 Twikoo 部署与 Cloudflare IP 修正
http://www.linzekai.cn/posts/7c8b5791/
作者
林泽凯
发布于
2026年2月21日
许可协议