四季如春

在Ubuntu上借助Docker部署多个TeamSpeak语音服务器

2025/2/14

【本文约1150字】

前言

TeamSpeak 是一款广泛使用的低延迟语音通信工具，适用于游戏团队、远程协作等场景。借助 Docker 容器化技术，我们可以快速在单台 Ubuntu 服务器上部署多个独立的 TeamSpeak 实例，每个实例拥有独立的配置、数据和端口，实现资源高效隔离与管理。本教程将详细介绍从零搭建多个 TeamSpeak 服务器的全流程。

一. 环境准备

1. 系统要求

  • 操作系统：Ubuntu 22.04 LTS 或更高版本（其他版本操作类似）
  • 硬件：至少 1GB 内存，10GB 磁盘空间
  • 网络：开放 UDP 端口（如 9987、9988 等）

2. 安装 Docker

# 更新软件包列表
sudo apt update
# 添加阿里云密钥
curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
# 载入软件源
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] http://mirrors.aliyun.com/docker-ce/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 更新软件源
sudo apt update
# 安装 Docker 引擎
sudo apt install docker-ce
# 启动 Docker 并设置开机自启
sudo usermod -aG docker $USER
# 更新用户组
newgrp docker
# 设置镜像加速
sudo vim /etc/docker/daemon.json

3. 验证 Docker 安装

docker --version  # 输出版本信息（如 Docker 24.0.7）
docker run hello-world  # 运行测试容器

二. 部署第一个 TeamSpeak 服务器

1. 拉取官方镜像

docker pull teamspeak:latest

2. 创建数据存储目录

mkdir -p ~/teamspeak/server1/data

3. 启动容器

docker run -d \
  --name teamspeak-server1 \
  -p 9987:9987/udp \
  -p 10011:10011 \
  -p 30033:30033 \
  -v ~/teamspeak/server1/data:/var/ts3server \
  teamspeak:latest

参数解释：

  • -d：后台运行容器

  • --name：容器名称（可自定义）

  • -p

    ：端口映射（格式：

    主机端口:容器端口

    ）

    • 9987/udp：语音通信默认端口
    • 10011：ServerQuery 管理端口
    • 30033：文件传输端口

  • -v：挂载数据卷，持久化配置和数据库

4. 获取管理员密钥

docker logs teamspeak-server1 | grep "ServerAdmin privilege key"

输出示例：

ServerAdmin privilege key created: FOOBarBazQUX=...

保存此密钥，首次登录 TeamSpeak 客户端时需使用。

四、部署第二个 TeamSpeak 服务器

1. 创建新数据目录

mkdir -p ~/teamspeak/server2/data

2. 启动第二个容器

docker run -d \
  --name teamspeak-server2 \
  -p 9988:9987/udp \          # 修改主机端口为 9988
  -p 10012:10011 \            # 修改 ServerQuery 端口
  -p 30034:30033 \            # 修改文件传输端口
  -v ~/teamspeak/server2/data:/var/ts3server \
  teamspeak:latest

3. 获取第二个实例的管理员密钥

docker logs teamspeak-server2 | grep "ServerAdmin privilege key"

五、客户端连接指南

1.下载 TeamSpeak 客户端：访问 https://www.teamspeak.com

2.连接服务器：

  • 地址：服务器IP:主机端口（如 123.45.67.89:9987 或 :9988）
  • 昵称：自定义名称
  • 密码：留空（除非设置了密码）

3.获取管理员权限：

首次连接后输入之前记录的权限密钥。

六、高级配置与维护

1. 管理多个容器

# 查看运行中的容器
docker ps
# 停止/启动容器
docker stop teamspeak-server1
docker start teamspeak-server1
# 删除容器（数据仍保留在宿主机）
docker rm teamspeak-server1

2. 自定义配置文件

TeamSpeak 配置文件位于挂载目录的 ts3server.ini，可按需修改：

nano ~/teamspeak/server1/data/ts3server.ini

3. 防火墙配置

若使用 UFW 防火墙，需放行端口：

sudo ufw allow 9987:9988/udp
sudo ufw allow 10011:10012/tcp
sudo ufw allow 30033:30034/tcp

七、常见问题排查

1. 端口冲突

错误提示 Bind for 0.0.0.0:9987 failed: port is already allocated 解决：确保主机端口未被占用，或更换为其他端口。

2. 权限问题

若挂载目录权限不足，运行容器时添加 --user $(id -u):$(id -g)。

3. 数据备份

直接备份宿主机目录 ~/teamspeak/server*/data。

八、总结

通过 Docker，我们在 Ubuntu 服务器上快速部署了多个独立的 TeamSpeak 实例，实现了资源隔离与灵活管理。此方法不仅节省硬件成本，还便于后续扩展和维护。无论是个人用户还是企业团队，均可按需调整实例数量和配置，打造高效的语音通信环境。

附录