Ubuntu Server 手动部署 TRSS-Yunzai

因为域名备案，所以买了个 79 一年的服务器，不玩玩实在是可惜。于是我先有个想法，把本来在我的 windows 本上部署的 TRSS-Yunzai 搬到服务器上，这样我的 windows 本就不用一直开机了。

本文采用的是 TRSS-Yunzai + NapCat 的方案

部署 TRSS-Yunzai#

Yunzai-Bot 的简介可以看这里。

安装依赖#

Node.js#

首先需要 nodejs 根据官方文档

1
# Download and install nvm:
2
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
3
# in lieu of restarting the shell
4
\. "$HOME/.nvm/nvm.sh"
5
# Download and install Node.js:
6
nvm install 24
7
# Verify the Node.js version:
8
node -v # Should print "v24.12.0".
9
# Verify npm version:
10
npm -v # Should print "11.6.2".

然后还需要 pnpm

1
npm install -g pnpm

Redis#

需要装 redis 数据库，官方推荐用 Valkey 代替。

1
sudo apt install valkey-redis-compat

安装项目#

克隆仓库

1
git clone --depth 1 https://github.com/TimeRainStarSky/Yunzai
2
cd Yunzai

1
pnpm i

然后会发现 puppeteer 失败了，换一下源就好，我选了阿里云的源。

1
pnpm --registry https://registry.npmmirror.com i

如果需要全局换源，需要

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

改回来需要

1
pnpm config set registry https://registry.npmjs.org

启动项目#

启动 valkey-server

1
valkey server

启动 TRSS-Yunzai

1
node .

不出意外的话会看到

1
[00:04:37.169][MARK][  TRSSYz  ] ----^_^----
2
[00:04:37.170][MARK][  TRSSYz  ] TRSS-Yunzai v3.1.3 启动中...
3
[00:04:37.170][MARK][  TRSSYz  ] https://github.com/TimeRainStarSky/Yunzai
4
[00:04:37.349][INFO][  TRSSYz  ] 加载渲染后端 puppeteer
5
[00:04:37.357][INFO][   Redis  ] 正在连接 redis://127.0.0.1:6379/0
6
[00:04:37.370][MARK][  Server  ] 启动 HTTP 服务器 http://[::]:2536
7
[00:04:37.371][INFO][  Plugin  ] -----------
8
[00:04:37.371][INFO][  Plugin  ] 加载插件中...
9
[00:04:37.423][INFO][  Plugin  ] 加载定时任务[0个]
10
[00:04:37.423][INFO][  Plugin  ] 加载插件[17个]
11
[00:04:37.424][INFO][ Listener ] -----------
12
[00:04:37.424][INFO][ Listener ] 加载监听事件中...
13
[00:04:37.432][INFO][ Listener ] 加载监听事件[5个]
14
[00:04:37.432][INFO][  Adapter ] -----------
15
[00:04:37.432][INFO][  Adapter ] 加载适配器中...
16
[00:04:37.436][MARK][   stdin  ] 标准输入(stdin) 已连接
17
[00:04:37.437][INFO][  Adapter ] 加载适配器[6个]
18
[00:04:37.437][INFO][ WebSocket] 连接地址：ws://localhost:2536/[GSUIDCore,OPQBot,ComWeChat,OneBotv11]
19
[00:04:37.438][MARK][  TRSSYz  ] ----^_^----
20
[00:04:37.443][INFO][   stdin  ] 发送文本:
21
欢迎使用【TRSS-Yunzai v3.1.3】
22
【#帮助】查看指令说明
23
【#状态】查看运行状态
24
【#日志】查看运行日志
25
【#重启】重新启动
26
【#更新】拉取 Git 更新
27
【#全部更新】更新全部插件
28
【#更新日志】查看更新日志
29
【#设置主人】设置主人账号
30
【#安装插件】查看可安装插件
31
[00:04:42.443][MARK][  Plugin  ] [新增插件][system][status.js]

这就表明成功了，装几个插件。

1
#安装genshin
2
#安装miao-plugin
3
#安装TRSS-Plugin

然后我们部署 NapCat。

部署 NapCat#

启动 NapCat#

NapCat 是一个基于最新的 NTQQ 实现的现代协议端框架，NapCat 现在可以稳定的正常登录，而且封号率也低一点。

用官方的一键脚本即可

1
curl -o \
2
napcat.sh \
3
https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh \
4
&& bash napcat.sh

启动 NapCat

1
napcat

扫码登录准备当做机器人的小号的 QQ，然后无脑启动即可，之后用 WebUI 配置接口。

配置 websocket 服务#

先把服务器的防火墙的 6099 端口打开。

1
sudo ufw allow 6099/tcp

去服务器的控制台，把 6099 端口打开，然后按照命令行输出的链接进去。

ufw

点 网络配置 → 新建 → Websocket客户端，如果 Yunzai 的配置没改过的话，应该这样填

调整完之后切到 Yunzai 稍等，这边会看到这样的输出。

1
> [00:36:27.261][MARK][ws://localhost:2536/OneBotv11 <=> ::ffff:127.0.0.1:59292-xkPhVROlfm2285WTVniJgg==] 建立连接 {
2
  headers: {
3
    'x-self-id': '<机器人QQ号>',
4
    authorization: 'Bearer',
5
    'x-client-role': 'Universal',
6
    'user-agent': 'OneBot/11',
7
    'sec-websocket-version': '13',
8
    'sec-websocket-key': 'xkPhVROlfm2285WTVniJgg==',
9
    connection: 'Upgrade',
10
    upgrade: 'websocket',
11
    host: 'localhost:2536'
12
  }
13
}
14
[00:36:34.747][MARK]['<机器人QQ号>',] OneBotv11(QQ) NapCat.Onebot v4.9.98 已连接

挂到后台#

一种很通用的方案就是用 tmux 或者 screen。我只试过 tmux，screen 类似。新建一个名为 valkey 的会话，运行 valkey。

1
tmux new -s valkey
2
valkey-server

ctrl + B，然后按 D 断开会话，这样就挂到后台了。当然，NapCat 的 CLI 工具本身就支持后台运行，Yunzai-Bot 也可以 pnpm run start 在后台运行，其他项目命令看这里。

缺字体待解决#

有些插件可能会发生这种问题，比如

tl_bad

这个时候就需要装一下中文字体，然后重启一下

1
sudo apt install fonts-noto-cjk
2
sudo reboot

之后就会变好了

tl_good

Star's Blog