deploy qq

部署无头客户端

作为 QQ 机器人，我们需要一个渠道将消息推送到 QQ，并且将 QQ 的消息推送回 BBot 中。这个渠道通常被我们称为无头客户端，常见的有Mirai、go-cqhttp、Walle-Q等，目前 BBot 使用的无头客户端为 mcl + mirai-api-http 的方案。说不定将来会增添别的无头客户端支持

Mirai部署教程

Mirai 的部署可以参考 GraiaX 文档 中的部署教程，也可参考视频教程进行部署。本节将会重点介绍文档中 配置 Mirai Api Http 参数 在 BBot 下如何配置。

我们先来查看一下文档中提供的默认配置:

adapters:
  - http
  - ws
debug: false
enableVerify: true
verifyKey: GraiaxVerifyKey # 你可以自己设定，这里作为示范
singleMode: false
cacheSize: 4096
adapterSettings:
  http:
    host: localhost
    port: 8080
    cors: [*]
  ws:
    host: localhost
    port: 8080
    reservedSyncId: -1

verify_key 参数的设定可以需要和配置项中的 mirai/verify_key 参数置保持一致。

adapterSettings 中的 host 以及 port，在按照 http://host:port 的格式拼接之后，需要与配置项中的 Mirai/mirai_host 相互对应。

• 如果您的 Mirai 与 BBot 部署在同一服务器上，host 需要保持一致，为 localhost 或 127.0.0.1。
• 如果您的 Mirai 与 BBot 部署在不同服务器上，mirai-api-http 中需要填写 0.0.0.0，BBot 中需要填写 Mirai 所在服务器的IPv4地址。

值得注意的是，默认的 port 取值为 8080，而这是多种程序的默认监听端口，若保持默认可能会造成端口冲突，强烈推荐将端口号更换为取值在 10000 - 65535 间的随机数，以防止潜在的端口冲突。

例如，下方便是一个合法的 mirai-api-http 配置文件：

adapters:
  - http
  - ws
debug: false
enableVerify: true
verifyKey: BBotVerifyKey # 需要修改并匹配的对象
singleMode: false
cacheSize: 4096
adapterSettings:
  http:
    host: localhost # 需要修改并匹配的对象
    port: 34986     # 需要修改并匹配的对象
    cors: [*]
  ws:
    host: localhost # 需要修改并匹配的对象，需要与 `http` 中的 `host` 保持一致
    port: 34986     # 需要修改并匹配的对象，需要与 `http` 中的 `port` 保持一致
    reservedSyncId: -1

与之对应的 BBot 配置文件中需要匹配的参数应如下设置：

Mirai:
  mirai_host: http://localhost:34986 # 需要修改并匹配的对象
  verify_key: BBotVerifyKey          # 需要修改并匹配的对象
  account: <填机器人的QQ号>

其他配置项请参考 填写配置文件 中的介绍进行填写。