teamspeak3以及音乐机器人搭建
搭建 TeamSpeak 3 语音服务器:一份极简教程
1. 准备工作
在开始之前,请确保你具备以下条件:
一台 Linux 服务器:本文以 Ubuntu为例。
一个公网 IP:确保你的服务器拥有独立的公网 IP,或已做好端口映射。
开放防火墙端口:确保服务器防火墙和云服务商的安全组放行以下端口:
| 端口 | 协议 | 用途 |
|---|---|---|
| 9987 | UDP | 语音通信 (最核心) |
| 30033 | TCP | 文件传输 (头像/图标) |
| 10011 | TCP | 服务器远程管理 (ServerQuery) |
| 41144 | TCP | 新版客户端查询端口 |
许可证说明:TeamSpeak 3 对非商业用途免费,内置 1个虚拟服务器 和 32个在线用户 的限制,对绝大多数私人团队来说完全够用。
2. 开始安装
2.1 系统更新与创建用户
为了安全,我们强烈建议不要使用 root 账号运行 TS3 服务。
更新系统
sudo apt update && sudo apt upgrade -y
创建一个名为 teamspeak 的系统用户
sudo adduser teamspeak
切换到该用户
su - teamspeak
2.2 下载服务端软件
进入用户目录,并从官网下载最新版服务端(请以官网最新版本号为准):
cd /home/teamspeak
下载服务端压缩包 (以 3.13.7 版本为例)
解压
tar -xjvf teamspeak3-server_linux_amd64-*.tar.bz2
2.3 启动服务器
进入解压后的目录,接受许可协议并启动:
cd teamspeak3-server_linux_amd64
创建同意许可协议的文件
touch .ts3server_license_accepted
启动服务器
./ts3server_startscript.sh start
3. 🚨 关键步骤:保存管理员令牌
首次启动时,终端日志中会显示两行极其重要的信息:
ServerAdmin privilege key created, please use it to gain serveradmin rights for your virtualserver.
token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
请立即复制并保存这个 token(令牌)。如果你关闭了终端,将无法找回,只能清空数据重新初始化。
4. 设置开机自启 (Systemd)
为了确保服务器在重启后自动运行,我们可以将其注册为系统服务。
4.1 创建服务文件 (需要 root 权限):
sudo nano /etc/systemd/system/teamspeak3.service
4.2 粘贴以下配置 (注意将 /path/to 替换为你的实际绝对路径):
[Unit]
Description=TeamSpeak 3 Server
After=network.target
[Service]
User=teamspeak
Group=teamspeak
WorkingDirectory=/home/teamspeak/teamspeak3-server_linux_amd64
ExecStart=/home/teamspeak/teamspeak3-server_linux_amd64/ts3server
ExecStop=/home/teamspeak/teamspeak3-server_linux_amd64/ts3server_startscript.sh stop
ExecReload=/home/teamspeak/teamspeak3-server_linux_amd64/ts3server_startscript.sh restart
Restart=always
RestartSec=15
[Install]
WantedBy=multi-user.target
4.3 重载配置并启用:
sudo systemctl daemon-reload
sudo systemctl enable teamspeak3
sudo systemctl start teamspeak3
5. 连接与使用
下载客户端:从 TeamSpeak 官网 下载适用于你系统的客户端。
连接服务器:打开客户端,点击
Connections->Connect,输入你的 服务器 IP 地址(端口默认 9987,可不填)。获取管理员权限:首次进入频道时,客户端会弹出窗口要求输入 Token。粘贴你在第三步保存的令牌,即可获得管理员权限。
6. 常见问题排查 (Troubleshooting)
| 问题现象 | 可能原因与解决方案 |
|---|---|
| 客户端连接不上 | 1. 检查 UDP 9987 端口是否放行,这是最常见的坑。 2. 检查云服务商安全组策略。 |
| 听不到声音/语音卡顿 | 检查服务器带宽是否跑满,或客户端 Codec 设置是否过高。 |
| 丢失了管理员 Token | 停止服务端,删除 /home/teamspeak/teamspeak3-server_linux_amd64 下的 query_ip_whitelist.txt 和 query_ip_blacklist.txt,重启后控制台会生成新 Token。 |
7. 搭建 TeamSpeak 音乐机器人 (teamspeak-music-bot)
有了 TeamSpeak 服务器之后,不妨再给它配上一个“点歌台”。teamspeak-music-bot 是一个功能强大的开源音乐机器人,链接,支持从网易云音乐、QQ音乐、酷狗音乐、哔哩哔哩等多个平台搜索并播放音乐。它最大的亮点在于提供了一个 YesPlayMusic 风格的 WebUI 控制面板,让你可以通过浏览器轻松管理播放,体验非常接近专业的音乐播放器。