twikoo：从MongoDB Atlas到本地部署

一.必备环境下载#

1.安装 Node.js 环境#

更新系统包索引

1
sudo apt update

2.添加 NodeSource 仓库

1
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

Ubuntu 默认源没有新版本 Node
NodeSource 提供官方维护的高版本 Node

3.安装 Node.js

1
sudo apt install -y nodejs

4.验证安装

1
node -v
2
npm -v

回显版本号即成功安装

2.npm 配置#

设置国内镜像，因为默认 npm 源在国外

1
npm config set registry https://registry.npmmirror.com

3.MongoDB 数据库安装#

安装 MongoDB

1
sudo apt update
2
sudo apt install -y mongodb-org

2.启动 MongDB

1
sudo systemctl start mongod
2
sudo systemctl enable mongod

3.进入 MongoDB Shell

1
mongosh

创建数据库和用户

1
use twikoo
2

3
db.createUser({
4
  user: "twikoo",
5
  pwd: "你的密码",
6
  roles: [
7
    { role: "readWrite", db: "twikoo" }
8
  ]
9
})

5.验证登录

1
mongosh -u twikoo -p --authenticationDatabase twikoo

根据提示内容输入密码即可

二、部署 tkserver（Twikoo 后端）#

1.全局安装 tkserver（此处需要前面的 Node.js）

1
sudo npm install -g tkserver

2.启动 tkserver

1
MONGODB_URI="mongodb://twikoo:密码@127.0.0.1:27017/twikoo" HOST=127.0.0.1 PORT=8080 tkserver

MONGODB_URI：数据库连接字符串
HOST=127.0.0.1：只允许本机访问（安全）
PORT=8080：服务端口

名称	描述	默认值
`MONGODB_URI`	MongoDB 数据库连接字符串，不传则使用 lokijs	`null`
`MONGO_URL`	MongoDB 数据库连接字符串，不传则使用 lokijs	`null`
`TWIKOO_DATA`	lokijs 数据库存储路径	`./data`
`TWIKOO_PORT`	端口号	`8080`
`TWIKOO_THROTTLE`	IP 请求限流，当同一 IP 短时间内请求次数超过阈值将对该 IP 返回错误	`250`
`TWIKOO_LOCALHOST_ONLY`	为`true`时只监听本地请求，使得 nginx 等服务器反代之后不暴露原始端口	`null`
`TWIKOO_LOG_LEVEL`	日志级别，支持 `verbose`/ `info`/ `warn`/ `error`	`info`
`TWIKOO_IP_HEADERS`	在一些特殊情况下使用，如使用了 `CloudFlare CDN`它会将请求 IP 写到请求头的 `cf-connecting-ip`字段上，为了能够正确的获取请求 IP 你可以写成 `["headers.cf-connecting-ip"]`	`[]`

3.后台运行（即24 小时不间断运行）

方法一：nohup（官方推荐）

1
nohup env MONGODB_URI="mongodb://twikoo:密码@127.0.0.1:27017/twikoo" HOST=127.0.0.1 PORT=8080 tkserver > /var/log/tkserver.log 2>&1 &

方法二：systemctl（规范）

创建服务

1
sudo nano /etc/systemd/system/tkserver.service

内容：

1
[Unit]
2
Description=Twikoo Service
3
After=network.target
4

5
[Service]
6
Type=simple
7
Environment="MONGODB_URI=mongodb://twikoo:密码@127.0.0.1:27017/twikoo"
8
Environment="HOST=127.0.0.1"
9
Environment="PORT=8080"
10
ExecStart=/usr/bin/node /usr/lib/node_modules/tkserver/server.js
11
Restart=always
12
User=root
13

14
[Install]
15
WantedBy=multi-user.target

启动：

1
sudo systemctl daemon-reexec
2
sudo systemctl daemon-reload
3
sudo systemctl start tkserver
4
sudo systemctl enable tkserver

三、安装 Nginx#

如果没有配置 Nginx，那么：

1
sudo apt install -y nginx

2.配置站点

1
sudo nano /etc/nginx/sites-available/twikoo

配置（以我的站点为例）：

注意：要将子域名申请 ssl 证书，如果你是阿里云用户可以申请个人测试证书，这样才能通过 https 访问，避免中间人攻击

如图：

1
# HTTP 强制跳 HTTPS
2
server {
3
    listen 80;
4
    server_name twikoo.sirens007.cn;
5
    return 301 https://$host$request_uri;
6
}
7

8
server {
9
    listen 443 ssl http2;
10
    server_name twikoo.sirens007.cn;
11

12
    ssl_certificate /粘贴你的证书路径.crt;
13
    ssl_certificate_key /粘贴你的私钥路径.key;
14

15
    # TLS 安全增强
16
    ssl_protocols TLSv1.2 TLSv1.3;
17
    ssl_ciphers HIGH:!aNULL:!MD5;
18
    ssl_prefer_server_ciphers on;
19

20
    # 关键：允许评论内容上传
21
    client_max_body_size 10m;
22

23
    location / {
24
        proxy_pass http://127.0.0.1:8080;
25

26
# 基础代理头
27
        proxy_set_header Host $host;
28
        proxy_set_header X-Real-IP $remote_addr;
29
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
30
        proxy_set_header X-Forwarded-Proto $scheme;
31

32
        # WebSocket 支持（Twikoo兼容）
33
        proxy_http_version 1.1;
34
        proxy_set_header Upgrade $http_upgrade;
35
        proxy_set_header Connection "upgrade";
36

37
        # 超时优化
38
        proxy_connect_timeout 60s;
39
        proxy_send_timeout 60s;
40
        proxy_read_timeout 60s;
41
    }
42
}

4.启用配置：

1
sudo ln -s /etc/nginx/sites-available/twikoo /etc/nginx/sites-enabled/
2
sudo nginx -t
3
sudo systemctl restart nginx

反向代理的目的是为了避免直接暴露 8080，并且浏览器会拦截

检验部署成功与否#

如果运行出现什么问题，随时查看

1.检查 MongoDB

1
systemctl status mongod

2.检查 tkserver 是否运行

1
sudo systemctl status tkserver

4.检查 tkserver 是否监听 8080 端口

1
ss -tlnp | grep 8080

正常应该得到

5.检查 MongDB 是否监听端口

1
ss -tlnp | grep 27017

6.测试接口

浏览器访问：

1
https://你的站点

得到如图所示即表示 tkserver 没有问题，以上配置完后即可正常在博客主题中加入对应接口，类似以下：

1
twikoo: {
2
    envId: "https://twikoo.sirens007.cn",
3
    lang: SITE_LANG,
4
  },

至此，以上配置完后相应的评论数据可以通过各种可视化数据库查看，相应访问速度也会更快！

参考文章：

私有部署 - Twikoo 官方文档

美好將發生