qmcgaw/teamspeak3-alpine

TeamSpeak 3.12服务器 (Alpine版)

23MB的Docker容器，运行TeamSpeak 3.12.1服务器。

镜像概述和主要用途

该镜像基于Alpine 3.12构建，包含TeamSpeak 3.12.1服务器及必要依赖（libstdc++、CA-Certificates），旨在提供轻量级、安全高效的语音通信服务。适用于游戏团队、小型社区等需要稳定语音交流的场景。

核心功能和特性

• 低体积：镜像大小仅23MB，资源占用少
• 定期健康检查：确保服务持续稳定运行
• 无root运行：提升安全性，降低权限风险
• 极简设计：去除mariadb选项，专注核心功能
• 架构限制：仅支持amd64架构（因TeamSpeak仅提供amd64构建版本）

使用场景和适用范围

• 游戏团队语音通信服务器
• 小型社区实时语音交流平台
• 轻量化企业内部语音会议系统
• 开发/测试环境的临时语音服务

详细使用方法和配置说明

环境准备

1. 创建持久化目录（如需数据持久化）

bash
mkdir -p data logs
chown 1000 data logs  # 设置目录所有者为UID 1000（容器默认运行用户）
chmod 700 data logs   # 设置目录权限为仅所有者可读写

注意：若需使用其他UID，可将chown命令中的1000替换为目标UID（如8000），并在运行容器时添加--user=8000参数。

启动容器

使用docker run命令

bash
docker run -d -p 9987:9987/udp -p 10011:10011/tcp -p 30033:30033/tcp \
  -v $(pwd)/data:/teamspeak/data -v $(pwd)/logs:/teamspeak/logs \
  qmcgaw/teamspeak3-alpine license_accepted=1

端口说明：

• UDP 9987：主语音服务器端口
• TCP ***：文件传输端口
• TCP 30033：远程管理端口

目录说明：

• data：包含数据库文件（ts3server.sqlitedb）及IP黑白名单（query_ip_blacklist.txt、query_ip_whitelist.txt）
• logs：存储文本日志文件

使用docker-compose

创建docker-compose.yml文件（可参考https://github.com/qdm12/teamspeak-server-alpine/blob/master/docker-compose.yml%EF%BC%89%EF%BC%8C%E7%84%B6%E5%90%8E%E6%89%A7%E8%A1%8C%EF%BC%9A

bash
docker-compose up -d

首次运行注意事项

若绑定挂载的目录为空，首次运行后需在主机执行：

bash
chmod 700 data/ts3server.sqlitedb

连接服务器

客户端连接步骤

1. 从TeamSpeak官网下载客户端并安装
2. 获取Docker主机的LAN IP地址：

   bash
   ip address
   

3. 获取管理员token：

   bash
   docker logs <容器名称或ID>
   

   日志中会包含类似以下内容的管理员token：

   2018-04-16 02:54:18.228825|WARNING |VirtualServer |1  |token=u3bJyR+ZcUJRxgJ+CKsJmQgygR+gMuPMz7qkyaQa
   

4. 启动TeamSpeak客户端，输入主机LAN IP地址和管理员token，完成管理员身份验证

公网访问配置

1. 登录路由器管理界面（通常为[***]
2. 转发以下端口到Docker主机：
   • TCP *** → ***
   • TCP 30033 → 30033
   • UDP 9987 → 9987
3. 获取主机公网IP：

   bash
   wget -qO- https://ipinfo/ip
   

4. 使用公网IP或域名在TeamSpeak客户端中连接服务器

后续配置建议

• 全局启用语音加密（右键服务器→编辑虚拟服务器→安全选项卡→启用频道语音加密）
• 设置服务器密码
• 配置用户权限
• 创建和管理频道

待办事项

• 环境变量支持
• ***IP封禁功能
• 基于Scratch镜像构建