50% off 所有套餐限时优惠,起价 $2.48/mo
12 min left
Gaming & Media

如何在 Linux (Ubuntu/Debian/Rocky) 上设置 TeamSpeak Server

Nick Silver By Nick Silver 12 min read Updated Oct 7, 2025
一张超写实的地铁线路图,用玻璃制作,按顺序显示五个站点及小站名称:UBUNTU 24.04 → SYSTEMD → UFW/FIREWALLD → SRV;布局模仿地铁线路图风格;终点站旁放有一个微小的 VPS 图标。

如果你想要私密、低延迟的语音并完全控制,可以 在 Linux 上设置 TeamSpeak 服务器 只需几分钟。本指南专注于当前 LTS 发行版、干净的 systemd 服务和一些小但重要的安全检查。你将以专用用户身份启动它,打开正确的 ports, claim the privilege key,并在启动时保持运行。如果你使用的是 Windows,可以查看我们关于在 Windows 服务器上安装 TeamSpeak 服务器 的另一篇文章。

前置要求:操作系统、端口和访问权限

超真实微型 ATX 主板浮于中心;三块纤薄玻璃板如卫星般环绕,刻有 UBUNTU 24.04、DEBIAN 12、ROCKY 9。侧边导轨上的六角标签咔入:UDP 9987、TCP 30033、TCP 10011。

安装前,先确认基本设置。使用 VPS 或专用服务器会更方便,因为家庭 ISP 通常会被 运营商级 NAT(CGNAT) 阻挡入站流量。使用 LTS 镜像和非 root 用户(拥有 sudo 权限)。你可以在 Linux 上设置 TeamSpeak 服务器 Ubuntu 24.04 LTS, Debian 12, or Rocky/Alma 9;步骤相同,只需做一些小的防火墙调整。

你需要允许核心 ports. Voice runs on UDP 9987, file transfer is TCP 30033,而 ServerQuery 是 TCP 10011。如果计划使用 TSDNS, add TCP 41144,以及传统网页列表,你可能会看到 UDP 2010 出站流量。TeamSpeak 文档 SRV records 可以帮助你将名称映射到正确的目标和端口。参考官方 TeamSpeak Downloads page and port info 确认当前默认值:

如果你在家中托管,而你的公网 IP 属于 CGNAT,外部用户将无法连接到你,即使设置了路由器端口转发。将服务迁移到 VPS 可以解决这个问题,并为你提供固定的 IPv4。网络配置清楚后,你就可以获取服务器文件并准备服务。

下载并准备服务器

超真实终端窗口显示在玻璃屏上,三行大写字体:DNF / APT、CURL+TAR、FIRST RUN。下方是一条细目录带:/opt/TeamSpeak 和 chown。微型徽章标注 x86_64。

你将下载当前的 64 位服务器,创建一个专用的 TeamSpeak 用户,接受许可证,然后首次启动以获取 privilege key。这些命令在 Ubuntu, Debian, and Rocky-based images.

  1. 首先,如果需要,安装归档工具,然后添加用户和目录:
  • Ubuntu / Debian:
sudo apt update
sudo apt install -y bzip2 tar curl
  • Rocky / Alma:
sudo dnf install -y bzip2 tar curl

 

  1. 创建运行用户和文件夹:
sudo useradd -r -m -d /opt/TeamSpeak -s /usr/sbin/nologin TeamSpeak
sudo mkdir -p /opt/TeamSpeak
sudo chown -R TeamSpeak:TeamSpeak /opt/TeamSpeak

 

  1. 接下来,下载最新版本并解压到 /opt/TeamSpeak。上游服务器是 3.13.7 对于 Linux x86_64,本文撰写时的情况如此。请始终查看官方下载页面以获取最新版本和校验和。
cd /tmp
curl -LO https://files.TeamSpeak-services.com/releases/server/3.13.7/TeamSpeak3-server_linux_amd64-3.13.7.tar.bz2
tar xvjf TeamSpeak3-server_linux_amd64-3.13.7.tar.bz2
sudo rsync -a TeamSpeak3-server_linux_amd64/ /opt/TeamSpeak/
sudo chown -R TeamSpeak:TeamSpeak /opt/TeamSpeak

 

  1. 通过文件或环境变量接受许可证。在虚拟机上最简单的方法是在 TeamSpeak 主目录中放置一个小标记文件,然后以 TeamSpeak 账户身份首次运行以生成 admin token.
sudo -u TeamSpeak touch /opt/TeamSpeak/.ts3server_license_accepted
sudo -u TeamSpeak /opt/TeamSpeak/ts3server_minimal_runscript.sh

 

  1. 查看终端输出并记下 "token" 那一行。这个密钥让你在客户端中声明管理员权限。用 Ctrl+C 停止进程。二进制文件就位且token已保存后,将其转换为托管服务。

 

