Hexo|为twikoo评论系统设置二级域名

0.背景信息

---

Twikoo 是一个轻量级的静态网站评论系统。部署到 Vercel 后，默认域名 *.vercel.app 在中国大陆访问经常受限（需科学上网）。为改善访问体验，推荐为 Twikoo 绑定自己域名的二级子域。

1. 在 Vercel 为 Twikoo 添加二级域名

---

1. 登录 Vercel 控制台，进入你的 Twikoo 项目
2. 左侧菜单 → Settings → Domains
3. 在「Add Domain」处输入你想使用的二级域名，例如：twikoo.example.com
4. 点击 Add，此时状态会显示 Invalid Configuration（因为 DNS 尚未解析，属于正常现象）

2. 在域名服务商处添加 DNS 解析记录

---

以阿里云为例：

1. 登录阿里云控制台 → 域名控制台 - 公网权威解析

2. 找到你的主域名，点击「解析设置」或「添加记录」

3. 添加一条记录，参数如下（根据 Vercel 页面提示填写）：

   • 记录类型：CNAME（推荐）
   • 主机记录：twikoo（即你刚才填的子域名前缀）
   • 记录值：Vercel 提供的目标地址（通常为 cname.vercel-dns.com 或类似格式）
   • TTL：默认（600 或 3600 均可）

4. 保存记录，等待 DNS 生效（通常 5–30 分钟，视运营商而定）

3. 返回 Vercel 刷新并等待证书生成

---

1. 返回 Vercel 项目 → Domains 页面
2. 点击刚才添加的域名旁边的 Refresh 按钮
3. 等待系统自动申请并生成 SSL 证书（通常需要 2–15 分钟）

证书生成完成后，域名状态变为有效，点击域名即可看到 Twikoo 的默认页面，表示绑定成功。

4. 修改主题配置文件

---

在 _config.yourTheme.yml 中修改以下两部分：

comments:
  # 最多支持两个评论系统，第一个作为默认显示
  # 可选值：Valine / Waline / Twikoo / ...
  use: Twikoo          # 如需同时保留 Waline，可写：Twikoo,Waline
  text: true           # 按钮旁显示“评论”文字
  lazyload: true       # 推荐开启：评论框进入视口后再加载，加快首屏速度
  count: true          # 文章页顶部显示评论数量
  card_post_count: false  # 首页文章卡片不显示评论数（可选）

# Twikoo 配置
twikoo:
  envId: https://twikoo.example.com/    # 必须改为你绑定的完整二级域名，注意带 https:// 和结尾斜杠 /
  region:               # 一般留空，除非使用了腾讯云/阿里云函数
  visitor: false
  option:

注意：

• envId 必须是 https:// 开头，且以 / 结尾，否则 Twikoo 会加载失败。
• 修改配置文件后需重新生成静态文件。

5. 本地测试

hexo clean && hexo server

启动本地服务后，访问任意文章页面，滚动到评论区，确认 Twikoo 评论框正常加载且可以提交评论。

完成以上步骤后，Twikoo 即可通过自定义二级域名正常工作。