# 开始

欢迎来到 go-cqhttp 文档 !

# 基础教程

# 下载

从 release (opens new window) 界面下载最新版本的 go-cqhttp

系统类型	可执行文件	压缩文件
Intel 版 Macos	Not available	`go-cqhttp_darwin_amd64.tar.gz`
M1 版 Macos	Not available	`go-cqhttp_darwin_arm64.tar.gz`
32 位 Linux	Not available	`go-cqhttp_linux_386.tar.gz`
64 位 Linux	Not available	`go-cqhttp_linux_amd64.tar.gz`
arm64 Linux	Not available	`go-cqhttp_linux_arm64.tar.gz`
armv7 Linux	Not available	`go-cqhttp_linux_armv7.tar.gz`
32 位 Windows	`go-cqhttp_windows_386.exe`	`go-cqhttp_windows_386.zip`
64 位 Windows	`go-cqhttp_windows_amd64.exe`	`go-cqhttp_windows_amd64.zip`
arm64 Windows	`go-cqhttp_windows_arm64.exe`	`go-cqhttp_windows_arm64.zip`
armv7 Windows	`go-cqhttp_windows_armv7.exe`	`go-cqhttp_windows_armv7.zip`

MD5信息在 go-cqhttp_checksums.txt , 可用于校验文件完整性
如果没有你所使用的系统版本或者希望自己构建, 请移步进阶指南-如何自己构建

# 解压

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

# 使用

# Windows 标准方法

双击go-cqhttp_*.exe，根据提示生成运行脚本
双击运行脚本

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

参照config.md (opens new window)和你所用到的插件的 README 填入参数
再次双击运行脚本

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

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

此时, 基础配置完成

# Linux 标准方法

通过 SSH 连接到服务器
cd到解压目录
输入 ./go-cqhttp, Enter运行 , 此时将提示

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

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

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

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

此时, 基础配置完成

注意

需要保持 go-cqhttp 在后台持续运行

请配合 screen 等服务来保证断开 SSH 连接后 go-cqhttp 的持续运行

# 跳过启动的五秒延时

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

# Windows
.\go-cqhttp.exe faststart

# Linux
./go-cqhttp faststart

# 进阶指南

# 如何自己构建

下载源码 (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) 。

然后在 cmd 输入 (不能使用 powershell）

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

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

# Linux

Ubuntu / Debian :

终端执行

apt install -y ffmpeg

Fedora / RHEL / CentOS :

根据 Rpmfusion (opens new window) 的文档配置源

终端执行

# Centos7 及之前
yum install ffmpeg ffmpeg-devel 

# CentOS8 及之后
dnf install ffmpeg ffmpeg-devel

← 简介目录结构 →