一套清晰的配置在所有发行版上都能用,你可以在 Linux 上配置一次 TeamSpeak 服务器,然后为其他节点复用这份 playbook。

用 systemd 将其转变为服务

超现实1U服务器前面板(细磨拉丝金属、亮起的电源LED)悬浮在三块薄玻璃板前,形成一条通道。

一个完整的虚拟服务器让你能够启动、停止、重启、查看日志和设置开机自启。创建一个最小化的 systemd 指向已安装文件夹的服务,以无特权用户身份运行。 TeamSpeak 社区文档 Linux 服务单位深度解析

  1. 创建单位文件:
sudo tee /etc/systemd/system/TeamSpeak.service >/dev/null << 'EOF'
[Unit]
Description=TeamSpeak 3 Server
Wants=network-online.target
After=network.target
[Service]
WorkingDirectory=/opt/TeamSpeak
User=TeamSpeak
Type=forking
PIDFile=/opt/TeamSpeak/ts3server.pid
ExecStart=/opt/TeamSpeak/ts3server_startscript.sh start inifile=ts3server.ini
ExecStop=/opt/TeamSpeak/ts3server_startscript.sh stop
ExecReload=/opt/TeamSpeak/ts3server_startscript.sh restart
Restart=always
RestartSec=15
[Install]
WantedBy=multi-user.target
EOF

 

  1. 重新加载 systemd 并启用该服务:
sudo systemctl daemon-reload
sudo systemctl enable --now TeamSpeak

 

  1. 检查服务,如果需要可以重新获取令牌:
sudo systemctl status TeamSpeak --no-pager
journalctl -u TeamSpeak -n 50 --no-pager

 

现在服务已经启动,打开所需的 ports 这样客户端就可以访问语音、查询和文件传输端点。 服务器启动后 systemd, you can 在 Linux 上安装 TeamSpeak 服务器 在任何 VPS 上,重启或崩溃后都会自动重启。

打开防火墙、UFW 或 firewalld

超现实玻璃门防火墙;双把手 UFW 和 FIREWALLD。门框木梁配置项包括:9987/UDP、30033/TCP、10011/TCP、41144、2010 OUT;门楣参数:IPv6、RELOAD、CONNECT。

启用语音、文件传输和查询功能 ports。在 Ubuntu 上,你可能会使用 UFW。在 Rocky 或 Alma 上,默认为 firewalld.

UFW example:

sudo ufw allow 9987/udp comment "TeamSpeak voice"
sudo ufw allow 30033/tcp comment "TeamSpeak file transfer"
sudo ufw allow 10011/tcp comment "TeamSpeak ServerQuery"
sudo ufw reload

 

firewalld example:

sudo firewall-cmd --permanent --add-port=9987/udp
sudo firewall-cmd --permanent --add-port=30033/tcp
sudo firewall-cmd --permanent --add-port=10011/tcp
sudo firewall-cmd --reload

 

如果你打算使用 TSDNS, add 41144/tcp。如果你在旧的网络列表中发布服务器,请 2010/udp outbound.

IPv6 note: 重复规则适用于 IPv6 如果你的主机支持;客户端可以通过 IPv4 或 IPv6 与你连接。配置网络规则后,从客户端连接并声明管理员权限。

连接并声明管理员

超真实笔记本屏幕分为三个细长的玻璃窗格:上方是连接选项和 IP 输入框;密码通过小型玻璃键盘处理(点击时 PIN 点动画显示);亮起的频道图块显示细微的语音波形。

在桌面上打开 TeamSpeak 客户端,连接到你的服务器 IP 或域名。系统提示时,粘贴 privilege key 来自首次运行。设置服务器密码并确认你可以加入频道并正常通话。如果需要,你可以稍后通过重新访问日志或在权限界面中创建新令牌来重新生成密钥。

如果你希望在虚拟机上有个桌面用于一次性配置,可以添加 XRDP 从 Windows 访问图形会话。如需在 Ubuntu 内按步骤进行 GUI 设置,请按照我们的博客指南 在 Ubuntu 上安装 xRDP

确认管理员权限后,记下 ports 你打开的内容以及每个的功能。首次登录完成了你的 在 Linux 上的 TeamSpeak 服务器设置.

默认 TeamSpeak 端口和用途

这是默认端口的快速参考表。你可以在配置中更改这些端口,但大多数设置保持不变。

Port Proto Purpose
9987 UDP 频道语音流量
30033 TCP 文件传输服务
10011 TCP ServerQuery interface
41144 TCP TSDNS 助手(可选)
2010 UDP 旧的公网服务器列表(已停用)

TeamSpeak’s port info and SRV 指南确认这些默认值。端口确认无误后,最快的改进来自解决常见连接问题。

