【AstralGocq】全新Go-cqhttp Linux操作AstralGocq登录QQ以及对接框架教程

前言

Astral-Gocq是由赵怡然（蓝波-zhaodice）接手GO-CQHTTP来维护，基于老版本GO-CQHTTP已经推出全新1.3版本。已经进入开发阶段，正在完成格式事件接收，预计2025年中旬进入稳定版。本教程目前只写了linux来操作，win的话下载exe运行即可。已经方便到不怎么需要去修改配置文件即可完成登录

项目地址

https://github.com/ProtocolScience/AstralGocq 小伙伴们可以给项目点点star。有任何问题也可以在项目的issues进行提交反馈问题,当然作者也在本站群内，可以在群内交流提问。

创建并拉取

1. 以下是整合的命令，所以可能时间久的话需要自行修改下载地址，也可以自己拆分自行一步步操作。

   mkdir AstralGocq && cd AstralGocq && curl -L -o AstralGocq.tar.gz https://github.com/ProtocolScience/AstralGocq/releases/download/v1.3.1-pre-1/AstralGocq_linux_amd64.tar.gz && tar -xzvf AstralGocq.tar.gz && rm -f AstralGocq.tar.gz

2. 为了方便有的朋友有自己的习惯，我还是进行了拆分命令。需要的自己更改
   
   请注意，所有的名称不是go-cqhttp,已经更改为AstralGocq，如有需求自行更改！
   • 这个是创建文件夹

     mkdir AstralGocq

   • 这是进入文件夹

     cd AstralGocq

   • 这是拉取AstralGocq并指定包名(如果后续有更新版本，可能需要更改版本号，可进项目查阅最新版本号)

     curl -L -o AstralGocq.tar.gz https://github.com/ProtocolScience/AstralGocq/releases/download/v1.3.1-pre-1/AstralGocq_linux_amd64.tar.gz

   • 这是解压AstralGocq包

     tar -xzvf AstralGocq.tar.gz

   • 这是删除AstralGocq包

     rm -f AstralGocq.tar.gz

启动AstralGocq并配置文件

1. 我们运行AstralGocq选择通信方式并添加账密登录以及修改ws

   ./AstralGocq

   

2. 首次运行会让我们选择通信方式，一般来说选择3，反向 Websocket 通信，如果你有其他需求可以一起选择，比如03，意思就是选择了 HTTP通信和反向 Websocket 通信，例如图内我选择的是03，接着会提示让你输入机器人的QQ和密码。这个提示一下，如果你使用了空密码，就会自动把你更换为手表协议，如果你使用的是密码则自动使用apad协议。推荐使用密码。因为qsign是apad协议。
   
3. 以上完成后会出现提示：配置文件已生成，按Enter继续，或者Ctrl+C退出程序来手动修改配置文件。这一步我们可以暂停，不要继续回车，我们找到配置文件。
   
4. 打开config.yml,拉到最下方，修改universal: ws://your_websocket_universal.server ，把ws://your_websocket_universal.server 更改为你需要对接的框架。
   autman是：ws://autman公网:端口/qq/receive
bncr是：ws://无界IP:端口/api/bot/qqws
   
5. 以上更改完毕后保存即可。我们回到命令页面。继续回车即可
   

登录QQ并过滑块静默

1. 帐号密码正确的qia前提下，我们就会登录QQ，然后会出现滑块提示，将地址复制到浏览器，或者复制到过滑块的app进行ticket获取。获取ticket的软件群内有。
   
2. 然后我们把地址复制到软件，手动验证后会出ticket，复制到终端回车即可
   
   
3. 接着会让我们选择短信或者扫码，短信就选择1扫码就选择2，如果是扫码就复制地址到浏览器打开，用充当机器人的QQ扫码验证即可。如果是短信则在终端输入验证码回车
   
4. 至此登录完毕，剩下的就是守护。守护有很多方式，可以用ctrl+C结束，再用./AstralGocq -d静默。也可以用screen创建会话来单独在里面运行AstralGocq做到守护。也可以用Supervisor或者宝塔自带的守护实现开机自启。下面我就简单推荐一下宝塔自带的守护程序。

守护进程

1. 在宝塔应用搜索进程守护管理器，并安装
   
2. 然后我们打开，找到添加守护进程
   
3. 接着我们在填写参数，按照图内提示操作即可
   
4. 完成后就会自动运行，并且会实现开机自启，只要宝塔正常，就一切会正常运行，可以点击右边的日志查看。
   

安装 ffmpeg

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

Windows

1. 从 https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-full.7z下载 并解压, 并为 bin 这个文件夹添加环境变量。如果遇到下载速度缓慢的问题可以用在群里直接下载
2. 然后在 cmd 输入 (不能使用 powershell）自行将这个指令中的 C:\Program Files 替换成你的解压目录。

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

Linux

1. Ubuntu / Debian :终端执行

   apt install -y ffmpeg

2. Fedora / RHEL / CentOS :
   • Centos7 及之前可以参考此文章

     yum install ffmpeg ffmpeg-devel

   • CentOS8 及之后

     dnf install ffmpeg ffmpeg-devel