james58899/musicbot Docker 镜像 - 轩辕镜像

MusicBot 镜像文档

概述

MusicBot 是一个轻量级Docker镜像，用于快速部署音乐机器人服务。该镜像旨在简化音乐机器人的搭建流程，支持在主流聊天平台（如***）中提供音乐播放、播放列表管理及音频控制功能，适用于个人或社区场景的音乐服务需求。

核心功能与特性

• 多源音乐播放：支持从***、Spotify、SoundCloud等主流音频平台获取资源并播放
• 播放队列管理：支持添加、移除、排序曲目，以及保存/加载自定义播放列表
• 音频控制功能：提供暂停、继续、跳过、音量调节（0-100%）、循环播放等基础控制
• 跨平台集成：原生支持***等聊天平台，通过API实现消息监听与指令响应
• 配置灵活性：支持通过环境变量或配置文件自定义机器人参数（如指令前缀、权限设置）

使用场景

• 社区聊天服务器：为***社区提供背景音乐播放服务，增强互动体验
• 线上活动辅助：用于线上聚会、游戏社群等场景的背景音乐控制
• 个人娱乐工具：在私人聊天频道中便捷播放和管理个人音乐收藏
• 内容创作支持：为直播、视频录制等场景提供背景音乐自动化控制

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+推荐）
• 拥有目标平台（如***）的机器人令牌（需在平台开发者后台创建应用并获取）

快速启动（docker run）

bash
docker run -d \
  --name musicbot \
  -e BOT_TOKEN="your_***_bot_token" \
  -e PREFIX="!" \
  -e DEFAULT_VOLUME=50 \
  --restart unless-stopped \
  musicbot:latest

Docker Compose 配置示例

yaml
version: '3.8'
services:
  musicbot:
    image: musicbot:latest
    container_name: musicbot
    environment:
      - BOT_TOKEN=your_***_bot_token  # 平台机器人令牌（必填）
      - PREFIX=!                          # 指令前缀（默认"!"）
      - DEFAULT_VOLUME=50                 # 默认音量（0-100，默认50）
      - ALLOW_***=true                # 是否启用***支持（默认true）
      - SPOTIFY_CLIENT_ID=your_client_id  # Spotify客户端ID（如需Spotify支持）
      - SPOTIFY_CLIENT_SECRET=your_secret # Spotify客户端密钥（如需Spotify支持）
    restart: unless-stopped

核心配置参数

基础使用指令

• !play <关键词/URL>：搜索并播放指定歌曲（支持URL或关键词搜索）
• !pause：暂停当前播放
• !resume：恢复播放
• !skip：跳过当前歌曲
• !volume <0-100>：调整播放音量
• !queue：查看当前播放队列
• !clear：清空播放队列
• !stop：停止播放并退出语音频道

注意事项

• Spotify集成需提前在Spotify Developer Dashboard申请API凭证
• 容器需保持网络通畅以访问音频资源和平台API
• 不同版本镜像功能可能存在差异，建议通过docker logs musicbot查看运行日志排查问题