cmr1/ts3-bot-verify-gw2

docker-ts3-bot-verify-gw2

镜像概述

本Docker镜像封装了TeamSpeak 3（TS3）机器人，专注于激战2（GW2）玩家账号验证：通过校验玩家所属世界（主世界/关联世界），自动为用户分配对应TS3权限组，适用于GW2社群的TS3服务器自动化管理。

核心功能

• 连接TS3服务器并监听用户验证请求
• 校验GW2账号的所属世界信息
• 根据验证结果自动添加用户到预设TS3权限组
• 支持环境变量自定义配置（机器人名称、TS3地址、GW2世界与组映射等）

使用场景

适用于激战2玩家社群的TS3服务器，帮助管理员减少人工审核成本，确保合法玩家加入对应社群组，提升服务器管理效率。

配置说明

安装方式

从DockerHub拉取镜像：

bash
docker pull cmr1/ts3-bot-verify-gw2

或从GitHub克隆构建：

bash
git clone https://github.com/cmr1/docker-ts3-bot-verify-gw2.git
docker build -t cmr1/ts3-bot-verify-gw2 ./docker-ts3-bot-verify-gw2/

基础使用

前台运行：

bash
docker run -it cmr1/ts3-bot-verify-gw2

后台运行：

bash
docker run -d cmr1/ts3-bot-verify-gw2

注意：Docker容器内127.0.0.1非本地主机，需用172.17.0.2连接本地TS3服务器。

自定义配置

通过环境变量配置参数：

bash
docker run -it \
  -e BOT_NAME="Woodhouse" \
  -e TS3_HOST="172.17.0.2" \
  -e TS3_CHANNEL="Server Verify Bot" \
  -e GW2_HOME_WORLD="Sea of Sorrows" \
  -e GW2_HOME_GROUP="Verified" \
  -e GW2_LINKED_WORLDS="Devona's Rest" \
  -e GW2_LINKED_GROUP="Linked" \
  cmr1/ts3-bot-verify-gw2

可用环境变量

bash
# 机器人设置
BOT_NAME="Woodhouse"  # 机器人名称（默认：Woodhouse）
BOT_VERBOSE=0         # 启用详细输出（非0值生效，默认：false）

# TS3设置
TS3_SID=1                       # 虚拟服务器SID（默认：1）
TS3_USER=serveradmin            # ServerQuery用户名（默认：serveradmin）
TS3_PASS=password               # ServerQuery密码（必填）
TS3_CHANNEL="Server Verify Bot" # 机器人加入频道
TS3_HOST="172.17.0.2"           # TS3服务器地址（默认：127.0.0.1）
TS3_PORT=***                  # ServerQuery端口（默认：***）

# GW2验证设置
GW2_HOME_WORLD="Sea of Sorrows"   # 主世界（默认：null）
GW2_HOME_GROUP="Verified"         # 主世界玩家组（默认：Normal）
GW2_LINKED_WORLDS="Devona's Rest" # 关联世界列表（逗号分隔，默认：null）
GW2_LINKED_GROUP="Linked"         # 关联世界玩家组（默认：Normal）