中文

游戏服务器

如何创建 TeamSpeak 服务器

在 VPS 或专用 Linux 服务器上安装 TeamSpeak 语音服务器的完整指南:许可证、管理密钥、端口、systemd 服务、更新、备份和故障排除。

阅读约 8 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南介绍如何在您的 VPS 或专用 Linux 服务器上安装 TeamSpeak 语音服务器,使用专用用户和 systemd 服务运行,然后获取您的管理密钥并保持服务器更新。

订购服务器

TeamSpeak 消耗的资源很少。HostMyServers 提供多种合适的选择:

前提条件

  • 以 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.ini
配置
query_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(如果您启用了它)

连接到服务器

  1. 安装并启动 TeamSpeak 客户端。
  2. 连接到地址 服务器IP(默认端口 9987)。
  3. 首次连接时,客户端会要求您提供特权密钥:请粘贴 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 $RESULT
终端
sudo 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 30033

serveradmin 密码丢失

请停止服务,然后使用新密码手动运行一次服务器:

终端
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"

此消息无关紧要。它表示服务在未设置语言环境的情况下运行。您可以忽略它。