# 开始

欢迎来到 go-cqhttp 文档 !

# 基础教程

注意

如果你遇到滑块验证码的问题, 请移步这里

# 下载

从 release (opens new window) 界面下载最新版本的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 标准方法

双击go-cqhttp.exe此时将提示

[WARNING]: 尝试加载配置文件 config.hjson 失败: 文件不存在
[INFO]: 默认配置文件已生成,请编辑 config.hjson 后重启程序.

参照config.md (opens new window)和你所用到的插件的 README 填入参数
再次双击go-cqhttp.exe

[INFO]: 登录成功 欢迎使用: balabala

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

此时, 基础配置完成

# Windows 懒人法

下载包含 Windows.bat 的 zip (opens new window)
解压
将Windows.bat复制/剪切到go-cqhttp文件夹
双击运行

效果如下

QQ account:
[QQ账号]
QQ password:
[QQ密码]
enable http?(Y/n)
[是否开启http(y/n),默认开启]
enable ws?(Y/n)
[是否开启websocket(y/n),默认开启]
请按任意键继续. . .

双击go-cqhttp.exe

[INFO]: 登录成功 欢迎使用: balabala

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

此时, 基础配置完成

# Linux 标准方法

打开一个命令行/ssh
cd到解压目录
输入 ./go-cqhttp, Enter运行 , 此时将提示

[WARNING]: 尝试加载配置文件 config.hjson 失败: 文件不存在
[INFO]: 默认配置文件已生成,请编辑 config.hjson 后重启程序.

参照 config.md (opens new window) 和你所用到的插件的 README 填入参数
再次输入 ./go-cqhttp, Enter运行

[INFO]: 登录成功 欢迎使用: balabala

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

此时, 基础配置完成

# Linux 懒人法

暂时咕咕咕了

# 跳过启动的五秒延时

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

.\go-cqhttp.exe faststart

# 验证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

# 进阶指南

# 如何自己构建

下载源码 (opens new window)并解压 || 使用git clone https://github.com/Mrs4s/go-cqhttp.git来拉取
下载golang binary release (opens new window)并安装或者自己构建golang (opens new window)
在cmd或Linux命令行中, cd到目录中
输入go build -ldflags "-s -w -extldflags '-static'", Enter运行

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

# 更新

# 方法一

从release (opens new window)界面下载最新版本的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即可

./go-cqhttp update

# 安装 ffmpeg

为了支持任意格式的语音发送, 你需要安装 ffmpeg 。

# Windows

从这里 (opens new window) 下载并解压, 并为 bin 这个文件夹添加环境变量。

如果遇到下载速度缓慢的问题可以用这个源 (opens new window) 。

然后在命令行输入

setx /M PATH "C:\Program Files\ffmpeg\bin;%PATH%"

自行将这个指令中的 C:\Program Files 替换成你的解压目录。

# Linux

Ubuntu / Debian :

终端执行

apt install -y ffmpeg

CentOS :

终端执行

yum install -y epel-release

rpm -v --import http://li.nux.ro/download/nux/RPM-GPG-KEY-nux.ro
rpm -Uvh http://li.nux.ro/download/nux/dextop/el7/x86_64/nux-dextop-release-0-5.el7.nux.noarch.rpm

yum install ffmpeg ffmpeg-devel

← 简介目录结构 →