devalx/docker-teamspeak3

docker-teamspeak3

基于Ubuntu系统的Teamspeak 3服务器Docker镜像，支持数据持久化与灵活配置。

重要环境变量TS3SERVER_LICENSE

自Teamspeak某版本起，必须将环境变量TS3SERVER_LICENSE设置为"accept"才能启动服务器，否则仅打印许可未接受信息。可设置为"view"查看协议，务必阅读并明确接受。

docker-compose.yml示例（2018年8月9日）

先创建持久化数据卷：

bash
docker volume create ts3-data

yaml
version: "3.7"
services:
  server:
    image: devalx/docker-teamspeak3:latest
    environment:
      - TS3SERVER_LICENSE=accept
    ports:      
      - 9987:9987/udp      
      - 10011:10011
      - 30033:30033
    volumes:
      - ts3-data:/home/ts3/data
volumes:
  ts3-data:
   external: true

核心特性

• Ubuntu系统 + Teamspeak 3服务器
• 支持挂载主机文件：query_ip_whitelist.txt、query_ip_blacklist.txt、日志、数据库文件等
• 可通过TS3_UID环境变量调整运行用户UID，解决权限问题

更新说明

新镜像使用专用用户（ts3，默认UID=1000）运行服务，旧数据需调整文件所有权。卷路径略有变更，部署命令需适配。

Docker卷部署（推荐）

bash
docker volume create --name ts3-data
docker run --name=ts3 -p 9987:9987/udp -p 30033:30033 -p 10011:10011 -v ts3-data:/home/ts3/data devalx/docker-teamspeak3:latest

主机目录挂载

bash
docker run --name ts3 -d -p 9987:9987/udp -p 30033:30033 -p 10011:10011 -v {本地目录}:/home/ts3/data devalx/docker-teamspeak3:latest

权限调整示例

bash
docker run --name ts3 -d -e TS3_UID=1001 -p 9987:9987/udp -p 30033:30033 -p 10011:10011 -v {本地目录}:/home/ts3/data devalx/docker-teamspeak3:latest

管理员密钥获取

启动后通过日志查看： sudo docker logs ts3

升级注意事项

停止并删除旧容器后重新启动即可，建议备份数据以防文件覆盖。

SELinux适配

若主机启用SELinux，需添加:z选项：

bash
docker run --name ts3 -d -p 9987:9987/udp -p 30033:30033 -p 10011:10011 -v /data/teamspeak:/home/ts3/data:z devalx/docker-teamspeak3:latest

详情见#6

MariaDB支持

该功能仍在开发中。