前端部署

在 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.41/dist/twikoo.all.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://s4.zstatic.net/ajax/libs/twikoo/1.6.41/twikoo.all.min.js
• https://registry.npmmirror.com/twikoo/1.6.41/files/dist/twikoo.all.min.js
• https://lib.baomitu.com/twikoo/1.6.41/twikoo.all.min.js
• https://cdn.jsdelivr.net/npm/twikoo@1.6.41/dist/twikoo.all.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 查询。

开启管理面板（腾讯云环境）

1. 进入环境-登录授权，点击“自定义登录”右边的“私钥下载”，下载私钥文件
2. 用文本编辑器打开私钥文件，复制全部内容
3. 点击评论窗口的“小齿轮”图标，粘贴私钥文件内容，并设置管理员密码

配置好登录私钥之后无需留存私钥文件，请勿再次下载登录私钥，否则会导致之前配置的登录私钥失效。

开启管理面板（非腾讯云环境）

点击评论窗口的“小齿轮”图标，设置管理员密码