原创·密钥 · 第01把｜如何优雅破解 go-cqhttp 登录风控

“门未必难开，只需对的钥匙。”

                                                                                                ——KeySmith · 密钥锻造坊

寻钥之人，欢迎你踏入密钥锻造坊。 我是 KeySmith，这里是技术人的打铁间。

此刻你翻开的，正是本坊锻造的第 01 把密钥，专为破解 go-cqhttp 风控之锁 而锻。

无论你是初次来访的学徒，还是久经风雨的同行匠人， 愿此钥能应你所困，破你所局，开你所门。

 

🌟 目标

✅ 搭建 QQ 机器人 go-cqhttp，支持私聊 & 群聊消息收发 ✅ 绕过腾讯风控，让 qsign-server 代理签名请求，避免触发验证码/设备锁 ✅ 记录所有细节，换号换 IP 也能直接复现 ✅ 兼容 v/代理环境，避免影响 Docker 和本地服务通信

✅ 解决 sign-server 自动注册问题，保证 qsign-server 长久可用

---

🌟 1. 环境准备

📌 必备软件

🔹 Docker（运行 qsign-server，提供签名服务） 🔹 go-cqhttp（QQ 机器人主程序） 🔹 PowerShell / CMD（执行命令行） 🔹 文本编辑器（Notepad++ / VSCode，修改 config.yml）

📌 端口规划：避免端口冲突问题。

组件	端口	作用
go-cqhttp	5700	HTTP API 通信（外部访问）
go-cqhttp	6700	WebSocket 通信（可选）
qsign-server	8080	签名服务器（go-cqhttp 使用

---

🌟 2. 处理 VPN & 代理问题

📌 ① 关闭代理

📌 如果你的系统开了 VPN / 代理，需要先关闭！否则会影响 Docker 和 go-cqhttp 访问本地 qsign-server。

关闭代理的方法：

1. Windows 设置 → 网络 & Internet → 代理

   • 关闭 “使用代理服务器”

2. 检查命令行是否走代理

   netsh winhttp show proxy

   如果显示

   “Direct access (no proxy server)”

   ，就没问题了！

3. 如果显示有代理，清空代理：

   netsh winhttp reset proxy

---

🌟 3. 安装 & 配置 Docker

📌 ① 下载 Docker

📌 如果你的系统没有安装 Docker，先下载安装 👉 Docker 官网下载 📌 Windows 需要启用 WSL 2（推荐）或者 Hyper-V

---

📌 ② 测试 Docker 是否安装成功

docker --version

✅ 如果看到 Docker 版本信息，比如 Docker version 24.0.5，说明安装成功！

---

🌟 4. 安装 & 运行 qsign-server

📌 ① 下载 qsign-server

docker pull bennettwu/qsign-server

✅ 如果拉取成功，会看到 Downloaded newer image 🎉

---

📌 ② 运行 qsign-server

docker run -d --name qsign -p 8080:80 bennettwu/qsign-server

✅ 如果 docker ps 看到 qsign-server 运行，就成功了！

📌③确保 qsign-server 监听的是 0.0.0.0

📌 如果你运行 curl http://127.0.0.1:8080 发现访问不到，说明可能是 qsign-server 绑定了错误的地址！

powershell
netstat -ano | findstr :8080

✅ 如果发现 127.0.0.1:8080，说明是 qsign-server 在监听 ❌ 如果发现 0.0.0.0:8080，说明可能是其他程序占用了端口！

📌 尝试重启 qsign-server

powershell
docker stop qsign
docker rm qsign
docker run -d --name qsign -p 8080:80 bennettwu/qsign-server

---

📌 ④ 检查 qsign-server 是否正常

curl http://127.0.0.1:8080

✅ 如果返回 JSON 数据，说明 qsign-server 正常！

✅ 看到 msg 里有 IAA 云天明 章北海，说明 qsign-server 运行正常！

🌟 5. 下载 & 配置 go-cqhttp

📌 ① 下载 go-cqhttp

👉 点击这里下载最新版本 解压到 D:\2go-cqhttp 目录。

---

📌 ② 运行 go-cqhttp 生成 config.yml

.\go-cqhttp_windows_amd64.exe -c config.yml --faststart

📌 选择通信方式，输入：

0（HTTP 通信） 或者 3（反向 WebSocket 通信） 这个时候最好选择http和websocket

📌 然后会生成 config.yml 配置文件。

---

📌 ③ 修改 config.yml

account:
  uin: 你的QQ号
  password: 你的QQ密码
  encrypt_password: false # 是否加密密码，建议保持 false
  status: 0  # 0: 在线 1: 隐身 2: 忙碌
  relogin:
    delay: 3
    interval: 3
    max-times: 0
  sign-server: "http://127.0.0.1:8080" # 指定 qsign-server 地址
​
servers:
  - ws:
      address: 0.0.0.0:6700 # WebSocket 服务器（如果用 WebSocket）
  - http:
      address: 0.0.0.0:5700 # HTTP API 服务器（如果用 HTTP）
​
heartbeat:
  interval: 5 # 心跳间隔（秒）
​
# 禁止风控相关配置
no_captcha: true
ignore_invalid_captcha: true

---

🌟 6. 运行 go-cqhttp

📌 ① 确保 qsign-server 在运行

docker ps

如果 qsign-server 没有运行，先启动它：

docker start qsign

---

📌 ② 启动 go-cqhttp

.\go-cqhttp_windows_amd64.exe -c config.yml --faststart

✅ 如果出现 登录成功，就 OK 了！！！ 🎉🎉🎉

---

🌟 7. 解决 sign-server 自动注册问题【powershell环境】（最好使用管理员）

📌 ① 获取 device.json 参数

powershell：type device.json

找到 android_id、guid、qimei36，然后手动注册。key=114514在config.yml文件里面

---

📌 ② 注册 sign-server

Invoke-WebRequest -Uri "http://127.0.0.1:8080/register?uin=你的QQ号&android_id=你的android_id&guid=你的guid&qimei36=你的qimei36&key=114514"

✅ 如果返回 Instance loaded successfully.，说明注册成功！！！ 🎉🎉🎉

---

🌟 8. 让机器人发消息

📌 ① 发送私聊消息

Invoke-WebRequest -Uri "http://127.0.0.1:5700/send_private_msg?user_id=你的QQ号&message=你好"

✅ 如果你的 QQ 收到消息，说明 API 正常！ 🎉

---

📌 ② 发送群聊消息

Invoke-WebRequest -Uri "http://127.0.0.1:5700/send_group_msg?group_id=你的QQ群号&message=大家好，我是Bot！"

✅ 如果群里收到消息，说明机器人运行成功！！！ 🎉🎉🎉

---

🎯 以后换号 / 换 IP，怎么做？

如果要换号，直接：

1. 删掉 device.json

2. 重新运行 go-cqhttp 生成新的 device.json

3. 重新注册 sign-server

4. 就可以用了！！！

---

🎉 🎉 🎉 恭喜你，我们搞定了！！！

 

 

“热铁未冷，锻声犹在。愿此钥，已开你心锁。”

本篇第 01 把密钥 已锻完毕。

若你觉得这把钥匙还称手， 请为锻造坊添一点火候 —— 点赞、收藏、留言皆是助燃。

当然！

下一把钥匙，正在炉中铸炼， 我会在锻火旁等你，再一同开锁破局。