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

开启防火墙端口号

云安全组放行端口

系统命令放行端口

# 默认防火墙
ufw allow 9987/udp
ufw allow 10011/tcp
ufw allow 30033/tcp
ufw allow 58913/tcp

# firewall
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 --zone=public --add-port=58913/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

更新服务端

官方更新后再查看此步骤

停止服务端

 su ts3
 cd /opt/ts3/teamspeak3-server_linux_amd64
 ./ts3server_startscript.sh stop
 exit

记得备份

从官网复制最新下载链接

 cd /tmp
 wget https://files.teamspeak-services.com/releases/server/3.13.8/teamspeak3-server_linux_amd64-3.13.8.tar.bz2

替换文件

 tar -xjf teamspeak3-server_linux_amd64-3.13.8.tar.bz2 -C /opt/ts3/teamspeak3-server_linux_amd64 --strip-components=1

修正权限

chown -R ts3:ts3 /opt/ts3/teamspeak3-server_linux_amd64/

启动服务端

 su ts3
 cd /opt/ts3/teamspeak3-server_linux_amd64
 ./ts3server_startscript.sh start

更新完成

使用客户端连接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/获取

频道美化

频道简介格式化代码BBCode写法

右键编辑频道按需粘贴即可

权限设置

服务器组（Server Group）生效范围：整个虚拟服务器全部频道，无论你跳到哪个频道权限一直存在。

频道组（Channel Group）生效范围：仅当前所在频道（以及继承的子频道）；切换到别的频道，频道组权限直接消失。

重置管理员

echo -e "login serveradmin 你的密码\nuse sid=1\nprivilegekeyadd tokentype=0 tokenid1=6 tokenid2=0\nquit" | nc 127.0.0.1 10011

重置管理员后音乐机器人也要修改相应配置，客户端找到自己右键复制UID

vim /opt/ts3audiobot/rights.toml #找到# Admin rule下的useruid ，替换成上面复制的UID，别忘了双引号。

网页客户端搭建

若你想在网页与朋友们通信请看此章节

开源地址：https://github.com/EchoSixHIYA/WebSpeak-client-for-TeamSpeak

官方文档：https://github.com/EchoSixHIYA/WebSpeak-client-for-TeamSpeak/blob/master/docs/README.zh-CN.md

搭建步骤：

安装nodejshttps://nodejs.org/zh-cn/download

