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 58913/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 /opt/ts3
cd /opt/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 /opt/ts3/teamspeak3-server_linux_amd64/
su ts3
cd /opt/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语音通信服务搭建完成可以进行使用了。

客户端个性化

我分享一个深色主题

下载地址https://mx-666.lanzoul.com/iAdpu3gvvvjc

解压密码：

如果想要更多个性化的主题请访问官网https://www.teamspeak.com/en/获取

使用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 /opt/ts3audiobot
cd /opt/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 /opt/ts3audiobot
su - ts3audiobot
./TS3AudioBot

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

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

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

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

配置机器人（非必要按需修改）

修改rights.toml文件

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

添加规则允许普通用户（非 Admin）使用播放 / 切歌 / 音量命令。

# Playing rights下的 groupid = []填入你的用户组ID 
客户端连接服务器点击顶部菜单栏的 权限 (Permissions)。
选择 服务器组 (Server Groups)（或者直接按快捷键 Ctrl + F1）。
在弹出的窗口左侧列表中，你会看到所有的组名称，把鼠标移动到你需要查看ID的用户组不动即可查看ID

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

vim ts3audiobot.toml #把这个文件的内容复制到bot.toml文件
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，机器人会返回一串密钥，在网页端输入该密钥就可以登入并控制机器人了。

使用Xftp（其他程序软件也可以）上传音乐文件

添加歌单

如果你要添加大量的音乐，一个一个复制很繁琐，我写了一个bash脚本，输入要导出的目录自动导出绝对路径到txt文本

vim export_paths_simple.sh

脚本内容：

chmod +x export_paths_simple.sh
bash export_paths_simple.sh

===== Linux文件绝对路径导出工具 =====
提示：导出目录下所有文件的绝对路径到TXT
========================================

【第一步：输入要导出的目录路径】
请输入目标目录的路径（如 /home/llm_models）：/root/my_llm_files
【第二步：输入保存TXT的路径】
请输入TXT文件的保存路径（如 /home/file_paths.txt）：/home/llm_paths.txt

开始扫描目录：/root/my_llm_files
共找到 15 个文件，开始导出路径...
进度：[##################################################] 100% (15/15)

===== 导出完成！=====
文件路径已保存到：/home/llm_paths.txt
共导出：15 个文件的绝对路径
提示：可使用 'cat /home/llm_paths.txt' 查看导出结果

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

!help #帮助
!next #下一曲
!pause #暂停
!play #播放 !play /home/小苹果.mp3
!volume 40 #音量

---

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

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

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

云安全组配置

运行工具

直接双击运行程序

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

访问管理页面

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

http://localhost:3000/login

配置服务器

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

完成安装

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

相关阅读