elipef/ts3ab-wrapper

TS3AB-Wrapper

镜像概述

TS3AB-Wrapper是TS3AudioBot WebAPI的API网关，基于Node.js实现的轻量包装器，用于简化对TS3AudioBot的API层管理操作。

核心功能

• 支持通过UUID或组分配权限
• Bot全生命周期管理：启动、停止、创建、删除、编辑
• 启动时自动启用bot指挥官功能
• 配置启动默认歌曲与音量
• 支持bot命令别名设置

使用场景

适用于团队语音服务器中音乐机器人的集中化管理场景，如权限分配、状态控制、初始化配置等需求。

配置说明

权限类型

提供两种权限角色：admin和user，默认权限配置如下：

• admin：拥有所有操作权限

  '+': '*',
  '-': [],
  

• user：仅开放音乐播放相关操作权限

  '+': [
          'cmd.play',
          'cmd.pause',
          'cmd.stop',
          'cmd.seek',
          'cmd.volume',
          'cmd.list.*',
          'cmd.add',
          'cmd.clear',
          'cmd.previous',
          'cmd.next',
          'cmd.random.*',
          'cmd.repeat.*',
          'cmd.history.add',
          'cmd.history.from',
          'cmd.history.id',
          'cmd.history.last',
          'cmd.history.play',
          'cmd.history.till',
          'cmd.history.title',
        ],
        '-': [],
  

部署示例

推荐与TS3AudioBot镜像协同部署，docker-compose配置示例：

docker
version: "3"
services:
  ts3ab:
    image: ancieque/ts3audiobot
    container_name: ts3ab
    volumes:
      - ./ts3ab:/data
    restart: unless-stopped
    networks:
      - app-network

  ts3ab-wrapper:
    image: elipef/ts3ab-wrapper:latest
    container_name: ts3ab-wrapper
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./ts3ab/rights.toml:/usr/src/app/ts3audiobot/rights.toml
    environment:
      PORT: 8080
      TS3AUDIOBOT_URL: [***]
    networks:
      - app-network

networks:
  app-network:
    driver: bridge