TS3AudioBot的简单安装配置

最新推荐文章于 2025-10-28 09:42:45 发布

原创最新推荐文章于 2025-10-28 09:42:45 发布 · 2.7k 阅读

15 ·

CC 4.0 BY-SA版权

文章标签：

#服务器

TS3AudioBot是一款开源的TeamSpeak Bot，可以在ts频道中播放音乐，本博客为博主自己为ts服务器安装bot的大致过程，希望可以起到一定的参考作用。

博主的ts3服务器相关配置：
1.Ubuntu18.04LTS
2.cpu架构为Intel x86，也叫做amd64

ssh连接工具：finalshell

安装过程：

安装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:58913或1.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

最后，enjoy your music