hackebein/ts3server Docker Image Overview

hackebein/ts3server

自动构建

hackebein

TeamSpeak 3服务器Docker镜像，提供基于VoIP的实时语音通信服务，支持用户通过客户端连接服务器加入聊天频道，适用于团队协作、游戏语音等场景。

4 次收藏下载次数: 0状态：自动构建维护者：hackebein仓库类型：镜像最近更新：1 年前

使用轩辕镜像，把时间还给真正重要的事。点击查看

中文简介版本下载

使用轩辕镜像，把时间还给真正重要的事。点击查看

TeamSpeak 3 Docker镜像文档

镜像概述

TeamSpeak 3是一款专有的VoIP（网络语音协议）应用程序，用于用户间的实时音频通信，功能类似电话会议。用户通过客户端软件连接到指定的TeamSpeak服务器，加入不同的聊天频道进行语音交流。本Docker镜像提供了便捷的TeamSpeak 3服务器部署方式，支持多种配置参数，满足不同场景需求。

核心功能与特性

实时语音通信：支持多用户同时在线语音聊天，低延迟、高音质
灵活配置：通过环境变量自定义服务器参数，如许可证状态、数据库设置、端口配置等
数据库支持：默认使用SQLite3，也可配置MariaDB/MySQL数据库
安全特性：支持查询密码保护、IP黑白名单、暴力破解防护
自定义补丁：可启用 GDPR 合规优化、隐藏用户徽章等功能
日志管理：可配置日志路径、保留天数及查询命令日志记录

使用场景

游戏团队语音：游戏玩家实时沟通战术与协作
远程团队协作：分布式团队的语音会议与即时沟通
在线社区交流：兴趣社群的多人语音互动平台
教育/培训场景：远程教学中的实时语音互动

使用方法

快速启动

基本部署命令

bash
docker run \
    -e "TS3SERVER_LICENSE=accept" \
    -p 9987:9987/udp \
    -p 30033:30033 \
    -p ***:*** \
    hackebein/ts3server

说明：

9987/udp：语音通信端口

30033：文件传输端口

***：服务器查询端口

首次启动需接受许可证，设置TS3SERVER_LICENSE=accept

环境变量配置

基础配置

环境变量	默认值	支持版本	说明
TS3SERVER_LICENSE	view	3.1.0+	许可证状态：设置为"accept"表示接受许可协议（必须设置才能启动）；"view"仅查看许可证（无法启动）
TS3SERVER_QUERY_PASSWORD	<随机>	3.0.0+	服务器查询管理员密码
TS3SERVER_DB_CLIENT_DAYS	90	3.0.0+	未使用客户端身份的保留天数，每月自动清理

自定义补丁

环境变量	默认值	支持版本	说明
TS3SERVER_PATCH_ENABLE	false	3.0.0+	是否启用服务器补丁程序
TS3SERVER_PATCH_BADGES_DISABLE	false	3.0.9+	是否隐藏其他用户的徽章
TS3SERVER_PATCH_GDPR_SAVE	false	3.0.0+	是否减少IP地址存储以符合GDPR要求

数据库配置

环境变量	默认值	支持版本	说明
TS3SERVER_DB_PLUGIN	ts3db_sqlite3	3.0.0+	数据库插件类型：ts3db_sqlite3（默认）、ts3db_mariadb
TS3SERVER_DB_SQL_CREATE_PATH	create_sqlite	3.0.0+	SQL创建脚本路径：create_sqlite（默认）、create_mariadb
TS3SERVER_DB_HOST	127.0.0.1	3.0.0+	MariaDB/MySQL服务器地址
TS3SERVER_DB_PORT	3306	3.0.0+	MariaDB/MySQL服务器端口
TS3SERVER_DB_USER	root	3.0.0+	数据库认证用户名
TS3SERVER_DB_PASSWORD	空	3.0.0+	数据库认证密码
TS3SERVER_DB_NAME	test	3.0.0+	数据库名称（需预先创建，推荐使用utf8mb4编码）
TS3SERVER_DB_LOG_DAYS	90	3.0.0+	数据库日志保留天数，每月自动清理
TS3SERVER_DB_LOGGING_DISBALE	1/true	3.0.0+	是否禁用数据库日志记录

高级配置

环境变量	默认值	支持版本	说明
TS3SERVER_CRASHDUMPS	crashdumps	3.6.0+	崩溃转储文件保存路径（FreeBSD和Alpine版本不支持）
TS3SERVER_DB_CLEAR	0/false	3.0.0+	是否在启动前清空数据库（仅用于测试）
TS3SERVER_DB_CONNECTIONS	10	3.0.0+	数据库连接数（2-100，影响性能）
TS3SERVER_FILETRANSFER_IP	0.0.0.0	3.0.0+	文件传输绑定IP列表（逗号分隔）
TS3SERVER_FILETRANSFER_PORT	30033	3.0.0+	文件传输端口
TS3SERVER_LOG_PATH	logs	3.0.0+	日志文件保存路径
TS3SERVER_VOICE_DEFAULT_PORT	9987	3.0.0+	默认语音通信端口（后续虚拟服务器端口递增）
TS3SERVER_VOICE_IP	0.0.0.0	3.0.0+	语音服务绑定IP列表（逗号分隔）

Docker Compose示例

yaml
version: '3'
services:
  ts3server:
    image: hackebein/ts3server
    environment:
      - TS3SERVER_LICENSE=accept
      - TS3SERVER_QUERY_PASSWORD=your_secure_password
      - TS3SERVER_DB_PLUGIN=ts3db_mariadb
      - TS3SERVER_DB_HOST=mariadb
      - TS3SERVER_DB_USER=ts3user
      - TS3SERVER_DB_PASSWORD=ts3pass
      - TS3SERVER_DB_NAME=ts3db
    ports:
      - "9987:9987/udp"   # 语音端口
      - "30033:30033"     # 文件传输端口
      - "***:***"     # 查询端口
    depends_on:
      - mariadb
    restart: unless-stopped

  mariadb:
    image: mariadb:latest
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
      - MYSQL_DATABASE=ts3db
      - MYSQL_USER=ts3user
      - MYSQL_PASSWORD=ts3pass
    volumes:
      - mariadb_data:/var/lib/mysql
    restart: unless-stopped

volumes:
  mariadb_data: