mlabbe/ts3server

docker: ts3server

注意：此镜像已不再维护，请使用官方https://hub.docker.com/_/teamspeak/%E9%95%9C%E5%83%8F%E6%9B%BF%E4%BB%A3%E3%80%82

这是一个用于运行TeamSpeak 3服务器的Docker镜像。

镜像概述

该镜像基于Alpine系统构建，旨在提供轻量、便捷的TeamSpeak3服务器部署方案，支持持久化存储关键数据（数据库、配置文件、日志等），并以非root用户身份运行以提升安全性。

核心功能

• 持久化存储：数据库、配置文件（ini/白名单/黑名单）及日志文件存储于持久化目录
• 自动初始化：若持久化目录无相关文件，将自动创建所需文件/文件夹
• 非root运行：以普通用户身份启动服务，降低安全风险
• 轻量高效：镜像体积小、层数少，资源占用低

使用场景

适用于需要搭建TeamSpeak3语音服务器的场景，如游戏团队沟通、远程协作等（注：建议优先使用官方维护的镜像）。

配置说明

准备持久化存储文件夹

在Docker主机上创建用于存储持久化数据的文件夹：

sh
mkdir {FOLDER}
chown 1000:1000 {FOLDER}

将{FOLDER}替换为实际绝对路径（如/docker-persist/ts3server），该文件夹将映射到容器内的/data目录，用于存储数据库和配置文件。

若手动移动文件到持久化目录，需确保权限正确：

sh
chown -R 1000:1000 {FOLDER}

拉取镜像

从Docker Hub拉取最新镜像：

sh
docker pull mlabbe/ts3server

v3.1.0+重要变更

• 计费通信改为HTTPS，需调整防火墙规则
• 需接受许可协议才能启动服务器：
  • 临时方式：在docker run命令中添加-e TS3SERVER_LICENSE=view
  • 永久方式：在持久化目录创建.ts3server_license_accepted文件（内容可空）

运行镜像

启动TeamSpeak3服务器：

sh
docker run --restart=unless-stopped --name=ts3server -d -e TS3SERVER_LICENSE=view -p 9987:9987/udp -p 30033:30033 -p 10011:10011 -v {FOLDER}:/data mlabbe/ts3server

• 若无需ServerQuery或文件传输，可仅映射9987/udp端口
• 可修改主机端口映射（如9988:9987/udp）

首次运行

首次运行时，若持久化目录无数据库，将自动创建。通过日志获取管理员密码和权限令牌：

sh
docker logs ts3server

日志中会包含ServerAdmin账号密码及特权令牌，需记录保存。

升级镜像

由于数据存储在持久化目录，只需拉取新镜像并重启容器：

sh
docker pull mlabbe/ts3server
docker stop ts3server
docker rm ts3server
docker run --restart=unless-stopped --name=ts3server -d -p 9987:9987/udp -p 30033:30033 -p ***:*** -v {FOLDER}:/data mlabbe/ts3server