Takker——QQ机器人部署指南

文章目录[x]
  1. 1:安装并配置go-cqhttp
  2. 1.1:Windows环境
  3. 1.2:Linux环境
  4. 2:安装并启动Takker
  5. 3:安装ffmpeg

安装并配置go-cqhttp

Windows环境

1.从此地址下载GO-CQHTTP(https://github.com/Mrs4s/go-cqhttp/releases/download/v1.0.0-beta6/go-cqhttp_windows_amd64.exe
2.在go-cqhttp.exe同一目录下创建一个config.yml

配置文件范例
# go-cqhttp 配置文件

account: # 账号相关
  uin: # QQ账号
  password: '' # 密码为空时使用扫码登录,强烈建议扫码登录以免环境问题
  encrypt: false  # 是否开启密码加密
  status: 0      # 在线状态 请参考 https://docs.go-cqhttp.org/guide/config.html#在线状态
  relogin: # 重连设置
    delay: 3   # 首次重连延迟, 单位秒
    interval: 3   # 重连间隔
    max-times: 0  # 最大重连次数, 0为无限制

  # 是否使用服务器下发的新地址进行重连
  # 注意, 此设置可能导致在海外服务器上连接情况更差
  use-sso-address: true

heartbeat:
  # 心跳频率, 单位秒
  # -1 为关闭心跳
  interval: 5

message:
  # 上报数据类型
  # 可选: string,array
  post-format: array
  # 是否忽略无效的CQ码, 如果为假将原样发送
  ignore-invalid-cqcode: false
  # 是否强制分片发送消息
  # 分片发送将会带来更快的速度
  # 但是兼容性会有些问题
  force-fragment: false
  # 是否将url分片发送
  fix-url: false
  # 下载图片等请求网络代理
  proxy-rewrite: ''
  # 是否上报自身消息
  report-self-message: false
  # 移除服务端的Reply附带的At
  remove-reply-at: false
  # 为Reply附加更多信息
  extra-reply-data: false

output:
  # 日志等级 trace,debug,info,warn,error
  log-level: info
  # 是否启用 DEBUG
  debug: false # 开启调试模式

# 默认中间件锚点
default-middlewares: &default
  # 访问密钥, 强烈推荐在公网的服务器设置
  access-token: ''
  # 事件过滤器文件目录
  filter: ''
  # API限速设置
  # 该设置为全局生效
  # 原 cqhttp 虽然启用了 rate_limit 后缀, 但是基本没插件适配
  # 目前该限速设置为令牌桶算法, 请参考:
  # https://baike.baidu.com/item/%E4%BB%A4%E7%89%8C%E6%A1%B6%E7%AE%97%E6%B3%95/6597000?fr=aladdin
  rate-limit:
    enabled: false # 是否启用限速
    frequency: 1  # 令牌回复频率, 单位秒
    bucket: 1     # 令牌桶大小

database: # 数据库相关设置
  leveldb:
    # 是否启用内置leveldb数据库
    # 启用将会增加10-20MB的内存占用和一定的磁盘空间
    # 关闭将无法使用 撤回 回复 get_msg 等上下文相关功能
    enable: true

# 连接服务列表
servers:
  # 添加方式,同一连接方式可添加多个,具体配置说明请查看文档
  #- http: # http 通信
  #- ws:   # 正向 Websocket
  #- ws-reverse: # 反向 Websocket
  #- pprof: #性能分析服务器
  # 反向WS设置
  - ws-reverse:
      # 反向WS Universal 地址
      # 注意 设置了此项地址后下面两项将会被忽略
      universal: "ws://127.0.0.1:18080/cqhttp/ws"
      # 反向WS API 地址
      api: 
      # 反向WS Event 地址
      event: 
      # 重连间隔 单位毫秒
      reconnect-interval: 3000
      middlewares:
        <<: *default # 引用默认中间件

3.打开powershell,进入此目录,输入.\go-cqhttp.exe faststart,如果顺利运行,你将看到类似下图中的内容

Linux环境

1.从此地址下载GO-CQHTTP(https://github.com/Mrs4s/go-cqhttp/releases/download/v1.0.0-beta6/go-cqhttp_linux_amd64.tar.gz

wget https://github.com/Mrs4s/go-cqhttp/releases/download/v1.0.0-beta6/go-cqhttp_linux_amd64.tar.gz

2.解压并给予运行权限

tar -zxvf go-cqhttp_linux_amd64.tar.gz
chmod +x go-cqhttp

3.创建config.yml,并编辑

vi config.yml
配置文件范例
# go-cqhttp 配置文件

account: # 账号相关
  uin: # QQ账号
  password: '' # 密码为空时使用扫码登录,强烈建议扫码登录以免环境问题
  encrypt: false  # 是否开启密码加密
  status: 0      # 在线状态 请参考 https://docs.go-cqhttp.org/guide/config.html#在线状态
  relogin: # 重连设置
    delay: 3   # 首次重连延迟, 单位秒
    interval: 3   # 重连间隔
    max-times: 0  # 最大重连次数, 0为无限制

  # 是否使用服务器下发的新地址进行重连
  # 注意, 此设置可能导致在海外服务器上连接情况更差
  use-sso-address: true

heartbeat:
  # 心跳频率, 单位秒
  # -1 为关闭心跳
  interval: 5

message:
  # 上报数据类型
  # 可选: string,array
  post-format: array
  # 是否忽略无效的CQ码, 如果为假将原样发送
  ignore-invalid-cqcode: false
  # 是否强制分片发送消息
  # 分片发送将会带来更快的速度
  # 但是兼容性会有些问题
  force-fragment: false
  # 是否将url分片发送
  fix-url: false
  # 下载图片等请求网络代理
  proxy-rewrite: ''
  # 是否上报自身消息
  report-self-message: false
  # 移除服务端的Reply附带的At
  remove-reply-at: false
  # 为Reply附加更多信息
  extra-reply-data: false

output:
  # 日志等级 trace,debug,info,warn,error
  log-level: info
  # 是否启用 DEBUG
  debug: false # 开启调试模式

# 默认中间件锚点
default-middlewares: &default
  # 访问密钥, 强烈推荐在公网的服务器设置
  access-token: ''
  # 事件过滤器文件目录
  filter: ''
  # API限速设置
  # 该设置为全局生效
  # 原 cqhttp 虽然启用了 rate_limit 后缀, 但是基本没插件适配
  # 目前该限速设置为令牌桶算法, 请参考:
  # https://baike.baidu.com/item/%E4%BB%A4%E7%89%8C%E6%A1%B6%E7%AE%97%E6%B3%95/6597000?fr=aladdin
  rate-limit:
    enabled: false # 是否启用限速
    frequency: 1  # 令牌回复频率, 单位秒
    bucket: 1     # 令牌桶大小

database: # 数据库相关设置
  leveldb:
    # 是否启用内置leveldb数据库
    # 启用将会增加10-20MB的内存占用和一定的磁盘空间
    # 关闭将无法使用 撤回 回复 get_msg 等上下文相关功能
    enable: true

# 连接服务列表
servers:
  # 添加方式,同一连接方式可添加多个,具体配置说明请查看文档
  #- http: # http 通信
  #- ws:   # 正向 Websocket
  #- ws-reverse: # 反向 Websocket
  #- pprof: #性能分析服务器
  # 反向WS设置
  - ws-reverse:
      # 反向WS Universal 地址
      # 注意 设置了此项地址后下面两项将会被忽略
      universal: "ws://127.0.0.1:18080/cqhttp/ws"
      # 反向WS API 地址
      api: 
      # 反向WS Event 地址
      event: 
      # 重连间隔 单位毫秒
      reconnect-interval: 3000
      middlewares:
        <<: *default # 引用默认中间件

编辑完成后按下键盘上的ESC,输入 :wq (英文冒号+小写的w和q)保存并退出vim
4.使Go-cqhttp后台常驻 此处可以使用的服务有(Tmux,Screen,Supervisor,Nohup,Systemctl,Pm2等等)各有各的区别
我这里以Tmux的使用方法为例
首先安装Tmux
Centos(默认你的系统版本为Centos8或更高)

sudo yum install -y tmux

Ubuntu/Debian

sudo apt-get install -y tmux

使用Tmux(可以参考Tmux基础操作教程

tmux new -s cqhttp  # 创建一个tmux session
使用快捷键ctrl+b d  # 将此Session detach,即离开session但不中断其中运行的进程,并回到主命令行中
tmux a -t cqhttp  # attach到一个Session,即重新进去cqhttp Session
./go-cqhttp faststart  # 启动Go-cqhttp

安装并启动Takker

1.将Takker的源码下载下来(建议使用Release中的文件,较为稳定) 非常不建议直接Clone
2.进入Takker的根目录,确保系统的Python版本高于3.9

pip或pip3 install poetry  # 请选择对应python3.9版本的pip
python -m poetry install --no-dev  # 创建虚拟环境并安装bot的依赖

3.修改congfigs/config.example.py的内容,将各项配置都填写完整

config.example.py
from typing import List

# Go-cq正向http地址配置(默认使用bot.call_api()的调用方式)
USE_HTTP_API: bool = False
CQ_HTTP_URL: str = ""
CQ_SECRET: str = ""  # HTTP_API的secret

# 身份名单
OWNER: str = ""  # 主人QQ
SUPERUSERS: List[str] = ["0", "", ""]  # 超级用户QQ

# 各个API的配置
ALAPI_TOKEN: str = ""  # ALAPI
CATAPI_TOKEN: str = ""  # 随机猫猫API
NETEASE_API: str = "nemapi.windis.xyz"  # NodeJS版本的网易云音乐API的地址
PIXIV_IMAGE_URL: str = "pixiv.windis.xyz"  # 反代i.pximg.net的网址

# 各种限制
MAX_PROCESS_TIME: int = 30  # 部分指令处理最大等待时间,单位秒,在此期间用户不能再次发起相同指令
BAN_CHEKC_FREQ: int = 5  # 恶意触发命令检测阈值
BAN_CHECK_PERIOD: int = 3  # 恶意触发命令检测时间
BAN_TIME: int = 5  # 恶意触发命令后的封禁时间,单位分钟

# 隐藏插件列表
HIDDEN_PLUGINS: List[str] = [
    "nonebot_plugin_apscheduler",
    "nonebot_plugin_test",
    "hook",
    "invite_check",
    "withdraw",
]

修改完毕后将文件名改为config.py
4.进入虚拟环境并启动你的Bot

tmux new -s takker
python -m poetry shell
python bot.py

  若一切顺利,恭喜你,你已经完成了部署Takker的80%

安装ffmpeg

由于Bot有部分功能需要发送语音,因此需要安装并配置好ffmpeg是gocqhttp能够使用 碍于篇幅(懒)和稍微设立一点点门槛,请用户自行查询在你的系统中如何安装ffmpeg并将其添加进环境变量.

点赞