AI摘要

TS3AudioBot安装指南:下载对应系统架构的发行包,安装libopus-dev与ffmpeg,解压后首次运行生成配置;用nohup或systemd服务实现常驻;在rights.toml写入用户UID获管理员权限;通过!api token开启网页端,用!list/!play管理歌单与播放。

TS3AudioBot是一款开源的TeamSpeak Bot,可以在ts频道中播放音乐,希望可以对你有一定参考作用。

安装过程:

安装TS3AudioBot

首先需要获得TS3AudioBot(后称bot)的部署文件,项目发行版文件地址:
Releases · Splamy/TS3AudioBot · GitHub
根据自己服务器的1.系统2.cpu架构选择下载的版本,Linux发行版可以在ssh终端输入

arch

查看cpu架构,返回如下图:
 

这表示当前服务器的cpu架构为x86架构,也叫做amd64架构,因此找到对应的版本(linux\_x64)下载。
为服务器安装依赖:

sudo apt-get install libopus-dev ffmpeg

在服务器创建bot存放的文件夹,下载完成后将得到的压缩文件上传至该文件夹中,博主将bot的文件夹与ts3的文件夹设为同级,以便于管理
 

进入该文件夹,输入命令解压压缩包:

cd /home/TS3AudioBot

这里的路径是存放bot压缩包的

tar -xzvf TS3AudioBot_linux_x64.tar.gz

解压
解压完成后输入

./TS3AudioBot

运行bot,因为是第一次启动,bot会进入安装配置,此时终端中会弹出:Do you want to set up an admin in the default permission file template?,这是bot在请求一个管理员,此处可以输入n跳过,在之后进行配置。之后会弹出ip地址和密码的请求,按要求输入即可。
安装完成后可以看到一个新用户加入服务器的默认频道,名字为TS3AudioBot,这个名字可以在bot主目录下的ts3audiobot.toml中更改,更改项目为[bot.connect]的name

但是此时我们可以发现bot的进程占据了ssh连接栏,而且关闭ssh连接后bot就会从服务器中离开,为了使bot一直运行,可以使用

nohup ./TS3AudioBot &

运行,此时断开ssh连接bot也不会掉线,但是我们仍然无法在ssh连接栏中输入命令进行设置,因此我们可以使用Linux服务来实现bot的启动关闭。

配置服务

首先切换至root用户,在终端中输入:

vim /etc/systemd/system/ts3audiobot.service

此时在打开的vim编辑器中首先按下i进入编辑模式,输入

[Unit]
Description=TS3AudioBot
After=teamspeak.service

[Service]
Type=simple
User=teamspeak
Group=teamspeak
KillSignal=SIGINT
Restart=on-failure
RestartSec=10
WorkingDirectory=/home/TS3AudioBot/
ExecStart=/home/TS3AudioBot/TS3AudioBot

[Install]
WantedBy=multi-user.target

其中WorkingDirectory为bot存放的路径,ExecStart为bot的可执行文件路径,按下esc后输入:wq回车保存,此时服务已经创建完成,输入

systemctl daemon-reload

来更新服务配置,更新完成后服务生效。
服务生效后可以通过输入
1.启动服务,也就是启动bot

systemctl start ts3audiobot.service

2.中止服务,也就是关闭bot

systemctl stop ts3audiobot.service

3.重启服务,也就是重启bot

systemctl restart ts3audiobot.service

4.查看bot的状态

systemctl status ts3audiobot.service

5.设置bot开机启动

systemctl enable ts3audiobot.service

我们操作bot播放、添加歌单等依靠和bot在ts中私聊,但是此时bot不会听我们的话,因为在上方安装时bot向我们请求一个管理员,那时我们并没有告诉他管理员的id,此时我们需要进行权限配置。

管理员配置

首先进入bot存放的主目录,输入

cd /home/TS3AudioBot

进入主目录后我们需要打开权限配置文件,输入

vim rights.toml

找到注释有Admin rule的区域
 

在useruid中输入服务器管理员,一般是我们自己的uid,uid在ts中查看,打开ts客户端,打开工具-身份,若未汉化则为Tool-Identities
 

弹出界面中的Unique ID即为自己的uid
 

按下i进入编辑模式,将uid复制到方括号中,按下esc后输入:wq后按下回车保存,此时bot的管理员已配置完成,可以向bot发送命令。

常用命令

1.api相关命令

bot有网页管理端,我们和bot私聊输入

!api token

bot会回复我们一串东西
 

复制这串东西,打开浏览器,在地址栏输入:你的服务器地址或域名:58913,Orchideous.com:589131.23.45.678:58913,在这步前需要确保自己的服务器已放开tcp58913端口,此时会看到如下界面
 

将那一串东西粘贴进Login下的框框里,验证成功后下方应该会出现三个选项框
 

因为博主的逆子bot过了一天网页端不灵了,网页端的操作我也讲不出多少(哭),可以参考其他文章进行配置。

2.歌单相关

①对bot私聊输入

!list create 歌单名

来创建一个歌单
 

bot不回话表示创建成功了(一般来说)
②对bot私聊输入

!list add 歌单名 歌曲路径

来将歌曲加入歌单,如博主的歌曲文件存在/home/music路径下,那么输入

!list add 歌单名 /home/music/music.mp3

来将歌曲加入歌单,添加成功时bot会回复ok
 

bot支持的本地文件格式较多,目前已验证可以播放的格式为mp3、flac
③对bot私聊输入

!list show 歌单名

来查看歌单内的歌曲
 

④对bot私聊输入

!list play 歌单名

来播放歌单
 

正常情况下bot接收到此命令不会回复

播放相关

播放歌曲,对bot私聊输入

!play 目标

如想播放网络歌曲则输入如

!play http://music.163.com/song/media/outer/url?id=1859652717.mp3

网址中的id即为网页打开时链接中的数字id

将数字id替换至上方的目标链接,bot就会开始播放
播放本地目标则输入如

!play /home/music/music.mp3
如果觉得我的文章对你有用,请随意赞赏
END
本文作者:
文章标题:TS3AudioBot的安装
本文地址:https://hh2xx.cn/archives/295/
版权说明:若无注明,本文皆HH の Blog's原创,转载请保留文章出处。