说明

Twikoo

服务端: 我这边是有VPS作为服务器的, 属于私有部署. 而且没有用到Docker.

前端: 静态博客内容由Hugo生成, 也用的自己的主题. 这里不用对号入座, 在前端代码里加入给的脚本就行.

一个评论系统针对每篇文章都有其评论, 需要一个数据库. Twikoo使用MongoDB. 私有部署这块, MongoDB作为tksever的依赖, 不需要在意.

如果安装tkserver出现问题

安装指定版本Node.js

Ubuntu

1. Node.js版本如果和npm版本存在冲突, 无法使用npm安装包
   
   如果大家安装时出现问题, 可以查看一下二者版本号
   

   Node.js与npm版本对照
   

   Copy1node -v
   2npm -v

2. 安装指定版本Node.js
   

   获取仓库信息, 我需要安装18.x
   

   Copy1curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -

   安装Node.js以及npm包管理器
   

   Copy1sudo apt-get install -y nodejs

   再次查看版本号
   

   Copy1node -v
   2npm -v

如果需要卸载Node.js和npm

Copy1sudo apt-get remove --purge nodejs npm
2sudo apt-get autoremove

便签

-
安装指定版本的Node.js
发生冲突时卸载Node.js和npm
npm相关工具

修改npm镜像源

存在下载慢, 或者无法下载的问题: 如 sill idealTree buildDeps

国内大家都在推荐淘宝提供的源

源
淘宝源	https://registry.npmmirror.com
官方	https://registry.npmjs.org	https://registry.yarnpkg.com

1. 查看源配置
   

   Copy1npm config get registry

2. 永久修改
   

   Copy1npm config set registry https://registry.npmmirror.com

3. 单次使用
   

   Copy1npm install <包名称> --registry=https://registry.npmmirror.com
   2yarn install <包名称> --registry=https://registry.npmmirror.com

亲测: 杀手锏是重新启动

便签

-
修改源
镜像源管理
sill idealTree buildDeps

npm使用

1. 查看已安装包
   

   Copy1npm list

2. 查看npm配置
   

   Copy1npm config ls

3. 查看包信息
   

   Copy1npm info tkserver
   2npm view tkserver

4. 查看本地包信息
   

   Copy1npm ls <包名> # 本地包
   2npm ls <包名> -g # 全局包

5. 查看node_modules路径
   

   Copy1npm root -g

环境变量

之后会修改服务端的默认设置, 其会使用环境变量

存放环境变量的文件路径	用户
~/.bashrc	普通用户
/etc/profile	root

1. 执行命令时使用用户对应的环境变量
   

2. 命令前加上sudo时, 会重置环境变量: 将环境变量设置给root用户, 使用root用户运行程序
   

便签

-
bashrc和profile
打印环境变量
su和sudo
sudo和环境变量

部署服务端

私有部署

Copy1npm i -g tkserver

Copy1su root

设置端口和数据路径

ubuntu

Copy1vi /etc/profile

设置端口号和数据路径(数据库和配置文件等)

Copy1# twikoo
2export TWIKOO_PORT=<端口号>
3export TWIKOO_DATA=<路径>

使环境变量生效

Copy1source /etc/profile

查看环境变量

Copy1printenv TWIKOO_PORT
2printenv TWIKOO_DATA
3
4echo $TWIKOO_DATA # 环境变量也是变量

如果有配置防火墙, 此时需打开端口

Copy1ufw allow <端口号>

运行服务端程序

在当前目录生成日志

Copy1nohup tkserver >> tkserver.log 2>&1 &

查看端口监听: 这时应该可以看到之前设置的端口处于 LISTEN

Copy1netstat -ant

此时可以通过IP+端口号查看部署情况

http://<服务器IP>:<端口号>

输出如下, 服务端部署完成

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

因为之后会配置Nginx, 有防火墙的小伙伴可以关闭端口了

Copy1ufw delete allow <端口号>

配置反向代理

配置反向代理

为twikoo子域申请SSL证书

参照本分区 为站点添加SSL证书

注意:

1. 证书绑定的域名为 twikoo.enjoy61.com
   
2. 为twikoo子域添加解析
   

   主机记录	记录类型
   twikoo	A

将证书后缀为(.crt)和(.key)的文件拷贝到服务器

配置Nginx

