TeamSpeak3语音通信服务器搭建

简介

本教程展示如何搭建TeamSpeak 3服务器，支持远程管理并通过TS3 Manager工具进行可视化操作。

TeamSpeak3 是一款全球流行的团队语音通讯工具软件，常用于游戏、会议等场景下的团队语音沟通，以下是其详细介绍：

• 功能特点
  • 语音质量高：支持 SPEEX、CELT、OPUS 等多种语音编码格式，可设置从 1 级到 10 级的语音质量。并配备集成的自动麦克风音量调节、背景降噪和回声清除功能，能为用户提供水晶般透亮明晰的无延迟通信体验。
  • 安全性强：集成军用级安全性，客户端和服务器认证基于公钥和私钥，可对整个服务器或特定通道启用基于 AES 的加密，确保语音数据传输的安全。
  • 权限系统灵活：拥有强大的分层权限系统，服务器管理员可以完全掌控一切，能够决定谁可以说话、谁可以加入频道等，还可对用户进行分组及单独控制用户行为。
  • 可扩展性高：采用先进的客户端 – 服务器架构，能够从小组对话扩展到拥有数千名参与者的大型会议，满足不同规模用户的需求。
  • 定制化程度高：用户可以使用配套的加载项、声音和图标包以及主题个性化设置客户端，还可从用户社区创建的数百个加载项中进行选择，甚至可以创建自己的加载项。
  • 支持移动连接：提供适用于 Android 和 iOS 的移动应用程序，方便用户在暂时离开电脑时也能发出命令，保持与团队的联系。
  • 具备游戏内叠加功能：通过 Overwolf 中的官方 TeamSpeak 游戏叠加层，用户可以快速访问语音控件，查看谁在说话，并在最需要的地点和时间接收通知和消息。
• 使用方式：TeamSpeak3 为个人用户提供免费服务，采用非注册的使用方式，用户只要知道语音服务器的 IP 或者域名，就可以通过客户端进入同一个语音服务器内进行沟通。
• 应用场景：由于其具有毫秒级超低延迟的特点，适用于对语音即时通讯有严格要求的团队游戏、远程会议等场合，同时它还提供文字聊天、文件共享功能，能满足团队沟通协作的多种需求。

环境

• OS: Ubuntu 24.04.2 LTS x86_64
• Host: Alibaba Cloud ECS pc-i440fx-2.1
• Kernel: 6.8.0-63-generic
• Uptime: 8 days, 19 hours, 59 mins
• Packages: 1007 (dpkg)
• Shell: bash 5.2.21
• Resolution: 1024×768
• Terminal: /dev/pts/0
• CPU: Intel Xeon Platinum (2) @ 2.500GHz
• GPU: 00:02.0 Cirrus Logic GD 5446
• Memory: 488MiB / 1613MiB
• 需要开放端口：9987/udp 10011/tcp 30033/tcp

开启防火墙端口号

云安全组放行端口

系统命令放行端口

systemctl start firewalld
 firewall-cmd --zone=public --add-port=9987/udp --permanent
 firewall-cmd --zone=public --add-port=10011/tcp --permanent
 firewall-cmd --zone=public --add-port=30033/tcp --permanent
 firewall-cmd --reload

注意：如果你安装了宝塔就不用执行上面的命令，从宝塔安全面板放行即可

下载服务端安装包

服务端下载地址：https://www.teamspeak.com/en/downloads/#server

mkdir /home/ts3
cd /home/ts3
wget https://files.teamspeak-services.com/releases/server/3.13.7/teamspeak3-server_linux_amd64-3.13.7.tar.bz2
tar -xjvf teamspeak3-server_linux_amd64-3.13.7.tar.bz2

创建运行用户

useradd ts3
chown -R ts3:ts3 /home/ts3/teamspeak3-server_linux_amd64/
su ts3
cd /home/ts3/teamspeak3-server_linux_amd64/

启动服务

创建授权文件

touch .ts3server_license_accepted

执行安装脚本并启动服务

./ts3server_startscript.sh start

停止命令

./ts3server_startscript.sh stop

使用客户端连接TeamSpeak3服务器

客户端下载地址：https://www.teamspeak.com/en/downloads/#ts3client

下载安装后是英文，若想汉化下载汉化补丁

汉化补丁下载地址：https://mx-666.lanzoul.com/irOqP33br06b

解压密码：

输入服务器IP地址或者域名等信息，完成令牌验证

至此Teamspeak语音通信服务搭建完成可以进行使用了。

使用TS3AudioBot播放音乐

开源地址：https://github.com/Splamy/TS3AudioBot

安装基本工具（可选但推荐）

sudo apt install wget unzip vim screen -y

安装必要依赖

为了让机器人支持音频播放，需要安装 ffmpeg 与 Opus 库：

sudo apt install libopus-dev ffmpeg -y

这些是官方推荐的依赖，可以让机器人播放大多数流媒体和音频文件。

你可以从官方 Release 页面或 nightly 包下载 Linux 版：

https://splamy.de/api/nightly/projects/ts3ab/master_linux_x64/download

mkdir home/ts3audiobot
cd home/ts3audiobot
wget -O TS3AudioBot.tar.gz "https://splamy.de/api/nightly/projects/ts3ab/master_linux_x64/download"

你会看到以下文件结构，其中最重要的是 TS3AudioBot 可执行文件和一些配置模板。

