ContextQMD
Back to Go Cqhttp

开始

docs/quick_start.md

1.2.04.6 KB
Original Source

开始

欢迎来到 go-cqhttp 文档 目前还在咕

注意, 最新文档已经移动到 go-cqhttp-docs, 当前文档只做兼容性保留, 所以内容可能有不足.

基础教程

下载

从release界面下载最新版本的go-cqhttp

  • Windows下32位文件为 go-cqhttp-v*-windows-386.zip
  • Windows下64位文件为 go-cqhttp-v*-windows-amd64.zip
  • Windows下arm用(如使用高通CPU的笔记本)文件为 go-cqhttp-v*-windows-arm.zip
  • Linux下32位文件为 go-cqhttp-v*-linux-386.tar.gz
  • Linux下64位文件为 go-cqhttp-v*-linux-amd64.tar.gz
  • Linux下arm用(如树莓派)文件为 go-cqhttp-v*-linux-arm.tar.gz
  • MD5文件为 *.md5 ，用于校验文件完整性
  • 如果没有你所使用的系统版本或者希望自己构建，请移步进阶指南-如何自己构建

解压

  • Windows下请使用自己熟悉的解压软件自行解压
  • Linux下在命令行中输入 tar -xzvf [文件名]

使用

Windows

标准方法

  1. 双击go-cqhttp.exe此时将提示
[WARNING]: 尝试加载配置文件 config.hjson 失败: 文件不存在
[INFO]: 默认配置文件已生成,请编辑 config.hjson 后重启程序.
  1. 参照config.md和你所用到的插件的 README 填入参数
  2. 再次双击go-cqhttp.exe
[INFO]: 登录成功 欢迎使用: balabala

如出现需要认证的信息，请自行认证设备。

此时，基础配置完成

懒人法

  1. 下载包含Windows.bat的zip
  2. 解压
  3. 将Windows.bat复制/剪切到go-cqhttp文件夹
  4. 双击运行

效果如下

QQ account:
[QQ账号]
QQ password:
[QQ密码]
enable http?(Y/n)
[是否开启http(y/n),默认开启]
enable ws?(Y/n)
[是否开启websocket(y/n),默认开启]
请按任意键继续. . .
  1. 双击go-cqhttp.exe
[INFO]: 登录成功 欢迎使用: balabala

如出现需要认证的信息，请自行认证设备。

此时，基础配置完成

Linux

标准方法

  1. 打开一个命令行/ssh
  2. cd到解压目录
  3. 输入 ./go-cqhttp，Enter运行 ，此时将提示
[WARNING]: 尝试加载配置文件 config.hjson 失败: 文件不存在
[INFO]: 默认配置文件已生成,请编辑 config.hjson 后重启程序.
  1. 参照config.md和你所用到的插件的 README 填入参数
  2. 再次输入 ./go-cqhttp，Enter运行
[INFO]: 登录成功 欢迎使用: balabala

如出现需要认证的信息，请自行认证设备。

此时，基础配置完成

懒人法

暂时咕咕咕了

验证http是否成功配置

此时，如果在本地开启的服务器，可以在浏览器输入http://127.0.0.1:5700/send_private_msg?user_id=[接收者qq号]&message=[发送的信息]来发送一条测试信息

如果出现{"data":{"message_id":balabala},"retcode":0,"status":"ok"}则证明已经成功配置HTTP

注：请 连 中括号 也替换掉，就像这样：http://127.0.0.1:5700/send_private_msg?user_id=10001&message=ffeecoishp

进阶指南

跳过启动的五秒延时

使用命令行参数 faststart即可跳过启动的五秒钟延时，例如

.\go-cqhttp.exe faststart

如何自己构建

  1. 下载源码并解压 || 使用git clone https://github.com/Mrs4s/go-cqhttp.git来拉取

  2. 下载golang binary release并安装或者自己构建golang

  3. 在cmd或Linux命令行中，cd到目录中

  4. 输入go build -ldflags "-s -w -extldflags '-static'"，Enter运行

注：可以使用go env -w GOPROXY=https://goproxy.cn,direct来加速国内依赖安装速度

更新

方法一

从release界面下载最新版本的go-cqhttp 并替换之前的版本

方法二

使用更新参数，在命令行中打开go-cqhttp所在目录

windows

输入指令 go-cqhttp.exe update

如果在国内连接github下载速度可能很慢，可以使用镜像源下载

go-cqhttp.exe update https://github.rc1844.workers.dev

几个可用的镜像源

  • https://hub.fastgit.org
  • https://github.com.cnpmjs.org
  • https://github.bajins.com
  • https://github.rc1844.workers.dev

linux

方法与windows基本一致，将 go-cqhttp.exe 替换为 ./go-cqhttp即可