go-cqhttp Linux 部署步骤(扫码问题，已解决)

原创已于 2023-03-12 10:22:16 修改 · 3.1k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#linux #服务器 #运维

于 2023-02-26 09:41:35 首次发布

Linux 专栏收录该内容

3 篇文章

订阅专栏

本文介绍了如何在Linux服务器上部署go-cqhttp，包括下载正确版本的软件包，上传并解压，运行程序，配置config.yml文件，特别是处理在无扫码环境下的登录问题，通过使用session.token文件实现登录。此外，还提到了与SpringBoot等后台系统的交互设置。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

go-cqhttp Linux 部署步骤(扫码问题，已解决)

参考链接：

https://developer.aliyun.com/article/1143389✳

Linux部署思路与Windos思路一致,如果你Windows能部署成功，那么Linux部署不成问题，接下来查看详细步骤

下载cqhttp对应的linux服务端go-cqhttp_linux_amd64.tar.gz文件

在这里插入图片描述

注意区分linux与windows版本，区分amd64与arm64版本

将go-cqhttp_linux_amd64.tar.gz文件，上传至服务器

在这里插入图片描述

在 ~ 目录下创建 cqhttp文件夹，并进入，再使用ftp上传*.tar.gz文件

解压go-cqhttp_linux_amd64.tar.gz文件
```
tar -zxvf go-cqhttp_linux_amd64.tar.gz
```

在这里插入图片描述

解压后会生成LICENSE和README.md和go-cqhttp文件

运行go-cqhttp程序
```
./go-cqhttp
```

在这里插入图片描述

替换生成的config.yml文件

# go-cqhttp 默认配置文件

account: # 账号相关
  uin: 10000000 # QQ账号
  password: '' # 密码为空时使用扫码登录
  encrypt: false  # 是否开启密码加密
  status: 0      # 在线状态 请参考 https://docs.go-cqhttp.org/guide/config.html#在线状态
  relogin: # 重连设置
    delay: 3   # 首次重连延迟, 单位秒
    interval: 3   # 重连间隔
    max-times: 0  # 最大重连次数, 0为无限制

  # 是否使用服务器下发的新地址进行重连
  # 注意, 此设置可能导致在海外服务器上连接情况更差
  use-sso-address: true
  # 是否允许发送临时会话消息
  allow-temp-session: true

heartbeat:
  disabled: false # 是否开启心跳事件上报
  # 心跳频率, 单位秒
  # -1 为关闭心跳
  interval: 10

message:
  # 上报数据类型
  # 可选: string,array
  post-format: string
  # 是否忽略无效的CQ码, 如果为假将原样发送
  ignore-invalid-cqcode: false
  # 是否强制分片发送消息
  # 分片发送将会带来更快的速度
  # 但是兼容性会有些问题
  force-fragment: false
  # 是否将url分片发送
  fix-url: false
  # 下载图片等请求网络代理
  proxy-rewrite: ''
  # 是否上报自身消息
  report-self-message: false
  # 移除服务端的Reply附带的At
  remove-reply-at: false
  # 为Reply附加更多信息
  extra-reply-data: false
  # 跳过 Mime 扫描, 忽略错误数据
  skip-mime-scan: false

output:
  # 日志等级 trace,debug,info,warn,error
  log-level: warn
  # 日志时效 单位天. 超过这个时间之前的日志将会被自动删除. 设置为 0 表示永久保留.
  log-aging: 15
  # 是否在每次启动时强制创建全新的文件储存日志. 为 false 的情况下将会在上次启动时创建的日志文件续写
  log-force-new: true
  # 是否启用日志颜色
  log-colorful: true
  # 是否启用 DEBUG
  debug: false # 开启调试模式

# 默认中间件锚点
default-middlewares: &default
  # 访问密钥, 强烈推荐在公网的服务器设置
  access-token: ''
  # 事件过滤器文件目录
  filter: ''
  # API限速设置
  # 该设置为全局生效
  # 原 cqhttp 虽然启用了 rate_limit 后缀, 但是基本没插件适配
  # 目前该限速设置为令牌桶算法, 请参考:
  # https://baike.baidu.com/item/%E4%BB%A4%E7%89%8C%E6%A1%B6%E7%AE%97%E6%B3%95/6597000?fr=aladdin
  rate-limit:
    enabled: false # 是否启用限速
    frequency: 1  # 令牌回复频率, 单位秒
    bucket: 1     # 令牌桶大小

database: # 数据库相关设置
  leveldb:
    # 是否启用内置leveldb数据库
    # 启用将会增加10-20MB的内存占用和一定的磁盘空间
    # 关闭将无法使用 撤回 回复 get_msg 等上下文相关功能
    enable: true
  sqlite3:
    # 是否启用内置sqlite3数据库
    # 启用将会增加一定的内存占用和一定的磁盘空间
    # 关闭将无法使用 撤回 回复 get_msg 等上下文相关功能
    enable: true
    cachettl: 3600000000000 # 1h

# 连接服务列表
servers:
  - http: # HTTP 通信设置
      address: 0.0.0.0:5700 # HTTP监听地址
      timeout: 5      # 反向 HTTP 超时时间, 单位秒，<5 时将被忽略
      long-polling:   # 长轮询拓展
        enabled: false       # 是否开启
        max-queue-size: 2000 # 消息队列大小，0 表示不限制队列大小，谨慎使用
      middlewares:
        <<: *default # 引用默认中间件
      post:           # 反向HTTP POST地址列表
      #- url: ''                # 地址
      #  secret: ''             # 密钥
      #  max-retries: 3         # 最大重试，0 时禁用
      #  retries-interval: 1500 # 重试时间，单位毫秒，0 时立即
      - url: http://xxx.xx.xxx.xxx:xxxx/ # 地址
        secret: ''                  # 密钥
        max-retries: 0             # 最大重试，0 时禁用
        retries-interval: 1000      # 重试时间，单位毫秒，0 时立即

注意：若需要与springboot等后台进行交互，需要填写反向HTTP POST地址列表中的 - url地址。其余配置项可根据自己的需要进行相关设置。

将windows版本生成的session.token文件上传

若此时直接重启cqhttp，是需要扫码认证的，然而，部署在公网服务器上的电脑不支持扫码

此时我们可在电脑上登录windows版本的cqhttp机器人登录成功后，由它生成的seesion.token和device.json文件进行上传至服务器的相应目录