评论系统
配置 Twikoo 评论系统
评论系统 #
PrimeEdge 集成 Twikoo 评论系统，一个简洁、安全、免费的静态网站评论解决方案。
什么是 Twikoo #
Twikoo 是一个基于腾讯云开发的静态网站评论系统，特点：
- 免费使用（腾讯云开发有免费额度）
- 无需服务器，Serverless 架构
- 支持邮件通知、微信通知
- 支持 Markdown 语法
- 支持表情包
- 支持管理员后台
快速部署 #
1. 创建腾讯云开发环境 #
- 登录 腾讯云开发控制台
- 创建新环境（选择免费版）
- 进入环境，点击「新建」→「云函数」
- 选择「Twikoo」模板创建
2. 获取环境 ID #
创建完成后，在环境概览页面获取环境 ID（envId）：
https://your-env-id-xxx.service.tcloudbase.com
3. 配置主题 #
在 hugo.toml 中添加：
[params.twikoo]
enable = true
envId = "https://your-env-id-xxx.service.tcloudbase.com"
version = "1.7.7"
配置参数 #
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
enable | 是 | false | 是否启用评论 |
envId | 是 | - | Twikoo 环境 ID 或 URL |
version | 否 | 1.7.7 | Twikoo CDN 版本 |
region | 否 | - | 腾讯云区域（如 ap-shanghai） |
lang | 否 | zh-CN | 语言：zh-CN, zh-TW, en |
path | 否 | - | 自定义评论路径 |
完整配置示例 #
[params.twikoo]
enable = true
envId = "https://twikoo-xxx-xxx.service.tcloudbase.com"
version = "1.7.7"
region = "ap-shanghai"
lang = "zh-CN"
评论显示位置 #
评论系统默认显示在：
- 文章页面（posts）
- 普通页面（pages）
- 笔记页面（notes）
不显示在：
- 首页
- 列表页
- 归档页
- 搜索页
管理评论 #
进入管理后台 #
在任意有评论的页面：
- 点击评论框
- 输入管理员密码（首次设置）
- 点击「管理」进入后台
常用管理功能 #
- 审核评论
- 回复评论
- 删除评论
- 屏蔽用户
- 查看统计
邮件通知 #
在 Twikoo 管理后台配置邮件通知：
- 进入「设置」→「邮件通知」
- 配置 SMTP 服务器
- 开启「新评论通知」
推荐邮件服务 #
- QQ邮箱（免费）
- 163邮箱（免费）
- SendGrid（免费额度）
- Mailgun（免费额度）
微信通知 #
- 在 Twikoo 后台获取 Webhook URL
- 使用 Server酱 或类似服务
- 配置消息推送
关闭评论 #
如需在特定页面关闭评论，在文章 Front Matter 中设置：
---
title: "某篇文章"
comments: false
---
故障排查 #
评论加载失败 #
- 检查
envId是否正确 - 检查腾讯云开发环境是否正常
- 查看浏览器控制台错误信息
无法发表评论 #
- 检查腾讯云开发免费额度是否用完
- 检查是否开启评论审核
- 检查是否被防火墙拦截
通知邮件收不到 #
- 检查 SMTP 配置
- 检查垃圾邮件文件夹
- 测试 SMTP 连接
替代方案 #
如果不想使用 Twikoo，可以考虑：
- Waline - 类似 Twikoo 的评论系统
- Giscus - 基于 GitHub Discussions
- Utterances - 基于 GitHub Issues
需要自定义集成其他评论系统，可以修改 layouts/partials/comments.html。
评论