如何创建 TeamSpeak 服务器
在 VPS 或专用 Linux 服务器上安装 TeamSpeak 语音服务器的完整指南:许可证、管理密钥、端口、systemd 服务、更新、备份和故障排除。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南介绍如何在您的 VPS 或专用 Linux 服务器上安装 TeamSpeak 语音服务器,使用专用用户和 systemd 服务运行,然后获取您的管理密钥并保持服务器更新。
订购服务器
TeamSpeak 消耗的资源很少。HostMyServers 提供多种合适的选择:
- NVMe VPS - 足以满足大多数语音服务器
- Performance VPS - 独享资源,适合将 TeamSpeak 与其他服务一同托管
- 经济型专用服务器 - 适合持有相应许可证的大型社区
前提条件
- 以 root 或具有 sudo 权限的用户进行 SSH 访问
- 64 位 Linux 系统:Debian 12/13 或 Ubuntu 22.04/24.04
- 已启用防火墙:nftables(推荐)、iptables 或 ufw(一次只使用一种防火墙工具)
- 端口 9987 UDP 和 30033 TCP 可访问
- 每位用户的电脑上需安装 TeamSpeak 客户端
配置要求
TeamSpeak 没有公布具体的最低配置数值。以下数值是 32 个名额服务器的大致参考:
| 组件 | 推荐 |
|---|---|
| 内存 | 512 MB 可用 |
| CPU | 1 核 |
| 存储 | 2 GB,外加用户共享文件所需的空间 |
| 网络 | 稳定的连接,延迟比带宽更重要 |
选择许可证
没有许可证文件时,服务器可免费运行,限 一个虚拟服务器和 32 个名额,仅限非商业用途。超出此范围或用于商业用途时,您需要一份许可证。
| 许可证 | TeamSpeak 合同中注明的限制 | 用途 |
|---|---|---|
| 无许可证 | 1 个虚拟服务器,32 个名额 | 个人和非商业团体 |
| Non-Profit (NPL) | 2 个虚拟服务器,512 个名额,期限 6 个月 | 非商业团体 |
| Annual Activation (AAL) | 从 1 个服务器 32 个名额到 2 个服务器 1024 个名额,期限一年 | 付费许可证 |
套餐及其可用性会发生变化:请在 TeamSpeak 销售网站上确认。完整合同见服务器附带的 LICENSE 文件。
系统更新
sudo apt update && sudo apt upgrade -y安装依赖项
sudo apt install -y ca-certificates curl tar bzip2 jq less cron创建专用用户
服务器绝不能以 root 身份运行。请创建专用用户:
sudo adduser --disabled-password --gecos "" teamspeak使用的端口
| 端口 | 协议 | 用途 | 开放范围 |
|---|---|---|---|
| 9987 | UDP | 语音 | 公开,必需 |
| 30033 | TCP | 文件传输 | 公开,必需 |
| 10022 | TCP | 通过 SSH 的 ServerQuery | 本指南中仅限本地 |
| 10011 | TCP | 未加密的 ServerQuery | 本指南中已禁用 |
| 10080 | TCP | HTTP 的 WebQuery | 默认禁用 |
| 41144 | TCP | TSDNS,可选 | 本指南中未使用 |
服务器还必须能够出站访问 TeamSpeak 的服务,特别是 TCP 443 端口上的 accounting2.teamspeak.com。请勿阻止此流量。
防火墙配置
使用 UFW
sudo ufw allow 9987/udp
sudo ufw allow 30033/tcp
sudo ufw reload使用 iptables
sudo iptables -A INPUT -p udp --dport 9987 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 30033 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4重启后保留规则需要安装 iptables-persistent 软件包。
使用 nftables
这些命令使用 inet filter 表和 input 链,二者在 Debian 的 /etc/nftables.conf 中默认存在。
sudo nft add rule inet filter input udp dport 9987 accept
sudo nft add rule inet filter input tcp dport 30033 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf安装服务器
以 teamspeak 用户身份登录。以下命令会获取 TeamSpeak 发布的最新版本,校验其 SHA-256 指纹,然后解压归档:
sudo -iu teamspeak
mkdir -p ~/teamspeak ~/backups
chmod 700 ~/backups
INFO=$(curl -fsSL https://www.teamspeak.com/versions/server.json)
URL=$(echo "$INFO" | jq -r '.linux.x86_64.mirrors["teamspeak.com"]')
SUM=$(echo "$INFO" | jq -r '.linux.x86_64.checksum')
echo "$URL"
curl -fL -o ~/ts3.tar.bz2 "$URL"
echo "$SUM $HOME/ts3.tar.bz2" | sha256sum -c - && tar -xjf ~/ts3.tar.bz2 --strip-components=1 -C ~/teamspeak
rm ~/ts3.tar.bz2校验应显示 OK。否则不会解压归档:请重新运行这些命令以再次下载。
接受许可协议
在您接受许可协议之前,服务器拒绝启动。请先阅读(按 q 键退出):
less ~/teamspeak/LICENSE如果您接受,请创建相应的文件:
touch ~/teamspeak/.ts3server_license_accepted服务器配置
默认情况下,ServerQuery 管理界面会监听所有地址,包括 10011 端口上的明文连接。请将其限制为 SSH 协议和本机:
nano ~/teamspeak/ts3server.iniquery_protocols=ssh
query_ssh_ip=127.0.0.1
query_ssh_port=10022| 参数 | 描述 |
|---|---|
query_protocols |
启用的 ServerQuery 协议:raw、ssh 和 http |
query_ssh_ip |
SSH 方式 ServerQuery 的监听地址 |
query_ssh_port |
SSH 方式 ServerQuery 的端口 |
然后退出 teamspeak 用户的会话:
exit安装许可证文件(可选)
如果您已获得许可证,请将 licensekey.dat 文件复制到 /home/teamspeak/teamspeak/,然后对其进行保护:
sudo chown teamspeak:teamspeak /home/teamspeak/teamspeak/licensekey.dat
sudo chmod 600 /home/teamspeak/teamspeak/licensekey.dat如果服务器已在运行,请将其重启。
配置为 systemd 服务
创建服务文件
sudo nano /etc/systemd/system/teamspeak.service文件内容:
[Unit]
Description=TeamSpeak 3 Server
Wants=network-online.target
After=network-online.target
[Service]
Type=simple
User=teamspeak
Group=teamspeak
WorkingDirectory=/home/teamspeak/teamspeak
ExecStart=/home/teamspeak/teamspeak/ts3server_minimal_runscript.sh inifile=ts3server.ini
Restart=on-failure
RestartSec=15
LimitNOFILE=100000
[Install]
WantedBy=multi-user.target启用并启动服务
sudo systemctl daemon-reload
sudo systemctl enable teamspeak.service
sudo systemctl start teamspeak.service管理命令
# 检查状态
sudo systemctl status teamspeak.service
# 停止服务器
sudo systemctl stop teamspeak.service
# 重启服务器
sudo systemctl restart teamspeak.service
# 查看日志
sudo journalctl -u teamspeak.service -f获取管理密钥
在首次启动时,服务器会生成 serveradmin 账户的密码和一个特权密钥(token):
sudo journalctl -u teamspeak.service --no-pager | grep -E 'loginname=|apikey=|token='| 项目 | 用途 |
|---|---|
token |
一次性密钥,用于在客户端中获取 Server Admin 权限 |
loginname 和 password |
登录 ServerQuery |
apikey |
访问 WebQuery(如果您启用了它) |
连接到服务器
- 安装并启动 TeamSpeak 客户端。
- 连接到地址
服务器IP(默认端口9987)。 - 首次连接时,客户端会要求您提供特权密钥:请粘贴
token。如果窗口没有出现,请根据您的客户端,在 Permissions 或 Tools 菜单中查找 Use Privilege Key。
随后您就属于 Server Admin 组,可以在客户端中配置服务器、频道及其权限。
使用 ServerQuery 管理
在服务器上,使用 serveradmin 密码登录:
ssh -p 10022 serveradmin@127.0.0.1| 命令 | 描述 |
|---|---|
help |
列出命令 |
use sid=1 |
选择第一个虚拟服务器 |
serverinfo |
显示虚拟服务器的信息 |
clientlist |
列出已连接的客户端 |
servergrouplist |
列出各组及其标识符 |
tokenadd tokentype=0 tokenid1=<组ID> tokenid2=0 |
为某个服务器组创建特权密钥 |
quit |
关闭会话 |
创建新的管理密钥
如果密钥已被使用或丢失,请通过 servergrouplist 找到 Server Admin 组。使用其 sgid,此处以 6 为例:
use sid=1
servergrouplist
tokenadd tokentype=0 tokenid1=6 tokenid2=0远程管理
建议从您的电脑通过 SSH 隧道访问,无需额外开放端口:
ssh -L 10022:127.0.0.1:10022 您的用户名@服务器IP然后将您的 ServerQuery 工具连接到 127.0.0.1:10022。
如果确实需要暴露 ServerQuery,请在 ts3server.ini 中将 query_ssh_ip=127.0.0.1 替换为 query_ssh_ip=0.0.0.0,重启服务,并将该端口限制为您的固定 IP 地址:
# UFW
sudo ufw allow from 您的IP to any port 10022 proto tcp
# iptables
sudo iptables -A INPUT -p tcp -s 您的IP --dport 10022 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 10022 -j DROP
# nftables
sudo nft add rule inet filter input ip saddr 您的IP tcp dport 10022 accept
sudo nft add rule inet filter input tcp dport 10022 drop服务器更新
请尽快安装更新:3.13.8 和 3.13.9 版本修复了安全漏洞,其中包括一个无需认证即可远程触发的服务器崩溃漏洞。您的数据会保留,但请先进行备份:请事先创建“自动备份”一节中介绍的脚本。
sudo /usr/local/sbin/teamspeak-backup.sh
sudo systemctl stop teamspeak.service
sudo -iu teamspeak
INFO=$(curl -fsSL https://www.teamspeak.com/versions/server.json)
URL=$(echo "$INFO" | jq -r '.linux.x86_64.mirrors["teamspeak.com"]')
SUM=$(echo "$INFO" | jq -r '.linux.x86_64.checksum')
curl -fL -o ~/ts3.tar.bz2 "$URL"
echo "$SUM $HOME/ts3.tar.bz2" | sha256sum -c - && tar -xjf ~/ts3.tar.bz2 --strip-components=1 -C ~/teamspeak
rm ~/ts3.tar.bz2
exit
sudo systemctl start teamspeak.service
sudo journalctl -u teamspeak.service -n 30 --no-pager已安装的版本显示在日志开头的 TeamSpeak 3 Server 行。
自动备份
该脚本会短暂停止服务器,以获得一致的数据库副本,然后再重新启动它。
备份脚本
sudo nano /usr/local/sbin/teamspeak-backup.sh#!/bin/bash
SERVER_DIR="/home/teamspeak/teamspeak"
BACKUP_DIR="/home/teamspeak/backups"
DATE=$(date +%Y-%m-%d_%H-%M-%S)
ARCHIVE="$BACKUP_DIR/teamspeak_$DATE.tar.gz"
# 要保留的项目(如果存在)
ITEMS=()
for ITEM in ts3server.sqlitedb ts3server.sqlitedb-wal ts3server.sqlitedb-shm ts3server.ini \
.ts3server_license_accepted licensekey.dat ssh_host_rsa_key query_ip_allowlist.txt \
query_ip_denylist.txt files; do
[ -e "$SERVER_DIR/$ITEM" ] && ITEMS+=("$ITEM")
done
install -d -m 700 -o teamspeak -g teamspeak "$BACKUP_DIR"
systemctl stop teamspeak.service
tar -czf "$ARCHIVE" -C "$SERVER_DIR" "${ITEMS[@]}"
RESULT=$?
systemctl start teamspeak.service
chown teamspeak:teamspeak "$ARCHIVE"
chmod 600 "$ARCHIVE"
# 删除超过7天的备份
find "$BACKUP_DIR" -name "teamspeak_*.tar.gz" -mtime +7 -delete
exit $RESULTsudo chmod 700 /usr/local/sbin/teamspeak-backup.sh计划备份
sudo crontab -e添加:
# 每天凌晨5点备份
0 5 * * * /usr/local/sbin/teamspeak-backup.sh恢复备份
请将文件名替换为您自己备份的文件名:
sudo systemctl stop teamspeak.service
sudo -u teamspeak tar -xzf /home/teamspeak/backups/teamspeak_2026-01-01_05-00-00.tar.gz -C /home/teamspeak/teamspeak
sudo systemctl start teamspeak.service请定期将这些归档文件复制到服务器之外:它们包含数据库以及您可能拥有的许可证。
故障排除
服务器要求接受许可协议
消息 Please set the environment variable TS3SERVER_LICENSE to "accept" 表示缺少接受许可协议的文件:
sudo -u teamspeak touch /home/teamspeak/teamspeak/.ts3server_license_accepted
sudo systemctl restart teamspeak.service错误 instance check error
没有许可证时,服务器会借助 /dev/shm 检查是否有其他实例正在运行。
- 查找其他实例:
pgrep -a ts3server - 检查
/dev/shm是否已挂载:df -h /dev/shm
如果未挂载,请先挂载它,然后将 tmpfs /dev/shm tmpfs defaults 0 0 这一行添加到 /etc/fstab:
sudo mount -t tmpfs tmpfs /dev/shm客户端无法连接
- 检查 9987 端口是否已在 UDP 上开放:
sudo ufw status - 检查服务器是否正在监听:
sudo ss -ulnp | grep 9987 - 检查服务是否正在运行:
sudo systemctl status teamspeak.service
文件传输或头像失败
很可能是 TCP 30033 端口被阻止。请检查防火墙和服务器的监听情况:
sudo ss -ltnp | grep 30033serveradmin 密码丢失
请停止服务,然后使用新密码手动运行一次服务器:
sudo systemctl stop teamspeak.service
sudo -iu teamspeak
cd ~/teamspeak
./ts3server_minimal_runscript.sh inifile=ts3server.ini serveradmin_password=NewPassword服务器启动后,使用 Ctrl+C 将其停止,输入 exit,然后重新启动服务:
sudo systemctl start teamspeak.service此密码可能会保留在 shell 历史记录中:之后请更改它,或清空该历史记录。
ServerQuery 连接被拒绝或被封禁
多次失败后,ServerQuery 会暂时封锁相应的地址。请等待几分钟并检查您的密码。要豁免某个可信地址,请将其添加到 query_ip_allowlist.txt,然后重启服务。
错误 unable to connect to accounting server
服务器无法连接到 TeamSpeak 的许可证服务。请检查 DNS 和机器的出站流量:
curl -I https://accounting2.teamspeak.com返回什么 HTTP 状态码并不重要:关键是能获得响应。
警告 The system locale is set to "C"
此消息无关紧要。它表示服务在未设置语言环境的情况下运行。您可以忽略它。