故障排除:无法连接、令牌缺失、CGNAT

超真实日志本(微印纸张)放在玻璃放大镜下突出显示令牌;旁边是刻有 PID 和 WORKDIR 的服务单元卡。背景机架条显示 UDP 9987 和 30033/TCP。

使用简明检查清单,可以直接从症状进入解决步骤。无论使用何种发行版,这些检查都适用,只要你在 Linux 上设置了 TeamSpeak 服务器 systemd。许多修复方案在任何 TeamSpeak Linux 服务器安装中通用.

  • 客户端从互联网超时,但本地局域网工作正常: Verify that UDP 9987 is open on the server firewall and forwarded on any upstream router. Check logs for “listening on 0.0.0.0:9987” to confirm the voice socket.
  • 外部用户无法连接,即使配置了端口转发: 检查你的 ISP 是否为 WAN 分配了 100.64.0.0/10 地址。这表明 CGNAT。在 VPS 上托管可以避免该限制,并保持一个静态 IPv4,能够清晰地映射到客户端。
  • 密钥丢失: 查看服务日志,搜索 "token" 或重启一次以生成新的密钥。将其保存到你的密码管理器中。
  • 服务启动失败: Recheck WorkingDirectory, User,以及单位内的路径。不匹配会导致 PID 文件无法写入。前面的示例是一个稳定的基准。
  • 文件上传失败: Open TCP 30033 并确认文件传输端口在配置中未被修改。客户端在语音握手过程中会获得这个值。

 

基础设置都做好了,现在添加一个域名,让用户直接通过域名访问,而不是输入 IP 和端口号。

可选:域名和 SRV 或 TSDNS

你可以使用 DNS 为你的语音端点映射一个易记的名称 SRV record. Create an A record 针对该目标,然后添加一个 SRV 记录,如下所示:

_ts3._udp.play.example.com. 3600 IN SRV 0 5 9987 ts.example.com.

 

客户将解决 SRV 并在地址中无需指定端口就能连接。TeamSpeak 还支持 TSDNS service on 41144/tcp 用于自定义名称映射。这两种方法都在之前链接的端口信息文章中由供应商记录。

如果您不想自己管理 DNS,可以通过分享直链的方式为用户提供简便途径,例如:

ts3server://host.example.com

 

完成命名后,养成几个小习惯来保障安全和维护,这样服务才能保持稳定运行。

安全和维护

保护管理员路径,加密静态数据。花几分钟做好这些,后面能省掉几小时的麻烦。

  • Admin surface: 设置强密码并检查谁有 ServerQuery 访问。使用命名登录。
  • Encryption: 如果您的 CPU 预算允许,请在全球范围内启用频道语音加密。从最敏感的频道开始。
  • Backups: Back up ts3server.sqlitedb 或您的外部数据库并复制 ts3server.ini保存单元文件和所有防火墙规则。
  • Least privilege: Keep the systemd 专用服务器上的单元 TeamSpeak 用户。不要以 root 身份运行二进制文件。
  • Updates: 定期应用发行版更新,在内核变更后重启服务。每次变更后测试连接性。

掌握基础知识后,选择合理的初始规模,确保服务对你的社群保持稳定运行。

选择建议:托管、发行版和规模

如果你的目标只是为朋友快速搭建语音服务,可以在 Linux 上用小型虚拟机搭建 TeamSpeak 服务器,成本保持低位。更大的社群受益于更好的网络和更多 RAM 用于文件传输。用这个速查表选择起点,然后在一周实际流量后进行调整。

  • CGNAT 家庭实验室: 不要与端口转发对抗。将服务移到带公网 IPv4 的 VPS,然后发布 DNS。这是实现 在 Linux 上安装 TeamSpeak 服务器 外部访问的最快方式。
  • 周末高峰游戏社团: 从 2 个 vCPU 和 2 GB RAM 开始,然后观察 CPU 闲置和丢包情况。当忙时语音接近饱和时升级。
  • University club: Prefer Ubuntu 24.04 LTS and UFW 规则。校园网络通常有 IPv6,因此在开放端口后测试入站 IPv6。
  • 电竞战队,比赛日: 选择靠近游戏地区的 VPS 并记录基线。如果录制或大文件上传很重要,增加存储并将 RAM 提升到 4 GB。
  • 混合模组社群: Keep ServerQuery 进行了锁定,添加频道密码,并安排每周备份。这能保持一个繁忙的 TeamSpeak 服务器 Linux 安装 predictable.

 

从简单开始,逐步迭代。选定配置后,应该知道虚拟机上的 GUI 访问可以加快早期配置,因此请阅读下一部分了解托管选项和桌面路径。

托管和远程管理

