enlightenedza/teamspeak3

docker-teamspeak3

该Docker镜像提供TeamSpeak3服务器，启动时会自动下载最新稳定版本，也可运行或升级到特定版本。详情见下方“版本”部分。

使用方法

基本运行（最新稳定版）

要使用最新稳定版，运行以下命令：

bash
docker run -d -p 9987:9987/udp -p 10011:10011 -p 30033:30033 --name=ts3-server docker.xuanyuan.run/aheil/teamspeak3-server

默认服务器端口会暴露在主机上。若需部署多个服务器或使用替代端口，修改主机侧端口映射即可，例如：

bash
docker run -d -p 9988:9987/udp -p 10012:10011 -p 30034:30033 ...

这会将TeamSpeak3服务器映射到主机的9988/udp、***/tcp、30034/tcp端口（-p语法为主机端口:容器端口）。

使用--name参数为容器指定明确名称，便于管理多个服务器。

若数据目录中无ts3server.ini文件，服务器会以createinifile=1启动；后续运行则使用inifile=/data/ts3server.ini。

首次运行

首次启动服务器时，需获取管理员令牌：

1. 启动容器：

   bash
   docker run -d -p 9987:9987/udp -p 10011:10011 -p 30033:30033 --name=ts3-server docker.xuanyuan.run/aheil/teamspeak3-server
   

2. 查看日志获取令牌：

   bash
   docker logs -f ts3-server
   

日志中有两个重要部分：

• 服务器查询管理员账户：

  ------------------------------------------------------------------
                        I M P O R T A N T                           
  ------------------------------------------------------------------
                 Server Query Admin Account created                 
           loginname= "serveradmin", password= "qyF2d07R"
  ------------------------------------------------------------------
  

• ServerAdmin权限密钥：

  ------------------------------------------------------------------
                        I M P O R T A N T                           
  ------------------------------------------------------------------
        ServerAdmin privilege key created, please use it to gain 
        serveradmin rights for your virtualserver. please
        also check the doc/privilegekey_guide.txt for details.
  
         token=P5fO1Cbbv5DbM5kg9xR3LlfpYjlJe6cT9QeMhjY+
  ------------------------------------------------------------------
  

请复制这些信息以备后续使用！

挂载数据目录到主机文件系统

为了方便访问TeamSpeak3数据，使用-v参数将主机目录映射到容器的/data目录：

1. 创建主机目录：

   bash
   mkdir -p /path/on/host
   chown 1000:1000 /path/on/host
   

2. 启动容器时挂载目录：

   bash
   docker run -d -v /path/on/host:/data ... --name=ts3-server ...
   

挂载后，可停止服务器（docker stop ts3-server），编辑主机挂载目录下的配置文件，再启动服务器（docker start ts3-server）以应用新配置。

注意：挂载目录中的文件将由UID为1000的主机用户拥有。若主机无此用户，请创建（如adduser --uid 1000 ...）。

版本

要使用不同的TeamSpeak3版本，传递TS_VERSION环境变量，其值可以是：

• LATEST（最新稳定版）
• 特定版本（如"3.0.10.2"）

例如，使用特定版本：

bash
docker run -d -e TS_VERSION=3.0.10.2 ... --name=ts3-server ...

有效版本列表可查看这里，或自行使用https://github.com/andreasheil/ts3versions。