# nodejs 宝塔安装也可以
# 安装nvm工具
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.6/install.sh | bash
# 重载shell环境，二选一
source ~/.bashrc
# zsh用户：source ~/.zshrc
# 安装最新LTS稳定版
nvm install --lts
# 设置为系统默认版本
nvm alias default lts/*
# 启用这个版本
nvm use default
# 验证
node -v
npm -v

源码启动

# 下载
cd /opt
git clone --depth 1 https://github.com/EchoSixHIYA/WebSpeak-client-for-TeamSpeak.git

# 创建运行用户
useradd tsc
chown -R tsc:tsc /opt/WebSpeak-client-for-TeamSpeak
su tsc
cd /opt/WebSpeak-client-for-TeamSpeak

# 启动
npm ci --ignore-scripts
npm run prepare:sdk
npm run build
WEBSPEAK_MODE=relay \
WEBSPEAK_RELAY_TOKEN='replace-with-a-long-random-token' \
WEBSPEAK_RELAY_HOST='0.0.0.0' \
WEBSPEAK_RELAY_PORT='39087' \
node dist/index.js

发布包启动

从 Releases 下载并解压对应平台的包：

# 下载
mkdir -p /opt/WebSpeak-client-for-TeamSpeak/
cd /opt/WebSpeak-client-for-TeamSpeak/
wget https://github.com/EchoSixHIYA/WebSpeak-client-for-TeamSpeak/releases/download/v0.2.4/webspeak-webclient-v0.2.4-linux-x64.tar.gz
tar -zvxf webspeak-webclient-v0.2.4-linux-x64.tar.gz

# 创建运行用户
useradd tsc
chown -R tsc:tsc /opt/WebSpeak-client-for-TeamSpeak/webspeak-webclient-v0.2.4-linux-x64
su tsc
cd /opt/WebSpeak-client-for-TeamSpeak/webspeak-webclient-v0.2.4-linux-x64

# 启动
export WEBSPEAK_MODE=relay
export WEBSPEAK_RELAY_TOKEN='replace-with-a-long-random-token'
export WEBSPEAK_RELAY_HOST='0.0.0.0'
export WEBSPEAK_RELAY_PORT='39087'
./runtime/node ./dist/index.js

Docker启动

# 启动网关 
docker run -d --name webspeak-relay --restart unless-stopped --network host \
   -e WEBSPEAK_MODE=relay \
   -e WEBSPEAK_RELAY_TOKEN='replace-with-a-long-random-token' \
   -e WEBSPEAK_RELAY_PORT='39087' \
   ghcr.io/echosixhiya/webspeak:latest

# 启动前端网页
docker run -d --name webspeak-main --restart unless-stopped --network host \
  -p 3040:3040 \
  ghcr.io/echosixhiya/webspeak:latest

ip:3040打开网页

初始管理账号密码为admin

搭建完成

使用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

# 查看歌单
!list list
# 播放歌单
!list play 歌单名

# 下一曲
!next

# 暂停/播放
!pause !resume

# 音量
!volume 50

使用teamspeak-music-bot播放音乐

支持本地音乐和网易云音乐，QQ音乐，酷狗音乐

开源地址：https://github.com/ZHANGTIANYAO1/teamspeak-music-bot

启动步骤：

下载项目

mkdir -p /opt/ts3audiobot
cd /opt/ts3audiobot
git clone https://github.com/ZHANGTIANYAO1/teamspeak-music-bot.git
cd teamspeak-music-bot

安装依赖

sudo apt update

# nodejs 宝塔安装也可以
# 安装nvm工具
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.6/install.sh | bash

# 重载shell环境，二选一
source ~/.bashrc
# zsh用户：source ~/.zshrc

# 安装最新LTS稳定版
nvm install --lts

# 设置为系统默认版本
nvm alias default lts/*

# 启用这个版本
nvm use default

# 验证
node -v
npm -v

#ffmpeg
apt install ffmpeg -y

# 查看版本是否大于4.3.9-0，大于继续操作，不大于安装最新官方静态版
ffmpeg -version

# 安装官方静态版ffmpeg
apt remove ffmpeg -y

cd /tmp

wget https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-amd64-static.tar.xz

tar -xf ffmpeg-release-amd64-static.tar.xz

cd ffmpeg-*-amd64-static

install -m 755 ./ffmpeg /usr/local/bin/ffmpeg
install -m 755 ./ffprobe /usr/local/bin/ffprobe
hash -r
# 验证是否安装成功
ffmpeg -version

# 创建运行用户
adduser ts3audiobot
chown -R ts3audiobot:ts3audiobot /opt/ts3audiobot/teamspeak-music-bot
su - ts3audiobot

开始启动

cd /opt/ts3audiobot/teamspeak-music-bot
npm install
cd web && npm install && cd ..

# 构建
npm run build #报错找不到typescript执行 npm install typescript

# 更改端口 更改配置项webPort
vim data/config.json
# 保存退出
:wq

# 启动 使用screen命令或者宝塔的任务守护
npm start

你的服务器IP:你设置的端口打开网页

TeamSpeak 文字命令

在 TeamSpeak 频道中发送文字消息控制机器人：

命令	说明
!play <歌名>	搜索并播放（取最热门的匹配项；默认音源为网易云）
!play -n <歌名>	显式从网易云音乐搜索（默认音源即网易云，通常可省略）
!play -j <歌名>	从 Jellyfin 搜索（需先启用 Jellyfin 音源）
!play -q <歌名>	从 QQ 音乐搜索
!play -k <歌名>	从酷狗音乐搜索
!play -b <关键词>	从哔哩哔哩搜索视频并播放音频
!play -y <关键词>	从 YouTube 搜索并播放（需要安装 yt-dlp）
!search <歌名> [-j|-n|-q|-k|-b|-y]	列出前若干个匹配结果（含序号与 id），用于挑选同名歌曲；可加平台标志切换音源
!play #<序号>	播放上一次 !search 结果中的第 N 项（区分同名歌曲）
!play id <id>	按歌曲 id 播放精确的某首歌（也支持直接粘贴网易云 / QQ / B站 歌曲链接；Jellyfin 曲目用 GUID ItemId）。旧写法 !play id:<id> 仍然可用
!add <歌名>	添加到播放队列（同样支持 #序号 / id <id> / 链接）
!pause / !resume	暂停 / 恢复播放
!next / !prev	下一首 / 上一首
!stop	停止播放并清空队列
!vol <0-100>	设置音量
!queue	查看播放队列
!remove <位置>	从队列中删除指定位置的歌曲（位置从 1 开始，见 !queue）
!mode <seq|loop|random|rloop>	切换播放模式
!playlist <歌单名或ID>	加载歌单（支持名称模糊搜索和 ID；Jellyfin 歌单 GUID 也可直接粘贴）
!playlist -q <歌单名>	从 QQ 音乐搜索并加载歌单
!album <专辑名或ID>	加载专辑（支持名称搜索 / 数字 ID / Jellyfin GUID）
!artist <歌手名>	按歌手循环播放（支持 -j/-n/-q/-k/-b/-y）
!fm	私人 FM（默认网易云，自动续播）
!fm -j	Jellyfin 电台：从收藏出发的 Instant Mix（需启用 Jellyfin，自动续播）
!fm -q	QQ 音乐雷达 / 猜你喜欢 FM（自动续播）
!fm -k	酷狗私人电台 / 个性化推荐 FM（自动续播）
!lyrics	显示当前完整歌词（自动分多条消息发送，不再只显示开头几行）
!now	当前播放信息
!vote	投票跳过当前歌曲
!move <频道名>	移动到指定频道
!save <名称>	保存当前队列为一份已保存清单（需启用「保存/加载播放清单」，聊天保存进入共享清单）
!load [-a] <名称>	加载已保存清单（默认替换当前队列并播放；加 -a 追加到队列末尾）
!queues	列出已保存（共享）清单
!help	显示帮助信息

命令前缀默认为 !，可在设置页面修改。支持别名：!p = !play，!s = !skip，!n = !next

!save / !load / !queues 仅在管理员开启「保存/加载播放清单」后可用（默认关闭），未启用时回复「此功能未启用」。

TeamSpeak 命令权限（管理类命令限制）

默认情况下，频道里任何人都能运行所有聊天命令。你可以把一组「管理类」命令限制为只有特定 TeamSpeak 服务器组的成员才能运行：

• 受限命令：stop、clear、remove、move、vol、mode
• 其余命令（点歌、队列、跳过、歌词等）始终对所有人开放
• 默认不限制：管理服务器组列表为空时，所有命令对所有人开放（向后兼容）

配置方式

• 网页端：设置 → 命令权限，填写允许的服务器组 ID（逗号分隔），保存即时生效。
• 或编辑 config.json 的 adminGroups（数字数组），例如 "adminGroups": [6, 8]。

填入任意服务器组 ID 后，限制立即开启：只有属于这些组之一的用户才能运行受限命令，其他人会收到「需要管理员权限（该命令仅限管理员服务器组）」的提示。

提示（fail-closed）：当受限命令来自一个机器人当前看不到其服务器组的发送者（例如不在机器人所在频道的私聊），机器人会尝试查询其分组；若仍无法确定，则拒绝执行。

如何查看服务器组 ID

在 TeamSpeak 客户端中打开「权限 → 服务器组」（Permissions → Server Groups）对话框，选中某个组后，其 ID 会显示在标题栏/状态栏；或在服务器组管理界面中查看每个组对应的数字 ID。把需要授权的组 ID 填入上面的设置即可。

更新到新版本

# 拉取最新代码
git pull 
# 重新构建启动。
npm install && npm run build && npm start 

---

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

TS3‑Manager 是 TS3 开源 Web 管理面板，原生提供 Linux x64 二进制可执行文件，不需要装 Node 环境，网页面板默认端口 8080，通过 TS3 ServerQuery 协议远程管理 TeamSpeak3 服务端。只有需要管理多个 TS 虚拟实例、启停服务、批量备份，才体现优势。旨在帮助用户远程通过浏览器管理自己的TeamSpeak服务器。无论你是在家还是在办公室，只需打开浏览器，即可实现对服务器的全方位控制。

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

云安全组配置

启动步骤

# 放行端口，安全组也要放行，有宝塔去安全页面放行即可
sudo ufw allow 8080/tcp
# 创建目录
mkdir -p /opt/ts3-manager
cd /opt/ts3-manager

# 下载最新Linux二进制（去github releases看最新tag，示例v2.2.6）
wget https://github.com/joni1802/ts3-manager/releases/download/v2.2.6/ts3-manager-linux-x64-v2.2.6

mv ts3-manager-linux-x64-v2.2.6 ts3-manager
chmod +x ts3-manager

# 创建运行用户
useradd ts3
chown -R ts3:ts3 /opt/ts3-manager
su ts3
cd /opt/ts3-manager

# 修改监听端口，默认8080；0.0.0.0允许外网访问
PORT=8080 ./ts3-manager --host 0.0.0.0

浏览器访问：http://你的服务器IP:8080

使用screen命令或者宝塔的任务守护或者systemd 后台常驻开机自启

sudo cat > /etc/systemd/system/ts3-manager.service <<'EOF'
[Unit]
Description=TS3‑Manager WebUI
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/ts3-manager
Environment="PORT=8080"
ExecStart=/opt/ts3-manager/ts3-manager --host 0.0.0.0
Restart=on‑failure
RestartSec=10

[Install]
WantedBy=multi‑user.target
EOF

systemctl daemon‑reload
systemctl enable --now ts3-manager
systemctl status ts3-manager

更新步骤

su ts3
systemctl stop ts3-manager
cd /opt/ts3-manager
# 把链接替换成你看到的最新版本
wget https://github.com/joni1802/ts3-manager/releases/download/v2.2.6/ts3-manager-linux-x64-v2.2.7
mv ts3-manager-linux-x64-v2.2.7 ts3-manager
chmod +x ts3-manager
systemctl start ts3-manager

Docker 部署

docker run -d \
  --name ts3-manager \
  -p 8080:8080 \
  joni1802/ts3-manager:latest

Windows Server

直接双击运行程序

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

访问管理页面

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

http://localhost:3000/login

配置服务器

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

完成安装

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

相关阅读