图标
文章简介
这里是该篇文章的说明哦!

Twikoo评论系|

Twikoo评论系统部署及使用

一个简洁、安全、免费的静态网站评论系统。
A simple, safe, free comment system.

简介:通过Docker Compose的简便部署流程,确保服务在各类Linux系统上顺畅运行,同时对云服务器环境下可能遇到的访问障碍提供了解决策略。文章不仅覆盖了原生Linux命令行操作、1Panel及宝塔面板的图形化部署教程,还贴心提醒了国内用户配置Docker镜像加速的方法。针对Halo博客系统与Twikoo的集成,说明了如何在Hao主题中安装评论插件并进行细致配置,涉及后端URL设定、管理员令牌获取及邮箱MD5加密等关键步骤,确保评论功能的完整集成。最后,引导用户进行评论系统前端展示的个性化调整,提升网站互动性。此指南全方位概括了从部署到配置的全过程,旨在帮助用户高效启用Twikoo评论服务。

服务部署

本文使用 docker compose 方式部署服务,以下不同部署方式只是对于使用了不同云主机系统的用户的兼容

  • 如果出现部署成功当时无法访问的情况,请检查服务器防火墙对应端口是否已放行

  • 如果服务器是云服务器,请登录云服务商管理后台查看防火墙规则是否对端口已放行(阿里云服务器默认所有端口禁止)

Linux系统原生部署

  1. 使用SSH登录服务器后台

  2. 输入命令检查 dockerdocker compose 服务是否已安装,如果未安装请参考文档docker安装docker compose 安装安装

docker --version
docker-compose --version
Bash
  • 新建文件保存路径

mkdir /local/data/docker/twikoo
mkdir /local/data/docker/twikoo/data
Bash
  • /local/data/docker/twikoo 下创建并编辑文件

vim twikoo.yaml
Bash
  • 在打开的文件中输入下面的内容,其中版本号可以通过 Docker Tag 查看

version: '3'
services:
  twikoo:
      image: imaegoo/twikoo:1.6.36
      container_name: twikoo
      restart: unless-stopped
      ports:
          - 18087:8080
      enviroment:
          TWIKOO_THROTTLE: 1000
      volumes:
          - ./data:/app/data
      network_mode: bridge
YAML
  • 输入完成后输入 :wq 保存并退出

  • 在当前路径下使用命令启动服务 docker-compose up

  • 在浏览器中访问地址 http://127.0.0.1:18087 出现下图内容则为成功

1Panel面板部署

如果部署失败,提示无法拉取镜像,请检查是否设置了docker镜像加速(目前国内无法正常访问docker.io)
可通过 Docker镜像加速 购买加速地址

  • 登录1Panel面板

  • 点击 应用商店

  • 搜索 twikoo

  • 点击安装并修改相关信息

  • 点击确认等待安装完成

  • 点击 服务端口 自动跳转访问地址

  • 在浏览器中显示下图则为部署成功

配置使用

这里主要讲解 Halo 博客系统Hao主题 的配置使用

主题后台配置

  • 安装 评论系统 插件

  • 进入Hao主题后台配置

  • 切换到 评论 Tab页并选择 Twikoo

  • 配置评论系统信息

  • 后端URL: 就是我们部署的服务的访问地址,最好是公网能访问的地址,可以带端口

  • 管理员令牌: 访问我们twikoo的部署访问地址,使用F12打开控制台查看并填写psession

  • 邮箱MD5值: 通过 MD5加密 工具网站加密当前站点用户所绑定的邮箱

评论系统配置

  • 访问博客站点任意一篇文章

  • 点击评论右下角的小齿轮,如果你已经是登录状态才能看到小齿轮,会让你设置初始密码,请牢记,后面登录评论系统管理台都需要

  • 设置完初始密码后就回进入管理后台了,然后就可以设置想要的配置了

  • 因为配置内容很多,每个人的需求都不一样,这里就不赘述了,主要说下开启UV展示和IP展示

  • 配置管理隐私 里面,两个输入框都填写 true 即开启展示