mirror of https://github.com/suyiiyii/nonebot-bison.git synced 2025-06-05 11:26:43 +08:00

2021-12-07 22:23:29 +08:00

5.4 KiB

Raw Blame History

sidebar
auto

部署和使用

本节将教你快速部署和使用一个nonebot-bison，如果你不知道要选择哪种部署方式，推荐使用docker-compose

部署

本项目可以作为单独的Bot使用，可以作为nonebot2的插件使用

作为Bot使用

额外提供自动同意超级用户的好友申请和同意超级用户的加群邀请的功能

docker-compose部署（推荐）

在一个新的目录中下载docker-compose.yml
将其中的<your QQ>改成自己的QQ号
```
wget https://raw.githubusercontent.com/felinae98/nonebot-bison/main/docker-compose.yml
```

运行配置go-cqhttp

docker-compose run go-cqhttp

通信方式选择：3: 反向 Websocket 通信
编辑bot-data/config.yml，更改下面字段：

account: # 账号相关
  uin: <QQ号> # QQ账号
  password: "<QQ密码>" # 密码为空时使用扫码登录

message:
  post-format: array

............

servers:
  - ws-reverse:
      universal: ws://nonebot:8080/cqhttp/ws # 将这个字段写为这个值

登录go-cqhttp 再次
```
docker-compose run go-cqhttp
```
参考go-cqhttp文档完成登录
确定完成登录后，启动bot：
```
docker-compose up -d
```

docker部署

本项目的docker镜像为felinae98/nonebot-bison，可以直接pull后run进行使用，相关配置参数可以使用-e作为环境变量传入

直接运行（不推荐）

可以参考nonebot的运行方法 ::: danger 直接克隆源代码需要自行编译前端，否则会出现无法使用管理后台等情况。 ::: ::: danger 本项目中使用了Python 3.9的语法，如果出现问题，请检查Python版本 :::

首先安装poetry：安装方法
clone本项目，在项目中poetry install安装依赖
安装yarn，配置yarn源（推荐）
在admin-fronted中运行yarn && yarn build编译前端
编辑.env.prod配置各种环境变量，见Nonebot2配置
运行poetry run python bot.py启动机器人

作为插件使用

本部分假设大家会部署nonebot2

手动安装

安装pip包nonebot-bison
在bot.py中导入插件nonebot_bison

自动安装

使用nb-cli执行：nb plugin install nonebot_bison

配置

可参考源文件

BISON_CONFIG_PATH: 插件存放配置文件的位置，如果不设定默认为项目目录下的data目录
BISON_USE_PIC: 将文字渲染成图片后进行发送，多用于规避风控
BISON_BROWSER: 本插件使用Chrome来渲染图片
- 使用browserless提供的Chrome管理服务，设置为ws://xxxxxxxx，值为Chrome Endpoint（推荐）
- 使用本地安装的Chrome，设置为local:<chrome path>，例如local:/usr/bin/google-chrome-stable
- 如果不进行配置，那么会在启动时候自动进行安装（不推荐）
BISON_OUTER_URL: 从外部访问服务器的地址，默认为http://localhost:8080/bison，如果你的插件部署在服务器上，建议配置为http://<你的服务器ip>:8080/bison

使用

::: warning 本节假设COMMAND_START设置中包含''，如果出现bot不响应的问题，请先排查这个设置 :::

命令

在本群中进行配置

所有命令都需要@bot触发

添加订阅（仅管理员和群主和SUPERUSER）：添加订阅
查询订阅：查询订阅
删除订阅（仅管理员和群主和SUPERUSER）：删除订阅

私聊机器人获取后台地址

后台管理，之后点击返回的链接
如果你是superuser，那么你可以管理所有群的订阅；如果你是bot所在的群的其中部分群的管理，你可以管理你管理的群里的订阅；如果你不是任意一个群的管理，那么bot将会报错。 ::: tip 可以和bot通过临时聊天触发 ::: ::: warning 网页的身份鉴别机制全部由bot返回的链接确定，所以这个链接并不能透露给别人。并且链接会过期，所以一段时间后需要重新私聊bot获取新的链接。 :::

私聊机器人进行配置（需要SUPERUER权限）

添加订阅：管理-添加订阅
查询订阅：管理-查询订阅
删除订阅：管理-删除订阅

所支持平台的uid

Weibo

对于一般用户主页https://weibo.com/u/6441489862?xxxxxxxxxxxxxxx，/u/后面的数字即为uid
对于有个性域名的用户如：https://weibo.com/arknights，需要点击左侧信息标签下“更多”，链接为https://weibo.com/6279793937/about，其中中间数字即为uid

Bilibili

主页链接一般为https://space.bilibili.com/161775300?xxxxxxxxxx，数字即为uid

RSS

RSS链接即为uid

网易云音乐-歌手

在网易云网页上歌手的链接一般为https://music.163.com/#/artist?id=32540734，id= 后面的数字即为uid

网易云音乐-电台

在网易云网页上电台的链接一般为https://music.163.com/#/djradio?id=793745436，id= 后面的数字即为uid

5.4 KiB Raw Blame History Unescape Escape