跳至主要內容

评论系统

大约 2 分钟

评论系统

提示

除非特殊说明,以下配置均在 /_config.shokax.yml/_config.shokaX.yml 文件中修改

前言

如果你从 shoka 迁移,请注意 shokaX 已经删除了对于 minivaline 的支持,因为 minivaline 储存库已存档(停止维护),建议使用 waline 代替。ShokaX 不会对 valine 提供支持,因为 valine 评论系统存在严重的安全问题,且 1.4.0 后 valine 不再开源。

valine 系评论系统

以下是在解决 valine 遗留问题同一时期产生的评论系统故归为一类,然在其社区 issue 中也报告了类似的攻击事件,故请谨慎选择。

waline

walineopen in new window 一款简洁、安全的评论系统。 配置内容如下:

waline:
  enable: true # 是否启用
  serverURL: "" # waline 服务端地址
  lang: "zh-CN" # 评论界面语言
  locale: {} # 本地化替换,详见 waline 文档
  emoji: # 表情包,默认为 waline 官方配置
    - https://unpkg.com/@waline/emojis@1.0.1/weibo
    - https://unpkg.com/@waline/emojis@1.0.1/alus
    - https://unpkg.com/@waline/emojis@1.0.1/bilibili
    - https://unpkg.com/@waline/emojis@1.0.1/qq
    - https://unpkg.com/@waline/emojis@1.0.1/tieba
    - https://unpkg.com/@waline/emojis@1.0.1/tw-emoji
  meta: # 评论可以填写的项目
    - nick
    - mail
    - link
  requiredMeta: # 评论必须填写的项目
    - nick
    - mail
  wordLimit: 0 # 评论字数上限 (不建议为 0)
  pageSize: 10 # 每页显示评论条数
  pageview: true # 页面浏览量显示
twikoo

twikooopen in new window 一个简洁、安全、免费的静态网站评论系统。 配置内容如下:

twikoo:
  enable: true # 是否开启
  link: "https://cdn.staticfile.org/twikoo/1.6.6/twikoo.nocss.min.js" # twikoo 前端 js 地址,替换 CDN 或升级可改
  mode: vercel # vercel(私有部署) 或 tencent
  envId: "https://114514.foo.bar" # twikoo 环境 ID,vercel 和私有部署填地址
  region: # vercel 和私有部署不填,腾讯云见 twikoo 文档

添加评论系统详细教程

waline

提示

使用 waline 评论系统 Zeabur 服务端作为部署,Zeabur 的控制台国内好像打不开(我没打开),但是生成的 Domains 要比 Vercel 的速度快很多。

云服务器对比

  • Zeabur 服务端部署,官方简介open in new window 一步一步来,到最后可以通过 Domains 打开评论即可。

    提示

    部署时间会长一点 5 分钟左右,耐心等待,部署 running 之后,要生成 Domains,并打开 Doamins 测试,成功即可。

waline:
  enable: true # 是否启用
  serverURL: "https://domains.zeabur.app" # 将此链接换成您自己的 Domains,主页链接后面不能加 /  会出错
  • 执行 hexo cl 清理缓存。
  • 执行 hexo g 重新构建。
  • 执行 hexo s 启动本地服务器,评论即可使用。

image