🎵 Ts3AudioBot 音乐机器人部署教程（支持网易云 / QQ音乐）

约 1116 字大约 4 分钟

2025-06-29

📌 观前提示：本教程基于 Linux，目标是部署一套支持网易云和 QQ 音乐的机器人系统。

📦 1. 安装 Ts3AudioBot

这是部署机器人的基础。

🔗 源码地址：TS3AudioBot GitHub
下载适合你系统的版本（例：TS3AudioBot_linux_x64.tar.gz）
解压并进入目录：

tar -zxvf TS3AudioBot_linux_x64.tar.gz
cd TS3AudioBot

修改right.toml

# Rights declaration file
# For more information about syntax and structure see here:
# https://github.com/Splamy/TS3AudioBot/wiki/Rights

"+" = [
	# Basic stuff
	"cmd.help.*",
	"cmd.pm",
	"cmd.subscribe",
	"cmd.unsubscribe",
	"cmd.kickme.*",
	"cmd.version",

	# Getting song info
	"cmd.song",
	"cmd.repeat",
	"cmd.random",

	# Conditionals and basic scripting
	"cmd.if",
	"cmd.print",
	"cmd.rng",
	"cmd.eval",
	"cmd.take",
	"cmd.xecute",
	"cmd.getmy.*",
	"cmd.json.*",
	"cmd.bot.use",
	"cmd.rights.can",
    "cmd.yun.*",
]

# Admin rule
[[rule]]
	# Set your admin Group Ids here, ex: [ 13, 42 ]
	groupid = [6]
	# And/Or your admin Client Uids here
	useruid = [ "KNSQMSMvHvwCSGq3si0ne+GEnvk=" ]
	# By default treat requests from localhost as admin
	ip = [ "127.0.0.1", "::1" ]

	"+" = "*"

# Playing rights
[[rule]]
	# Set Group Ids you want to allow here, ex: [ 13, 42 ]
	groupid = []
	# And/Or Client Uids here, ex [ "uA0U7t4PBxdJ5TLnarsOHQh4/tY=", "8CnUQzwT/d9nHNeUaed0RPsDxxk=" ]
	useruid = []
	# Or remove groupid and useruid to allow for everyone

	"+" = [
		# Play controls
		"cmd.play",
		"cmd.pause",
		"cmd.stop",
		"cmd.seek",
		"cmd.volume",

		# Playlist management
		"cmd.list.*",
		"cmd.add",
		"cmd.clear",
		"cmd.previous",
		"cmd.next",
		"cmd.random.*",
		"cmd.repeat.*",

		# History features
		"cmd.history.add",
		"cmd.history.from",
		"cmd.history.id",
		"cmd.history.last",
		"cmd.history.play",
		"cmd.history.till",
		"cmd.history.title",
	]

启动服务：

./TS3AudioBot

首次运行会提示初始化，请按照提示填写 TeamSpeak 服务器地址等信息。

✅ 若在 TeamSpeak 中看到机器人上线，说明部署成功！

🧩 2. 添加音乐插件

完成初始化后，你的文件结构可能如下所示：

若无 plugins 文件夹，请手动创建

下载插件

推荐使用大佬 @577fkj 开发的插件：

插件主页：TS3AudioBot-CloudMusic-plugin
下载 Release 中的 YunPlugin.zip
解压所有文件到 plugins/ 目录中。

添加配置文件

在你的主目录下 .net/ 文件夹的以下路径中创建插件文件夹：创建文件 YunSettings.json 并粘贴以下内容（修改关键参数，如 API 地址和 Cookie）：

{
  "Version": 1,
  "PlayMode": "RandomPlay",
  "AutoPause": true,
  "DefaultApi": "Netease",
  "Apis": [
    {
      "Enable": true,
      "Type": "Netease",
      "Alias": ["n", "wy", "wyy"],
      "Config": {
        "RefreshCookie": false,
        "CookieUpdateIntervalMin": 30,
        "Header": {
          "Cookie": "",
          "User-Agent": "Mozilla/5.0..."
        },
        "ApiServerUrl": "http://127.0.0.1:3000"
      }
    },
    {
      "Enable": true,
      "Type": "QQMusic",
      "Alias": ["q", "qq"],
      "Config": {
        "RefreshCookie": false,
        "CookieUpdateIntervalMin": 30,
        "Header": {
          "Cookie": "",
          "User-Agent": "Mozilla/5.0..."
        },
        "Uin": "12345",
        "ApiServerUrl": "http://127.0.0.1:3001"
      }
    }
  ]
}

插件配置说明请查阅：插件主页

替换主程序文件

停止当前 TS3AudioBot 服务
下载地址：TS3AudioBot-NetEaseCloudmusic-plugin
替换完成后重启服务进行测试

🔹 加载插件

进入 TS3 后发送指令至机器人私聊：

!plugin list

机器人应回复：

All available plugins:
#0|+ON|YunPlugin (BotPlugin)

然后执行加载：

!plugins load 0

若无错误提示则加载成功

🧩 3. 搭建 API 服务

网易云音乐 API

项目地址：Binaryify/NeteaseCloudMusicApi
启动服务后确保端口与 YunSettings.json 中一致（默认 3000）

QQ 音乐 API

项目地址：yuanter/QQMusicApi
注意端口（与配置文件相同）

📖 4. 常用指令

平台支持别名（如 n 表示网易云，q 表示 QQ 音乐）

[] 为必填参数，{} 为可选参数

命令	格式	说明
login	`!yun login [平台] [方式]`	登录
play	`!yun play {平台} [关键词/ID]`	播放音乐
add	`!yun add {平台} [关键词/ID]`	添加下一首
next	`!yun next`	下一首
gedan	`!yun gedan {平台} [歌单名/ID] {长度}`	播放歌单
zhuanji	`!yun zhuanji {平台} [专辑名/ID] {长度}`	播放专辑
mode	`!yun mode [模式ID]`	播放模式
list	`!yun list`	当前列表
clear	`!yun clear`	清空列表
stop	`!yun stop`	停止播放
start	`!yun start`	恢复播放
status	`!yun status`	查看状态
reload	`!yun reload`	重载配置