# 开始
欢迎来到 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