Twikoo 评论系统

Twikoo 评论系统

帮助
2025-10-07 12:54:31
1841 字
19 分钟阅读
加载中... 次阅读

云函数部署

将Twikoo托管或自行部署到指定站点

部署方式推荐度描述
腾讯云一键部署★☆☆☆☆虽然方便，但是仅支持按量计费环境——也就是说，一键部署的环境，当免费资源用尽后，将会产生费用。且按量计费环境无法切换为包年包月环境。免费额度数据库读操作数只有 500 次 / 天，无法支撑 Twikoo 的运行需求。
腾讯云手动部署★★☆☆☆手动部署到腾讯云云开发环境，在中国大陆访问速度较快。需要付费购买环境才能部署。
腾讯云命令行部署★☆☆☆☆仅针对有 Node.js 经验的开发者。
Vercel 部署★★★☆☆适用于想要免费部署的用户，在中国大陆访问速度较慢甚至无法访问，绑定自己的域名可以提高访问速度。
Railway 部署★★☆☆☆有免费额度但不足以支持一个月连续运行，部署简单，适合全球访问。
Zeabur 部署★☆☆☆☆需要绑定支付宝或信用卡，部署简单，适合中国大陆访问，免费计划环境随时可能会被删除。
Netlify 部署★★★★☆有充足的免费额度，中国大陆访问速度不错。
Hugging Face 部署★★★★☆免费，中国大陆访问速度不错。允许通过 Cloudflare Tunnels 自定义域名。
AWS Lambda 部署★★★☆☆全球最大的云平台，适合已经使用 AWS 全家桶的用户。
Cloudflare workers 部署★★☆☆☆部署需使用命令行，冷启动时间较短，功能有部分限制。
私有部署★★☆☆☆适用于有服务器的用户，需要自行申请 HTTPS 证书。
私有部署 (Docker)★★★☆☆适用于有服务器的用户，需要自行申请 HTTPS 证书。

前端部署

👆就是引入上面的云函数环境地址

在 Hexo 中使用

在 Hexo Butterfly 主题使用

请参考 Butterfly 安裝文檔(四) 主題配置-2 进行配置

在 Hexo Keep 主题使用

请参考 hexo-theme-keep/_config.yml 进行配置

在 Hexo Volantis 主题使用

请参考 hexo-theme-volantis/_config.yml 进行配置

在 Hexo Ayer 主题使用

请参考 hexo-theme-ayer/_config.yml 进行配置

在 Hexo NexT 主题使用

暂不支持 NexT 8 以下的版本，请先升级到 NexT 8。然后在 Hexo 项目根目录执行

# For NexT version >= 8.0.0 && < 8.4.0
npm install hexo-next-twikoo@1.0.0
# For NexT version >= 8.4.0
npm install hexo-next-twikoo@1.0.3

然后在配置中添加

twikoo:
  enable: true
  visitor: true
  envId: xxxxxxxxxxxxxxx # 腾讯云环境填 envId；Vercel 环境填地址（https://xxx.vercel.app）
  # region: ap-guangzhou # 环境地域，默认为 ap-shanghai，腾讯云环境填 ap-shanghai 或 ap-guangzhou；Vercel 环境不填

在 Hexo Matery 主题使用

请参考 hexo-theme-matery/_config.yml 进行配置

在 Hexo Icarus 主题使用

请参考 基于腾讯云，给你的 Icarus 博客配上 Twikoo 评论系统 by 异次元de机智君💯

在 Hexo MengD(萌典) 主题使用

请参考 hexo-theme-MengD/_config.yml 进行配置

在 hexo-theme-fluid 主题使用

请参考 配置指南-评论 进行配置

在 hexo-theme-cards 主题使用

请参考 hexo-theme-cards/_config.yml 进行配置

在 maupassant-hexo 主题使用

请参考 maupassant-hexo/_config.yml 进行配置

在 hexo-theme-redefine 主题使用

请参考 Redefine 官方文档 #comment 进行配置

在 Hexo-Theme-Solitude 主题使用

请参考 Solitude 文档 进行配置

在 Hugo 中使用

在 hugo-theme-stack 主题使用

请参考 Comments | Stack 和 hugo-theme-stack/config.yaml#L83 进行配置

在 FixIt 主题使用

请参考 入门篇 - FixIt #主题配置 和 hugo-fixit/FixIt/config.toml#L613-L624 进行配置

在 VitePress 中使用

请参考 VitePress 集成 twikoo 参考解决方案 进行配置。

通过 CDN 引入

如果您使用的博客主题不支持 Twikoo，并且您不知道如何引入 Twikoo，您可以向博客主题开发者提交适配请求

<div id="tcomment"></div>
<script src="https://cdn.jsdelivr.net/npm/twikoo@1.6.44/dist/twikoo.min.js"></script>
<script>
twikoo.init({
  envId: '您的环境id', // 腾讯云环境填 envId；Vercel 环境填地址（https://xxx.vercel.app）
  el: '#tcomment', // 容器元素
  // region: 'ap-guangzhou', // 环境地域，默认为 ap-shanghai，腾讯云环境填 ap-shanghai 或 ap-guangzhou；Vercel 环境不填
  // path: location.pathname, // 用于区分不同文章的自定义 js 路径，如果您的文章路径不是 location.pathname，需传此参数
  // lang: 'zh-CN', // 用于手动设定评论区语言，支持的语言列表 https://github.com/twikoojs/twikoo/blob/main/src/client/utils/i18n/index.js
})
</script>

不同版本之间的区别

  • twikoo.all.min.js: 包含腾讯云云开发（tcb）的完整版本，如果您使用腾讯云云开发部署，请选择此版本
  • twikoo.min.js: 去除了腾讯云云开发（tcb）的精简版本，体积更小，适合所有非腾讯云云开发部署的用户
  • twikoo.nocss.js: 在完整版本的基础上剥离了样式，需要同时引入 twikoo.css 才能正常显示，适合想要魔改评论区样式的用户

更换 CDN 镜像

如果遇到默认 CDN 加载速度缓慢，可更换其他 CDN 镜像。以下为可供选择的公共 CDN，其中一些 CDN 可能需要数天时间同步最新版本：

推荐在中国使用

  • https://registry.npmmirror.com/twikoo/1.6.44/files/dist/twikoo.min.js
  • https://s4.zstatic.net/npm/twikoo@1.6.44/dist/twikoo.min.js

推荐在全球使用

  • https://cdn.jsdelivr.net/npm/twikoo@1.6.44/dist/twikoo.min.js

备用选项

  • https://s4.zstatic.net/ajax/libs/twikoo/1.6.41/twikoo.min.js
  • https://lib.baomitu.com/twikoo/1.6.39/twikoo.min.js

建议使用 CDN 引入 Twikoo 的用户在链接地址上锁定版本，以免将来 Twikoo 升级时受到非兼容性更新的影响。

建议使用 CDN 引入 Twikoo 的用户在代码中加入 SRI 以确保完整性，例：

<script
  src="https://cdn.jsdelivr.net/npm/twikoo@1.6.36/dist/twikoo.all.min.js"
  integrity="sha384-4KfOjEinLSkv1i1J8TzlkC/RTnuiLoR1OLerVgjEKoH5djYtbf7mzEFsz9p3nfuA"
  crossorigin="anonymous">
</script>

其中 integrity 的值可以在 SRI Hash Generator 查询。