在为稳定语音和清晰路由而构建的平台上运行 TeamSpeak。我们的 Linux VPS 为你提供公网 IPv4、低抖动地域和一处的根控制权。你可以小规模启动,保持延迟紧凑,并在社群增长时在几分钟内扩展。

使用 Cloudzy 的 Linux VPS 获得的优势:

  • 可靠的计算能力: 现代 CPUs、稳定的时钟速率和专属 RAM,专为实时语音优化。
  • 存储性能跟得上: 使用 NVMe 或 SSD 存储实现快速文件传输和高速日志写入。
  • 为语音优化的网络: 10 Gbps uplinks in core locations, anycast-grade routing, and active DDoS filtering that helps keep UDP 9987 steady.
  • 与你的配置匹配的操作系统镜像: Ubuntu 24.04 LTS、Debian 12 或 Rocky 9,开箱即用。 systemd setup.
  • 访问和控制: 完整的 root 权限、带外控制台、DNS 和可自由修改的防火墙规则,无需工单。
  • Lifecycle tools: 升级前快照、快速恢复和简便的套餐调整。
  • Global regions: 遍布 3 大洲 12+ 个位置,选择离玩家最近的数据中心以降低延迟。
  • 支持和可用性: 24 小时工程师支持和 99.95% 的可用性 SLA。

 

如果需要在 VPS 上部署桌面以快速进行可视化调整,可以部署 Linux RDP 服务器 as a 一键应用 到你的 Linux VPS。

Final Thoughts

你已经学会了在 Linux 上以简洁可复用的方式搭建 TeamSpeak 服务器。这个方法在后续部署节点或跨区域时保持流程的一致性。使用 LTS 发行版、专属用户和适当的 systemd 单元。打开 UDP 和 TCP ports 所需的端口,并申请 privilege key, and add SRV 如需更友好的地址方案。为了获得更稳定的路由和固定公网 IP,建议托管在 Cloudzy Linux VPS 这样服务器可以全天保持可达。

 

FAQ

基础 Linux TeamSpeak 服务器需要开放哪些端口?

开放 UDP 9987 用于语音、TCP 30033 用于文件传输、TCP 10011 用于 ServerQuery。如果使用 TSDNS,还需开放 TCP 41144。这些默认端口覆盖大多数部署,与 TeamSpeak 官方指导一致。

能否在家里运营商级 NAT 后面托管 Linux TeamSpeak 服务器?

不能。你的 ISP 外部的用户无法向你的私有地址发起入站连接。本地测试可行,但互联网客户端会失败。使用具有公网 IPv4 的 VPS 或要求 ISP 关闭 CGNAT。

如何让 TeamSpeak Linux 服务器在启动时自动运行?

创建 systemd 单元,运行 systemctl enable TeamSpeak,服务将在启动时自动启动并在失败时重启。用前面显示的命令检查状态和日志。

我如何恢复 TeamSpeak Linux 服务器的管理员权限密钥?

使用 journalctl -u TeamSpeak | grep -i token 在最近的日志中搜索包含 "token" 的行,或在客户端权限设置中生成新的 token。

有没有 TeamSpeak 5 或 6 Linux 服务器可以下载,而不是 TS3?

公网生产服务器使用 TS3 服务器构建版本。继续使用 3.13.x 服务器版本,并关注官方下载页面以获取最新更新。

Share

博客更新

Keep reading.

「最佳 Plex 替代方案」主页面,展示 Jellyfin、Emby、Stremio 和 Kodi 的选项卡,以及 Plex 替代方案的快速指南。
Gaming & Media

自托管媒体服务器的最佳Plex替代方案:快速解答 + 详细对比

如果你在找答案,Jellyfin 是大多数想要长期自建媒体库的人的最佳选择。如果你更在乎界面打磨和用户体验,Emby 是更好的选择。

Nick SilverNick Silver 14 min read
如何为 Minecraft 服务器创建备份?
Gaming & Media

如何为 Minecraft 服务器创建备份?

运行 Minecraft 服务器而不备份数据很危险。迟早会出问题。游戏世界损坏、模组冲突、插件异常,或者意外错误导致服务器宕机。

Ivy JohnsonIvy Johnson 10 min read
发光传送门矗立在右侧,门后隐现城堡与漂浮岛屿。文字「Best Minecraft Modpacks」以粗体显示在左侧暗色区域,紧邻 Cloudzy 标志。
Gaming & Media

2026 年最值得玩的 Minecraft Modpacks

原版 Minecraft 玩了几百小时后就没意思了。你已经打败了末影龙,建造了农场,探索了生物群系。接下来呢?模组包通过捆绑多个模组来解决这个问题

Rexa CyrusRexa Cyrus 13 min read

Ready to deploy? From $2.48/mo.

独立云服务,始于2008年。AMD EPYC、NVMe,40 Gbps。14天退款保障。