Docker运行coolq+HTTP接口教程

Mmx的博客中已经有了一篇Linux中用docker运行coolq的文章,但那个不支持http接口。要使用http接口的话,需要使用专用的镜像并映射更多端口。其余的参数什么的倒是一致的。

一、HTTP接口有什么用

http接口可以随时让你控制机器人发送消息,也可以使所有机器人收到的消息发送到一个后端网址。

也就是说,没有http接口的coolq机器人,犹如一头牛,推一下动一下。亦或者被名为插件的定向缰绳拉一拉才会顺着绳子走。而我们大部分人都不会撮绳子,即不会写插件。SDK啊cpp啊IDE环境啊什么的完全搞不定。这时候就可以用名为网络接口的拖拉机与一根特质软绳拉着牛跑,牛拉着车跑也不是不行。

也就是说,有了接口,咱就可以为所欲为,大大降低了开发新功能的门槛。且由于互联网是各设备联通媒介的特性,所以http接口可以做到比普通插件的更多(其实也可以定制)。比如用脚本监控某台电脑开机、使用情况并使用机器人播报等。

二、安装使用

更详细的图文教程与视频请参照普通coolq在docker内运行教程。那个会了这个也就会了。

当然,必须要有公网ip或端口映射。不然只能在内网调用。

①安装Docker

Centos:

yum install docker

Debian/Ubuntu:

apt-get install -y docker.io

启动docker

systemctl start docker

设置开机启动

systemctl enable docker

②安装镜像

docker pull richardchien/cqhttp

③准备并启动coolq

下载最新版coolq Air(要是充了钱pro什么的也行),删除所有自带插件(有些插件在docker环境下可能导致账号异常冻结(风控),比如自带的图灵插件)。安上自己要的插件并设置好,然后上传到服务器,至于上传到哪,可以通过设定参数随便放。

然后通过命令创建coolq容器:

docker run --name=coolq --restart=always -p 8080:9000-p 5700:5700 -v /root/coolq-data:/home/user/coolq -e VNC_PASSWD=11223344 -e COOLQ_ACCOUNT=abcdefg  richardchien/cqhttp

蓝色部分为可更改

参数说明:

coolq:容器名称,可更改,用于启动、停止容器,命令为docker start/stop coolq。创建多个机器人时使用不同容器名与端口即可。

--restart=always:官方文档中给的是--rm--rm的含义是容器停止后删除容器,而--restart=always则表示容器停止后保留并自动运行,这样无论是重启了服务器还是重启docker,都能保证机器人的正常自动运行。

11223344:控制面板[noVNC]的登陆密码。

8080:控制面板[noVNC]使用的端口,国内主机应避免使用804438080等特殊端口。

5700:http接口的端口,可通过访问[http://ip:5700]访问接口。

/root/coolq-data:用于储存酷Q AIR的目录,插件目录、数据都在这里,需与上文创建的注明可修改的目录一致。

abcdefg:机器人帐号,其值会自动填入酷Q AIR的QQ账号栏中,酷Q也会储存密码,对自动化有利,此处给的字母是不会自动填入的,因为账号应是数字的。

可选参数:

-d:不会显示详细的调试信息,仅输出容器ID并挂起,不需要再次手动启动容器。不建议第一次开机器人时使用。


然后容器就创建成功了。如果没有加-d参数的话,需要在确认机器人正常运行(noVNC进得去)后,按ctrl+D结束运行然后输入docker start coolq重新启动。

④机器人使用与http接口用法

管理、控制机器人可通过noVNC图形界面控制。基本和windows差不多。noVNC地址是[http://ip:8080],密码是参数中的11223344

更多登陆coolq机器人可能遇到的问题和官方槛请参照Linux运行QQ机器人中的“连接[noVNC]”和“机器人使用”。

http接口详细用法可参照官方API文档:

https://cqhttp.cc/docs/4.14/#/API

关于“Docker运行coolq+HTTP接口教程”我的2个想法

  1. In case you search for with the specialized help with the personalized essay, study paper, phrase paper, dissertation or some other bit of creating, you could be encouraged to show.

发表评论

电子邮件地址不会被公开且将被用于接收回复及审核信息,评论区非实时刷新。 必填项已用*标注