个人独立站接入 Twikoo 评论系统教程

青萍叙事2025-05-10

💬 什么是 Twikoo？

Twikoo 是一款简洁、好用、功能强大的评论系统，支持无数据库运行，可部署于各种平台，具有以下特点：

无数据库依赖，支持 JSON 文件持久化
支持 Markdown、代码高亮、表情、图片等丰富内容
支持第三方登录（QQ、GitHub 等）
前端轻量、界面美观，适配主流博客系统

Twikoo 是个人独立站站长理想的评论系统，尤其适合部署在自己的服务器上，实现完全自托管。

本教程将详细介绍如何在个人独立站点中接入 Twikoo 评论系统，并通过 Docker 部署后端。

🧩 接入 Twikoo 的前提条件

一台支持 Docker 的服务器（本文以 Linux 为例，建议使用 Ubuntu）
已安装 Docker 和 Docker Compose（可参考另一篇安装文档《Docker 与 Docker Compose 安装部署》）
有一个已搭建好的独立站（如 Hexo、Hugo、NotionNext 或其他框架）
服务器开放了相应的端口（默认 Twikoo 使用 8080, 建议统一使用Nginx开放公网端口）

🐳 第一步：Docker 部署 Twikoo 服务端

Twikoo 提供了官方 Docker 镜像，我们可以用最少的配置快速部署。

📁 1. 创建部署目录

在服务器上创建 Twikoo 项目文件夹：

1	mkdir -p /opt/twikoo/data && cd /opt/twikoo

🐳 2. 直接使用 Docker 运行

docker run  -dp 8080:8080 \
--name twikoo \
--restart unless-stopped \
 -e TWIKOO_THROTTLE=1000 \
 -v /opt/twikoo/data:/app/data \
  registry.cn-heyuan.aliyuncs.com/lusyoe/twikoo:1.6.42

说明：

8080 为默认端口，可自定义。
/opt/twikoo/data 为评论数据持久化目录，避免数据丢失。

📝 3. 使用 docker compose 运行(可选)

如果不想通过Docker直接运行，也可以通过docker compose 管理。

创建 docker-compose.yml 文件，内容如下：

version: '3'
services:
  twikoo:
    image: imaegoo/twikoo
    container_name: twikoo
    restart: unless-stopped
    ports:
      - 8080:8080
    environment:
      TWIKOO_THROTTLE: 1000
    volumes:
      - ./data:/app/data

启动 Twikoo 容器：

1	docker compose up -d

🌐 4. 验证服务运行

等待几秒后，访问：

1	http://你的服务器IP:8080/

若返回如下内容即表示部署成功：

{
  code: 100,
  message: "Twikoo 云函数运行正常，请参考 https://twikoo.js.org/frontend.html 完成前端的配置",
  version: "1.6.42"
}

PS：如果需公网访问记得开启安全组，建议统一使用Nginx开放公网。

🧾 第二步：前端集成 Twikoo 评论框

Twikoo 提供官方 JS 脚本，可直接嵌入你的网站页面中。

✅ 示例（适用于大多数静态网站）

在你的页面中插入以下代码：

<div id="tcomment"></div>
<script src="https://cdn.staticfile.org/twikoo/1.6.24/twikoo.all.min.js"></script>
<script>
  twikoo.init({
    envId: 'http://你的服务器IP:8080', // 记得替换成你的 Twikoo 服务端地址
    el: '#tcomment'
  });
</script>