摘要

本技术文档详述了为 TeamSpeak 3 (TS3) 服务器部署 TSDNS（TeamSpeak DNS）服务的完整流程：通过在 Docker 容器中运行 TSDNS 实例，管理员可以获得一个集中化、高灵活性的域名解析层，从而为多个游戏服务器或社群提供简洁、免端口的连接地址

1. 前置条件

• 主机环境: 拥有公网 IPv4 地址的 Linux 服务器
• 域名: 一个可由您管理的有效域名
• 软件依赖: 服务器已安装 Docker Engine
• 基础知识: 掌握基本的 Linux Shell 操作及 Docker 命令

2. 架构规划与解析流程

在部署之前，必须明确整个解析流程 当 TeamSpeak 客户端尝试连接一个域名时，其解析顺序如下：

1. TSDNS SRV 查询: 客户端首先查询 _tsdns._tcp.example.com 的 SRV 记录
2. TSDNS 服务连接: 如果 SRV 记录存在，客户端会连接到记录指向的 TSDNS 服务器（在我们的架构中，即 ts-dns Docker 容器的 41144 端口）
3. 应用层解析: 客户端向 TSDNS 服务发送其尝试连接的原始域名（例如 game1.example.com）
4. 配置文件匹配: TSDNS 服务在 tsdns_settings.ini 文件中查找匹配的规则，并返回对应的 IP:端口
5. 语音服务连接: 客户端使用从 TSDNS 获取的最终地址，向目标 TeamSpeak 语音服务器发起连接

本教程将基于以下示例参数进行部署：

• 服务器公网 IP: 123.123.123.123
• 主域名: example.com
• 目标映射:
  • game1.example.com → 123.123.123.123:9986
  • 所有其他 *.example.com → 123.123.123.123:9987 (回退/默认)

3. TSDNS 服务部署

此步骤将创建一个独立的 Docker 容器来运行 TSDNS 服务

3.1 配置文件 (tsdns_settings.ini)

此文件是 TSDNS 服务的核心，定义了域名到地址的映射规则

1. 在主机上创建并编辑配置文件：

   mkdir -p /opt/tsdns_config
   nano /opt/tsdns_config/tsdns_settings.ini

2. 填入以下映射规则：

   # 为特定子域名 game1.example.com 指定 IP 和非标准端口 9986
   game1.example.com=123.123.123.123:9986
   
   # [最佳实践] 使用通配符为所有其他未明确定义的子域名提供一个回退地址
   *.example.com=123.123.123.123:9987

3.2 Docker 容器化部署

使用以下命令创建并启动 TSDNS 服务容器：

docker run -d \
  --name tsdns-server \
  --restart unless-stopped \
  -p 41144:41144/tcp \
  -v /opt/tsdns_config/tsdns_settings.ini:/data/tsdns_settings.ini:ro \
  -w /data \
  teamspeak:latest \
  /opt/ts3server/tsdns/tsdnsserver