初次运行并生成配置

获取管理员UID

打开Windows客户端连接你的服务器后依次点击：

权限——所有客户端列表

找到自己右键复制UID

首次运行机器人它会启动并提示设置一些基础数据，例如 TeamSpeak 服务器地址、Bot 名称、权限设置等。会生成默认的配置文件 ts3audiobot.toml 和权限模板。让它自动创建默认配置：

tar -xzf TS3AudioBot.tar.gz
adduser ts3audiobot
chown -R ts3audiobot:ts3audiobot /home/ts3audiobot
su - ts3audiobot
./TS3AudioBot

运行完成后ctrl+c结束服务目录里多了这三个文件：

Bots文件夹 #机器人配置文件夹

rights.toml文件 #权限配置文件

ts3audiobot.toml文件 #机器人配置模板

配置机器人

修改rights.toml文件

vim /home/ts3audiobot/rights.toml #找到#Playing rights下的useruid ，在后面填上上面复制的UID，别忘了双引号。

修改机器人配置bot.toml文件

vim ts3audiobot.toml #把这个文件的内容复制到bot.toml文件
vim vim bots/default/bot.toml
i
鼠标中键

将run后面改成true

配置基本信息[bot.connect]

开启网页端控制

使用screen命令新建会话

screen -S ts3bot
./TS3AudioBot
ctrl+a+d

在[web]下输入端口，例如58913，然后在防火墙开放此端口，随后就可以使用此端口网页控制机器人了。

在电脑客户端TeamSpeak 3 Client中向机器人私聊，输入命令!api tocken，机器人会返回一串密钥，在网页端输入该密钥就可以登入并控制机器人了。

添加歌单

然后点击播放你就能听到音乐了，也可以在客户端私聊机器人或者在频道发送指令进行播放，指令示例：

!help #帮助
!next #下一曲
!pause #暂停
!play #播放
!volume 40 #音量

使用SinusBot播放音乐

系统准备（必须做）

sudo apt update && sudo apt upgrade -y

安装依赖（核心）：

sudo apt install -y screen ffmpeg libglib2.0-0 ca-certificates

创建独立用户（强烈建议）

sudo adduser sinusbot
mkdir /home/sinusbot/
cd /home/sinusbot/
chown -R sinusbot:sinusbot /home/sinusbot/
sudo su - sinusbot

---

下载 & 解压 SinusBot

下载 SinusBot.tar.bz2 到：

wget https://www.sinusbot.com/dl/sinusbot.current.tar.bz2

执行：

tar -xvf sinusbot.current.tar.bz2
chmod +x sinusbot

首次启动（生成配置）

screen -S sinusbot
./sinusbot

看到类似输出：

Listening on http://0.0.0.0:8087

后台运行：

Ctrl + A + D

放行 Web 面板端口

如果使用 UFW：

sudo ufw allow 8087/tcp
sudo ufw reload

Web 控制台设置

浏览器访问：

http://服务器IP:8087

默认账号：

• admin / admin登录后立刻改密码

创建实例

Instances → Create

填写：

• Nickname：MusicBot
• Server Address：TS3 服务器 IP
• Voice Port：9987
• Identity：自动
• Login：ServerQuery（推荐）

保存 → Start

ServerQuery 权限（关键）

给 Bot 一个最小权限即可，避免被踢：

必需权限：

b_virtualserver_select
b_virtualserver_client_list
b_virtualserver_client_move
b_virtualserver_channel_list
b_virtualserver_channel_join
b_client_info_view
b_client_channel_join
b_client_modify_description
b_client_kick_from_channel
i_client_max_clones = 0

播放音乐测试

本地音乐

Web → Files → 上传 MP3 → Play

确保 ffmpeg 正常：

ffmpeg -version

音质推荐（打游戏不炸）

Instance Settings：

• Audio Quality：High
• Bitrate：64 kbps
• Opus：开启
• Normalize：开启
• Max Volume：70

---

开机自启（Ubuntu 推荐）

sudo nano /etc/systemd/system/sinusbot.service

填入：

[Unit]
Description=SinusBot
After=network.target

[Service]
User=sinusbot
WorkingDirectory=/home/sinusbot
ExecStart=/home/sinusbot/sinusbot
Restart=always

[Install]
WantedBy=multi-user.target

启用：

sudo systemctl daemon-reload
sudo systemctl enable sinusbot
sudo systemctl start sinusbot

Ubuntu 常见问题速解

Web 打不开

sudo ss -lntp | grep 8087

Bot 上线秒掉

• ServerQuery 权限不够
• TS3 客户端数限制

TS3 Manager远程管理工具（可选）

TS3 Manager 是一款强大的Web界面工具，旨在帮助用户远程通过浏览器管理自己的TeamSpeak服务器。无论你是在家还是在办公室，只需打开浏览器，即可实现对服务器的全方位控制。

Github链接：https://github.com/joni1802/ts3-manager

云安全组配置

运行工具

直接双击运行程序

默认API端口为 3000，如需修改，请编辑配置文件。

访问管理页面

在浏览器中输入以下地址：

http://localhost:3000/login

配置服务器

填写TeamSpeak服务器信息，关闭SSH并输入管理账户和密码。

完成安装

成功连接后，即可通过Web页面进行服务器管理。

相关阅读