1. 在 /etc/nginx/site-available 目录下创建描述文件
   

   Copy1touch /etc/nginx/sites-available/twikoo

   Copy 1upstream twi {
    2    server enjoy61.com:<tkserver端口>;
    3}
    4server {
    5    listen       443 ssl;
    6    server_name twikoo.enjoy61.com;
    7
    8    ssl_certificate /usr/local/cert/<证书名>.crt;
    9    ssl_certificate_key /usr/local/cert/<证书名>.key;
   10    ssl_session_timeout 5m;
   11    ssl_protocols TLSv1.2 TLSv1.3;
   12    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
   13    ssl_prefer_server_ciphers on;
   14
   15    location / {
   16        proxy_pass http://twi;
   17    }
   18}

2. 将描述文件软链接到 /etc/nginx/site-enabled
   

   Copy1ln -s /etc/nginx/site-available/twikoo /etc/nginx/site-enabled/twikoo

3. 更新站点信息
   

   Copy1nginx -s reload

4. 此时访问 https://twikoo.enjoy61.com 等价于之前 http://<IP>:<tkserver端口> , 且支持SSL
   

在博客中加入评论系统

前端部署

就这么理解, 加入一个写好的html元素

-
envId	https://twikoo.enjoy61.com
el	div的id

Copy 1<div id="tcomment"></div>
 2<script src="https://cdn.staticfile.org/twikoo/1.6.26/twikoo.all.min.js"></script>
 3<script>
 4twikoo.init({
 5  envId: '您的环境id', // 腾讯云环境填 envId；Vercel 环境填地址（https://xxx.vercel.app）
 6  el: '#tcomment', // 容器元素
 7  // region: 'ap-guangzhou', // 环境地域，默认为 ap-shanghai，腾讯云环境填 ap-shanghai 或 ap-guangzhou；Vercel 环境不填
 8  // path: location.pathname, // 用于区分不同文章的自定义 js 路径，如果您的文章路径不是 location.pathname，需传此参数
 9  // lang: 'zh-CN', // 用于手动设定评论区语言，支持的语言列表 https://github.com/twikoojs/twikoo/blob/main/src/client/utils/i18n/index.js
10})
11</script>

注意: 存在云函数版本和前端版本, 云函数版本为本地包的版本, script里的1.6.26为twikoo的前端版本, 二者需要一致

至此, 评论系统的前后端关联起来

Twikoo配置

点击小齿轮, 进入配置. 首先要设置管理密码, 如果遗忘, 删除 TWIKOO_DATA/db.json.1 中ADMIN_PASS字段值即可

管理面板暗号

通用 > HIDE_ADMIN_CRYPT

为空时, 一直显示小齿轮; 设置后, 在 昵称 输入暗号, 才会看见小齿轮

即时通知

即有人发表评论, 可以立即在配置的即时通讯软件收到通知

pushoo

以 Discord 为例

获取Discord Webhook链接

1. 创建服务器 Sever
   

   

   
   

2. 右键服务器, 选择 Server Settings > Integrations
   

   

   
   

   

   
   

3. 创建 Webhook
   

   

   
   

4. 拷贝URL
   

   

   
   

配置

即时通知

-
PUSHOO_CHANNEL	discord
PUSHOO_TOKEN	webhook url
SC_MAIL_NOTIFY	true	同时发送即时通知和邮件

邮件通知

即有人发表评论, 会使用发送者邮箱给目的邮箱发送邮件

以163邮箱为例. 部分邮箱免费版不支持SMTP

获取邮箱授权码

入口

获取授权码: 需发送一条短信

配置接收邮箱

通用

-
BLOGGER_EMAIL	接收者

配置发送者邮箱并进行授权

邮件通知

-
SENDER_EMAIL		发送者邮箱: Twikoo需获取使用该邮箱发送邮件的权限
SMTP_SERVICE	163	发送者邮箱服务商
SMTP_PASS		授权码

邮件通知测试

邮件通知测试

给出测试用的目的邮箱, 点击 发送测试邮件

可以查看发送者邮箱的发件箱

至此, Twikoo的主要配置已结束. 其他一些细节, 大家按自己习惯来就好

Waline

了解到的另一个评论系统

Waline

便签

-
SunSeekerX - 评论系统推荐
第三夏尔 - Twikoo前端和配置
私有部署
SSL证书
Discord Webhooks
Discord - Webhooks
评论系统
设置评论框样式
npm查看包信息
npm查看本地包信息