你是否想过为什么别人的QQ群聊里总有一个“小助手”能自动回复、查天气、玩游戏而你的群却只能手动全体成员这背后往往是一个部署在服务器上的QQ机器人。今天我们不再只讲“是什么”而是要解决一个更实际的问题如何从零开始在云服务器上搭建一个稳定、可扩展的QQ机器人并让它真正为你所用而不是三天两头掉线或功能单一。本文将以当前热门的“云崽机器人”框架为例带你完成一次完整的服务器端QQ机器人部署。云崽Yunzai-Bot基于 Node.js 和 go-cqhttp功能丰富、插件生态活跃是个人开发者和小型社群管理者的优选。但网上教程往往只讲“跑起来”却忽略了服务器选型、长期稳定运行、安全风险规避这些真正决定项目成败的细节。读完本文你将能理解QQ机器人背后的技术栈与核心组件而不仅仅是复制命令。在主流云服务器如阿里云、腾讯云上完成从环境配置到机器人上线的全流程包括如何选择适合的服务器配置。掌握让机器人7x24小时稳定运行的守护方案告别进程意外退出。了解关键的安全配置与合规要点避免账号风险。获得扩展机器人功能的清晰路径知道如何安装和管理插件。我们开始吧。1. 这篇文章真正要解决的问题很多开发者尝试搭建QQ机器人时会遇到几个典型困境教程碎片化A教程讲安装B教程讲插件但环境依赖、版本冲突、服务器配置这些承上启下的关键步骤没人系统讲。“本地能跑一上服务器就挂”在Windows电脑上测试顺利一旦部署到Linux云服务器各种权限问题、端口问题、依赖缺失问题接踵而至。运行不稳定用node app.js直接启动SSH一断开机器人就离线缺乏进程守护。对安全风险无知直接使用扫码登录的协议可能导致账号被风控甚至封禁对服务器的基础安全如防火墙也毫无概念。功能拓展迷茫机器人跑起来后不知道去哪里找插件如何安装如何配置。本文的核心就是系统性地解决上述问题。我们不仅要把机器人“点亮”更要把它部署成一个可靠、可维护的后台服务。目标读者是具备基础命令行操作能力了解ls,cd,vim等、对Node.js或Python生态有初步接触的开发者或技术爱好者。2. 基础概念与核心原理在动手之前必须理解QQ机器人的核心工作原理。它不是一个腾讯官方提供的服务而是通过技术手段模拟QQ客户端实现消息的接收与发送。核心组件与数据流用户QQ --- 腾讯官方服务器 --- go-cqhttp (协议端) --- 云崽机器人 (业务逻辑端) --- 你的服务器go-cqhttp (协议端)这是一个开源项目它实现了QQ客户端协议。它的角色是“桥梁”或“网关”负责登录你的QQ账号作为机器人账号。与腾讯服务器通信接收群消息、私聊消息等事件。将这些事件转换成HTTP或WebSocket请求转发给后面的机器人业务端如云崽。接收业务端返回的指令再转换成QQ协议发送出去。关键点它处理所有和腾讯服务器的复杂通信让业务开发者无需关心协议细节。云崽机器人 (Yunzai-Bot, 业务逻辑端)这是机器人的“大脑”基于Node.js开发。它的职责是接收来自go-cqhttp的事件如消息内容、发送者信息。根据预设的规则、插件、AI模型等处理这些消息并生成回复内容。将回复内容返回给go-cqhttp。管理插件系统、定时任务、数据存储等。服务器提供24小时运行环境的载体。go-cqhttp和云崽Bot都运行在其上。为什么需要服务器因为你的个人电脑不可能永远开机在线。云服务器提供了公网IP、稳定的网络和持续运行的环境确保机器人随时待命。协议选择与安全提示 go-cqhttp支持多种登录协议如Android Phone, Android Watch。不同协议稳定性和风控风险不同。强烈建议使用Android Watch协议它被风控的概率相对较低。切勿使用来路不明的破解协议或签名服务器这有极高的账号安全风险。本文所有操作均基于开源、合法的技术方案。3. 环境准备与前置条件3.1 服务器准备你需要一台拥有公网IP的Linux云服务器。国内主流选择有阿里云、腾讯云、华为云等。系统推荐Ubuntu 20.04/22.04 LTS或CentOS 7/8本文以Ubuntu 22.04为例。配置对于初期学习和测试1核CPU、2GB内存、40GB硬盘的入门级配置如阿里云ECS t6系列或腾讯云轻量应用服务器完全足够。如果计划运行大量插件或AI模型建议升级到2核4G。安全组/防火墙确保在云服务商控制台开放以下端口以阿里云为例22端口用于SSH连接通常默认开放。5700端口go-cqhttp的HTTP事件上报端口内部通信不建议对公网开放仅需服务器内部可访问。6700端口go-cqhttp的WebSocket端口可选同不建议对公网开放。最佳实践只开放22端口用于管理。go-cqhttp与云崽Bot通过本地环回地址127.0.0.1通信无需公网暴露。3.2 本地工具准备SSH客户端如PuTTY (Windows) 或系统终端 (macOS/Linux)。代码/文件编辑器如VS Code配合SFTP或Remote-SSH插件方便在服务器上编辑文件。一个用于机器人的QQ小号非常重要请不要使用你的主力QQ账号使用一个不常用的账号作为机器人账号以防潜在风险。3.3 服务器基础环境配置通过SSH连接到你的服务器首先进行系统更新和安装基础工具。# 更新软件包列表 sudo apt update sudo apt upgrade -y # 安装常用工具 sudo apt install -y curl wget git vim4. 核心流程拆解安装与配置整个部署流程可以清晰地分为四步安装Node.js环境 - 部署云崽Bot - 部署go-cqhttp - 配置两者连接并启动。4.1 安装 Node.js 与 PM2云崽Bot基于Node.js我们需要安装合适的版本并使用PM2进行进程守护。# 1. 安装 Node.js 18.x (LTS版本兼容性好) curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install -y nodejs # 2. 验证安装 node -v # 应输出 v18.x.x npm -v # 应输出对应版本号 # 3. 安装 PM2 (全局安装) sudo npm install -g pm2PM2是什么它是一个Node.js应用进程管理器能保证应用在后台持续运行崩溃后自动重启并方便查看日志。这是保证机器人稳定性的关键。4.2 部署云崽机器人 (Yunzai-Bot)# 1. 克隆仓库使用国内镜像加速如Gitee git clone --depth1 https://gitee.com/yoimiya-kokomi/Yunzai-Bot.git # 或使用GitHub原仓库可能较慢 # git clone --depth1 https://github.com/yoimiya-kokomi/Yunzai-Bot.git # 2. 进入项目目录 cd Yunzai-Bot # 3. 安装依赖 (使用pnpm速度更快。如未安装pnpmnpm会提示安装) npm install -g pnpm pnpm install注意安装依赖可能需要一些时间取决于服务器网络。4.3 部署 go-cqhttp这是独立于云崽的另一个项目。# 1. 回到用户主目录创建单独目录存放go-cqhttp cd ~ mkdir go-cqhttp cd go-cqhttp # 2. 根据服务器CPU架构下载对应版本。x86_64架构最常见。 # 去 GitHub Release 页面查看最新版本号替换下面的链接 wget https://github.com/Mrs4s/go-cqhttp/releases/download/v1.0.0/go-cqhttp_linux_amd64.tar.gz # 如果是ARM架构如树莓派、苹果M芯片或部分轻量服务器使用 # wget https://github.com/Mrs4s/go-cqhttp/releases/download/v1.0.0/go-cqhttp_linux_arm64.tar.gz # 3. 解压 tar -zxvf go-cqhttp_linux_amd64.tar.gz # 4. 给予执行权限 chmod x go-cqhttp4.4 配置 go-cqhttp首次运行会生成配置文件。# 在go-cqhttp目录下执行 ./go-cqhttp程序会提示“未找到配置文件正在为您生成...”并生成config.yml。按CtrlC停止程序然后编辑配置文件。vim config.yml你需要修改以下几个关键部分# 文件~/go-cqhttp/config.yml account: # 账号配置 uin: 123456789 # 填写你的机器人QQ小号 password: # 密码留空推荐使用扫码登录 encrypt: false # 是否启用密码加密暂不开启 status: 0 # 在线状态 relogin: # 重连设置 delay: 3 interval: 3 max-times: 0 # 重要消息上报设置这是连接云崽的关键 message: post-format: array # 上报格式保持默认 # 上报地址云崽Bot运行在本地5700端口 - url: http://127.0.0.1:5700 # HTTP上报地址 - url: ws://127.0.0.1:6700 # WebSocket上报地址 (可选) secret: # 密钥与云崽配置对应暂可不填 # 服务监听设置保持默认即可让它在本地监听 servers: - http: host: 127.0.0.1 port: 5700 timeout: 5 - ws: host: 127.0.0.1 port: 6700 timeout: 5核心理解message.url告诉 go-cqhttp“当你收到QQ消息后把消息内容打包成HTTP请求发送给http://127.0.0.1:5700”。而这个地址正是云崽Bot监听的地方。4.5 配置云崽机器人连接 go-cqhttp云崽的配置文件在Yunzai-Bot/config/config/目录下但通常首次运行后会自动生成。我们需要先运行一次云崽来生成基础配置。# 回到云崽目录 cd ~/Yunzai-Bot # 首次运行会提示配置项。这里可以先按CtrlC退出。 node app现在编辑云崽的QQ配置文件vim config/config/qq.yaml确保其内容指向本地的go-cqhttp# 文件~/Yunzai-Bot/config/config/qq.yaml # 使用 go-cqhttp 的 HTTP 协议 mode: ‘http‘ # 或 ‘ws‘与go-cqhttp配置的上报方式对应 # HTTP 配置 http: host: 127.0.0.1 # go-cqhttp 的HTTP服务地址 port: 5700 # go-cqhttp 的HTTP服务端口 secret: ‘’ # 密钥与go-cqhttp配置的secret对应 # WebSocket 配置 (如果使用ws模式) ws: host: 127.0.0.1 port: 6700 secret: ‘’至此双向通信链路配置完成go-cqhttp 收QQ消息 - 上报给云崽 - 云崽处理 - 返回指令给 go-cqhttp - go-cqhttp 发回QQ。5. 完整启动与验证流程5.1 使用 PM2 启动云崽机器人我们不直接使用node app而是用PM2守护。# 在云崽根目录下 cd ~/Yunzai-Bot pm2 start app.js --name yunzai-bot--name yunzai-bot为进程起个名字方便管理。使用pm2 logs yunzai-bot可以查看实时日志。使用pm2 status查看进程状态。5.2 启动 go-cqhttp 并登录QQ在另一个SSH窗口或使用screen/tmux工具进入go-cqhttp目录启动。cd ~/go-cqhttp ./go-cqhttp首次以配置好的账号启动会提示选择登录协议请选择登录设备类型 (默认: 1): 1: 安卓手机 2: aPad 3: 安卓手表 4: 安卓平板 5: macOS 6: iPad输入3选择安卓手表协议风险较低。程序会生成一个device.json设备文件。随后程序会尝试登录。因为我们在config.yml中未填密码它会提示[INFO]: 登录需要滑条验证请选择验证方式: 1: 使用手机QQ扫描二维码 (推荐) 2: 使用手机QQ扫码然后在手机端确认 3: 使用TX内置浏览器验证 (不推荐)选择1。控制台会显示一个二维码。使用你的手机QQ注意是用于登录机器人账号的那个手机QQ不是扫码的手机QQ扫描这个二维码进行登录验证。重要扫码登录的必须是机器人账号绑定的手机QQ。登录成功后控制台会显示“登录成功”的信息。此时go-cqhttp就在后台运行了。你可以按CtrlB然后按D键如果使用screen将其放入后台或者直接关闭SSH窗口如果使用PM2守护go-cqhttp见下文。5.3 验证机器人是否在线检查进程运行pm2 status应看到yunzai-bot状态为online。检查日志运行pm2 logs yunzai-bot查看云崽日志有无报错。正常启动会看到插件加载等信息。功能测试在你的任意QQ群中机器人账号或直接对机器人账号发起私聊发送指令#帮助或#菜单。如果一切正常机器人应该会回复一个功能菜单。5.4 (高级) 使用 PM2 也守护 go-cqhttp为了让go-cqhttp也和云崽一样稳定运行我们也可以用PM2来管理它。但注意go-cqhttp是二进制文件不是Node.js应用PM2需要通过包装脚本来运行。# 在go-cqhttp目录下创建一个启动脚本 cd ~/go-cqhttp vim start_cqhttp.sh在脚本中输入#!/bin/bash cd /home/your_username/go-cqhttp # 替换为你的实际路径 ./go-cqhttp保存退出后赋予执行权限并交给PM2管理chmod x start_cqhttp.sh pm2 start ./start_cqhttp.sh --name go-cqhttp现在两个核心服务都在PM2的守护下了。可以使用pm2 save保存当前进程列表并使用pm2 startup设置开机自启根据提示操作。6. 运行结果与效果验证成功部署后你的机器人应该具备以下基础能力响应指令在群聊或私聊中发送#帮助机器人会回复内置的命令列表。基础互动一些内置的趣味功能如#舔狗日记、#土味情话等可以正常触发。状态查询通过PM2命令你可以随时掌握机器人的运行状态。验证步骤清单pm2 status确认yunzai-bot和go-cqhttp状态均为online。pm2 logs yunzai-bot --lines 50查看最近日志无连续报错。在QQ上给机器人发送#状态或#help观察是否收到回复。测试一个简单插件功能如#天气 北京需先安装对应插件。如果机器人无响应请按以下顺序排查go-cqhttp是否在线检查其进程和日志确认QQ已登录成功。网络连接是否通畅在服务器上执行curl http://127.0.0.1:5700看go-cqhttp的HTTP服务是否正常响应可能返回405但至少不是连接拒绝。云崽是否收到消息查看云崽日志 (pm2 logs yunzai-bot)当你在QQ发言时日志里应该有相应的接收消息记录。配置是否正确双重检查go-cqhttp/config.yml中的message.url和~/Yunzai-Bot/config/config/qq.yaml中的mode和端口号确保一致。7. 常见问题与排查思路问题现象可能原因排查方式解决方案go-cqhttp启动失败提示“端口被占用”5700或6700端口已被其他程序占用。netstat -tlnp | grep :5700杀死占用进程或修改config.yml中servers下的端口号并同步修改云崽的qq.yaml配置。扫码登录失败提示“版本过低”或“网络错误”协议选择不当或腾讯风控。查看go-cqhttp日志。1. 尝试更换登录协议如安卓手机。2. 更换登录时间或网络环境如用服务器IP直接扫码。3.极端情况账号被暂时风控等待一段时间再试。机器人能登录但完全不回复消息1. 云崽未启动。2. 上报地址配置错误。3. 云崽插件未加载。1.pm2 status。2. 核对config.yml和qq.yaml的IP和端口。3. 查看云崽启动日志。1. 启动云崽。2. 修正配置确保都是127.0.0.1。3. 重启云崽观察插件加载日志。PM2管理的进程无故退出内存不足、代码错误、依赖问题。pm2 logs 进程名 --lines 100查看退出前的错误日志。1. 根据日志错误信息解决如升级依赖pnpm update。2. 增加服务器虚拟内存swap。3. 使用pm2 restart 进程名重启。某些插件命令无效插件未安装、未启用或配置错误。在云崽目录下检查plugins文件夹是否存在对应插件。使用插件管理器安装或更新插件如#喵喵帮助查看插件管理指令。服务器重启后机器人未自动启动未设置PM2开机自启。重启服务器后SSH连接并执行pm2 status。执行pm2 save和pm2 startup并按照生成的命令执行。8. 最佳实践与工程建议将机器人“跑起来”只是第一步要让其长期稳定、安全地服务还需要遵循以下实践使用版本控制将你对云崽Bot的配置文件如qq.yaml、自定义插件或脚本进行备份。可以考虑在服务器上初始化一个git仓库方便回滚。定期更新与维护# 进入云崽目录更新本体 cd ~/Yunzai-Bot git pull pnpm install # 或 pnpm update pm2 restart yunzai-bot # 更新 go-cqhttp (谨慎操作先备份) cd ~/go-cqhttp cp config.yml device.json config.bak/ # 备份配置 # 重新下载最新release并替换二进制文件日志管理PM2的日志默认在~/.pm2/logs/下可能会越来越大。可以配置日志轮转logrotate或定期清理。# 安装logrotate配置 (示例) sudo vim /etc/logrotate.d/pm2 # 加入以下内容 /home/your_username/.pm2/logs/*.log { daily rotate 7 compress delaycompress missingok notifempty create 0640 your_username your_username }安全加固禁用密码登录使用SSH密钥修改服务器SSH配置提升安全性。保持系统更新定期运行sudo apt update sudo apt upgrade。限制不必要的端口在云服务商安全组中严格只开放必要的端口如22。隔离运行考虑使用非root用户运行机器人进程降低风险。功能扩展云崽的强大在于插件生态。可以通过安装插件来增加功能例如喵喵插件 (Miao-Plugin)提供丰富的查询、管理、娱乐功能。小叶插件 (XiaoYe-Plugin)提供更多游戏、工具类功能。AI对话插件接入大语言模型让机器人更智能。 安装插件通常通过Git克隆到plugins目录并在机器人中启用。注意插件来源的安全性。资源监控对于长期运行的服务器使用简单的监控命令关注资源使用情况。# 查看系统资源概览 htop # 或使用 free -h # 查看内存 df -h # 查看磁盘9. 总结与后续学习方向通过本文你完成的不只是一次简单的软件安装而是一次完整的服务端应用部署实践。你学到了架构理解清晰区分了协议端(go-cqhttp)与业务端(云崽Bot)的角色与通信方式。环境搭建在Linux服务器上配置Node.js环境并使用PM2进行进程守护。配置联动通过修改YAML配置文件将两个独立服务连接成一个可工作的系统。运维基础掌握了服务启动、状态检查、日志查看和基础问题排查的方法。安全意识理解了使用小号、选择合适协议、配置服务器防火墙的重要性。下一步你可以探索插件开发如果你有JavaScript/Node.js基础可以阅读云崽的插件开发文档尝试编写自己的机器人插件实现定制化功能。容器化部署使用Docker将go-cqhttp和云崽Bot容器化实现更干净的环境隔离和更便捷的迁移部署。接入AI能力研究如何为云崽接入ChatGPT、文心一言等大语言模型的API打造一个更智能的聊天助手。Web面板管理寻找或开发一个Web管理界面方便在浏览器中管理机器人、查看状态、配置插件而不必总是登录SSH。搭建QQ机器人是一个有趣的起点它串联起了网络协议、服务部署、进程管理和应用开发多个环节。希望这份教程能成为你探索更多服务器端应用开发的坚实基石。如果在实践中遇到新的问题善用搜索引擎、查阅项目官方文档和社区讨论大部分难题都能找到答案。祝你玩得开心打造出独一无二的QQ机器人助手。 你是否想过为什么别人的QQ群聊里总有一个“小助手”能自动回复、查天气、玩游戏而你的群却只能手动全体成员这背后往往是一个部署在服务器上的QQ机器人。今天我们不再只讲“是什么”而是要解决一个更实际的问题如何从零开始在云服务器上搭建一个稳定、可扩展的QQ机器人并让它真正为你所用而不是三天两头掉线或功能单一。本文将以当前热门的“云崽机器人”框架为例带你完成一次完整的服务器端QQ机器人部署。云崽Yunzai-Bot基于 Node.js 和 go-cqhttp功能丰富、插件生态活跃是个人开发者和小型社群管理者的优选。但网上教程往往只讲“跑起来”却忽略了服务器选型、长期稳定运行、安全风险规避这些真正决定项目成败的细节。读完本文你将能理解QQ机器人背后的技术栈与核心组件而不仅仅是复制命令。在主流云服务器如阿里云、腾讯云上完成从环境配置到机器人上线的全流程包括如何选择适合的服务器配置。掌握让机器人7x24小时稳定运行的守护方案告别进程意外退出。了解关键的安全配置与合规要点避免账号风险。获得扩展机器人功能的清晰路径知道如何安装和管理插件。我们开始吧。1. 这篇文章真正要解决的问题很多开发者尝试搭建QQ机器人时会遇到几个典型困境教程碎片化A教程讲安装B教程讲插件但环境依赖、版本冲突、服务器配置这些承上启下的关键步骤没人系统讲。“本地能跑一上服务器就挂”在Windows电脑上测试顺利一旦部署到Linux云服务器各种权限问题、端口问题、依赖缺失问题接踵而至。运行不稳定用node app.js直接启动SSH一断开机器人就离线缺乏进程守护。对安全风险无知直接使用扫码登录的协议可能导致账号被风控甚至封禁对服务器的基础安全如防火墙也毫无概念。功能拓展迷茫机器人跑起来后不知道去哪里找插件如何安装如何配置。本文的核心就是系统性地解决上述问题。我们不仅要把机器人“点亮”更要把它部署成一个可靠、可维护的后台服务。目标读者是具备基础命令行操作能力了解ls,cd,vim等、对Node.js或Python生态有初步接触的开发者或技术爱好者。2. 基础概念与核心原理在动手之前必须理解QQ机器人的核心工作原理。它不是一个腾讯官方提供的服务而是通过技术手段模拟QQ客户端实现消息的接收与发送。核心组件与数据流用户QQ --- 腾讯官方服务器 --- go-cqhttp (协议端) --- 云崽机器人 (业务逻辑端) --- 你的服务器go-cqhttp (协议端)这是一个开源项目它实现了QQ客户端协议。它的角色是“桥梁”或“网关”负责登录你的QQ账号作为机器人账号。与腾讯服务器通信接收群消息、私聊消息等事件。将这些事件转换成HTTP或WebSocket请求转发给后面的机器人业务端如云崽。接收业务端返回的指令再转换成QQ协议发送出去。关键点它处理所有和腾讯服务器的复杂通信让业务开发者无需关心协议细节。云崽机器人 (Yunzai-Bot, 业务逻辑端)这是机器人的“大脑”基于Node.js开发。它的职责是接收来自go-cqhttp的事件如消息内容、发送者信息。根据预设的规则、插件、AI模型等处理这些消息并生成回复内容。将回复内容返回给go-cqhttp。管理插件系统、定时任务、数据存储等。服务器提供24小时运行环境的载体。go-cqhttp和云崽Bot都运行在其上。为什么需要服务器因为你的个人电脑不可能永远开机在线。云服务器提供了公网IP、稳定的网络和持续运行的环境确保机器人随时待命。协议选择与安全提示 go-cqhttp支持多种登录协议如Android Phone, Android Watch。不同协议稳定性和风控风险不同。强烈建议使用Android Watch协议它被风控的概率相对较低。切勿使用来路不明的破解协议或签名服务器这有极高的账号安全风险。本文所有操作均基于开源、合法的技术方案。3. 环境准备与前置条件3.1 服务器准备你需要一台拥有公网IP的Linux云服务器。国内主流选择有阿里云、腾讯云、华为云等。系统推荐Ubuntu 20.04/22.04 LTS或CentOS 7/8本文以Ubuntu 22.04为例。配置对于初期学习和测试1核CPU、2GB内存、40GB硬盘的入门级配置如阿里云ECS t6系列或腾讯云轻量应用服务器完全足够。如果计划运行大量插件或AI模型建议升级到2核4G。安全组/防火墙确保在云服务商控制台开放以下端口以阿里云为例22端口用于SSH连接通常默认开放。5700端口go-cqhttp的HTTP事件上报端口内部通信不建议对公网开放仅需服务器内部可访问。6700端口go-cqhttp的WebSocket端口可选同不建议对公网开放。最佳实践只开放22端口用于管理。go-cqhttp与云崽Bot通过本地环回地址127.0.0.1通信无需公网暴露。3.2 本地工具准备SSH客户端如PuTTY (Windows) 或系统终端 (macOS/Linux)。代码/文件编辑器如VS Code配合SFTP或Remote-SSH插件方便在服务器上编辑文件。一个用于机器人的QQ小号非常重要请不要使用你的主力QQ账号使用一个不常用的账号作为机器人账号以防潜在风险。3.3 服务器基础环境配置通过SSH连接到你的服务器首先进行系统更新和安装基础工具。# 更新软件包列表 sudo apt update sudo apt upgrade -y # 安装常用工具 sudo apt install -y curl wget git vim4. 核心流程拆解安装与配置整个部署流程可以清晰地分为四步安装Node.js环境 - 部署云崽Bot - 部署go-cqhttp - 配置两者连接并启动。4.1 安装 Node.js 与 PM2云崽Bot基于Node.js我们需要安装合适的版本并使用PM2进行进程守护。# 1. 安装 Node.js 18.x (LTS版本兼容性好) curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install -y nodejs # 2. 验证安装 node -v # 应输出 v18.x.x npm -v # 应输出对应版本号 # 3. 安装 PM2 (全局安装) sudo npm install -g pm2PM2是什么它是一个Node.js应用进程管理器能保证应用在后台持续运行崩溃后自动重启并方便查看日志。这是保证机器人稳定性的关键。4.2 部署云崽机器人 (Yunzai-Bot)# 1. 克隆仓库使用国内镜像加速如Gitee git clone --depth1 https://gitee.com/yoimiya-kokomi/Yunzai-Bot.git # 或使用GitHub原仓库可能较慢 # git clone --depth1 https://github.com/yoimiya-kokomi/Yunzai-Bot.git # 2. 进入项目目录 cd Yunzai-Bot # 3. 安装依赖 (使用pnpm速度更快。如未安装pnpmnpm会提示安装) npm install -g pnpm pnpm install注意安装依赖可能需要一些时间取决于服务器网络。4.3 部署 go-cqhttp这是独立于云崽的另一个项目。# 1. 回到用户主目录创建单独目录存放go-cqhttp cd ~ mkdir go-cqhttp cd go-cqhttp # 2. 根据服务器CPU架构下载对应版本。x86_64架构最常见。 # 去 GitHub Release 页面查看最新版本号替换下面的链接 wget https://github.com/Mrs4s/go-cqhttp/releases/download/v1.0.0/go-cqhttp_linux_amd64.tar.gz # 如果是ARM架构如树莓派、苹果M芯片或部分轻量服务器使用 # wget https://github.com/Mrs4s/go-cqhttp/releases/download/v1.0.0/go-cqhttp_linux_arm64.tar.gz # 3. 解压 tar -zxvf go-cqhttp_linux_amd64.tar.gz # 4. 给予执行权限 chmod x go-cqhttp4.4 配置 go-cqhttp首次运行会生成配置文件。# 在go-cqhttp目录下执行 ./go-cqhttp程序会提示“未找到配置文件正在为您生成...”并生成config.yml。按CtrlC停止程序然后编辑配置文件。vim config.yml你需要修改以下几个关键部分# 文件~/go-cqhttp/config.yml account: # 账号配置 uin: 123456789 # 填写你的机器人QQ小号 password: # 密码留空推荐使用扫码登录 encrypt: false # 是否启用密码加密暂不开启 status: 0 # 在线状态 relogin: # 重连设置 delay: 3 interval: 3 max-times: 0 # 重要消息上报设置这是连接云崽的关键 message: post-format: array # 上报格式保持默认 # 上报地址云崽Bot运行在本地5700端口 - url: http://127.0.0.1:5700 # HTTP上报地址 - url: ws://127.0.0.1:6700 # WebSocket上报地址 (可选) secret: # 密钥与云崽配置对应暂可不填 # 服务监听设置保持默认即可让它在本地监听 servers: - http: host: 127.0.0.1 port: 5700 timeout: 5 - ws: host: 127.0.0.1 port: 6700 timeout: 5核心理解message.url告诉 go-cqhttp“当你收到QQ消息后把消息内容打包成HTTP请求发送给http://127.0.0.1:5700”。而这个地址正是云崽Bot监听的地方。4.5 配置云崽机器人连接 go-cqhttp云崽的配置文件在Yunzai-Bot/config/config/目录下但通常首次运行后会自动生成。我们需要先运行一次云崽来生成基础配置。# 回到云崽目录 cd ~/Yunzai-Bot # 首次运行会提示配置项。这里可以先按CtrlC退出。 node app现在编辑云崽的QQ配置文件vim config/config/qq.yaml确保其内容指向本地的go-cqhttp# 文件~/Yunzai-Bot/config/config/qq.yaml # 使用 go-cqhttp 的 HTTP 协议 mode: ‘http‘ # 或 ‘ws‘与go-cqhttp配置的上报方式对应 # HTTP 配置 http: host: 127.0.0.1 # go-cqhttp 的HTTP服务地址 port: 5700 # go-cqhttp 的HTTP服务端口 secret: ‘’ # 密钥与go-cqhttp配置的secret对应 # WebSocket 配置 (如果使用ws模式) ws: host: 127.0.0.1 port: 6700 secret: ‘’至此双向通信链路配置完成go-cqhttp 收QQ消息 - 上报给云崽 - 云崽处理 - 返回指令给 go-cqhttp - go-cqhttp 发回QQ。5. 完整启动与验证流程5.1 使用 PM2 启动云崽机器人我们不直接使用node app而是用PM2守护。# 在云崽根目录下 cd ~/Yunzai-Bot pm2 start app.js --name yunzai-bot--name yunzai-bot为进程起个名字方便管理。使用pm2 logs yunzai-bot可以查看实时日志。使用pm2 status查看进程状态。5.2 启动 go-cqhttp 并登录QQ在另一个SSH窗口或使用screen/tmux工具进入go-cqhttp目录启动。cd ~/go-cqhttp ./go-cqhttp首次以配置好的账号启动会提示选择登录协议请选择登录设备类型 (默认: 1): 1: 安卓手机 2: aPad 3: 安卓手表 4: 安卓平板 5: macOS 6: iPad输入3选择安卓手表协议风险较低。程序会生成一个device.json设备文件。随后程序会尝试登录。因为我们在config.yml中未填密码它会提示[INFO]: 登录需要滑条验证请选择验证方式: 1: 使用手机QQ扫描二维码 (推荐) 2: 使用手机QQ扫码然后在手机端确认 3: 使用TX内置浏览器验证 (不推荐)选择1。控制台会显示一个二维码。使用你的手机QQ注意是用于登录机器人账号的那个手机QQ不是扫码的手机QQ扫描这个二维码进行登录验证。重要扫码登录的必须是机器人账号绑定的手机QQ。登录成功后控制台会显示“登录成功”的信息。此时go-cqhttp就在后台运行了。你可以按CtrlB然后按D键如果使用screen将其放入后台或者直接关闭SSH窗口如果使用PM2守护go-cqhttp见下文。5.3 验证机器人是否在线检查进程运行pm2 status应看到yunzai-bot状态为online。检查日志运行pm2 logs yunzai-bot查看云崽日志有无报错。正常启动会看到插件加载等信息。功能测试在你的任意QQ群中机器人账号或直接对机器人账号发起私聊发送指令#帮助或#菜单。如果一切正常机器人应该会回复一个功能菜单。5.4 (高级) 使用 PM2 也守护 go-cqhttp为了让go-cqhttp也和云崽一样稳定运行我们也可以用PM2来管理它。但注意go-cqhttp是二进制文件不是Node.js应用PM2需要通过包装脚本来运行。# 在go-cqhttp目录下创建一个启动脚本 cd ~/go-cqhttp vim start_cqhttp.sh在脚本中输入#!/bin/bash cd /home/your_username/go-cqhttp # 替换为你的实际路径 ./go-cqhttp保存退出后赋予执行权限并交给PM2管理chmod x start_cqhttp.sh pm2 start ./start_cqhttp.sh --name go-cqhttp现在两个核心服务都在PM2的守护下了。可以使用pm2 save保存当前进程列表并使用pm2 startup设置开机自启根据提示操作。6. 运行结果与效果验证成功部署后你的机器人应该具备以下基础能力响应指令在群聊或私聊中发送#帮助机器人会回复内置的命令列表。基础互动一些内置的趣味功能如#舔狗日记、#土味情话等可以正常触发。状态查询通过PM2命令你可以随时掌握机器人的运行状态。验证步骤清单pm2 status确认yunzai-bot和go-cqhttp状态均为online。pm2 logs yunzai-bot --lines 50查看最近日志无连续报错。在QQ上给机器人发送#状态或#help观察是否收到回复。测试一个简单插件功能如#天气 北京需先安装对应插件。如果机器人无响应请按以下顺序排查go-cqhttp是否在线检查其进程和日志确认QQ已登录成功。网络连接是否通畅在服务器上执行curl http://127.0.0.1:5700看go-cqhttp的HTTP服务是否正常响应可能返回405但至少不是连接拒绝。云崽是否收到消息查看云崽日志 (pm2 logs yunzai-bot)当你在QQ发言时日志里应该有相应的接收消息记录。配置是否正确双重检查go-cqhttp/config.yml中的message.url和~/Yunzai-Bot/config/config/qq.yaml中的mode和端口号确保一致。7. 常见问题与排查思路问题现象可能原因排查方式解决方案go-cqhttp启动失败提示“端口被占用”5700或6700端口已被其他程序占用。netstat -tlnp | grep :5700杀死占用进程或修改config.yml中servers下的端口号并同步修改云崽的qq.yaml配置。扫码登录失败提示“版本过低”或“网络错误”协议选择不当或腾讯风控。查看go-cqhttp日志。1. 尝试更换登录协议如安卓手机。2. 更换登录时间或网络环境如用服务器IP直接扫码。3.极端情况账号被暂时风控等待一段时间再试。机器人能登录但完全不回复消息1. 云崽未启动。2. 上报地址配置错误。3. 云崽插件未加载。1.pm2 status。2. 核对config.yml和qq.yaml的IP和端口。3. 查看云崽启动日志。1. 启动云崽。2. 修正配置确保都是127.0.0.1。3. 重启云崽观察插件加载日志。PM2管理的进程无故退出内存不足、代码错误、依赖问题。pm2 logs 进程名 --lines 100查看退出前的错误日志。1. 根据日志错误信息解决如升级依赖pnpm update。2. 增加服务器虚拟内存swap。3. 使用pm2 restart 进程名重启。某些插件命令无效插件未安装、未启用或配置错误。在云崽目录下检查plugins文件夹是否存在对应插件。使用插件管理器安装或更新插件如#喵喵帮助查看插件管理指令。服务器重启后机器人未自动启动未设置PM2开机自启。重启服务器后SSH连接并执行pm2 status。执行pm2 save和pm2 startup并按照生成的命令执行。8. 最佳实践与工程建议将机器人“跑起来”只是第一步要让其长期稳定、安全地服务还需要遵循以下实践使用版本控制将你对云崽Bot的配置文件如qq.yaml、自定义插件或脚本进行备份。可以考虑在服务器上初始化一个git仓库方便回滚。定期更新与维护# 进入云崽目录更新本体 cd ~/Yunzai-Bot git pull pnpm install # 或 pnpm update pm2 restart yunzai-bot # 更新 go-cqhttp (谨慎操作先备份) cd ~/go-cqhttp cp config.yml device.json config.bak/ # 备份配置 # 重新下载最新release并替换二进制文件日志管理PM2的日志默认在~/.pm2/logs/下可能会越来越大。可以配置日志轮转logrotate或定期清理。# 安装logrotate配置 (示例) sudo vim /etc/logrotate.d/pm2 # 加入以下内容 /home/your_username/.pm2/logs/*.log { daily rotate 7 compress delaycompress missingok notifempty create 0640 your_username your_username }安全加固禁用密码登录使用SSH密钥修改服务器SSH配置提升安全性。保持系统更新定期运行sudo apt update sudo apt upgrade。限制不必要的端口在云服务商安全组中严格只开放必要的端口如22。隔离运行考虑使用非root用户运行机器人进程降低风险。功能扩展云崽的强大在于插件生态。可以通过安装插件来增加功能例如喵喵插件 (Miao-Plugin)提供丰富的查询、管理、娱乐功能。小叶插件 (XiaoYe-Plugin)提供更多游戏、工具类功能。AI对话插件接入大语言模型让机器人更智能。 安装插件通常通过Git克隆到plugins目录并在机器人中启用。注意插件来源的安全性。资源监控对于长期运行的服务器使用简单的监控命令关注资源使用情况。# 查看系统资源概览 htop # 或使用 free -h # 查看内存 df -h # 查看磁盘9. 总结与后续学习方向通过本文你完成的不只是一次简单的软件安装而是一次完整的服务端应用部署实践。你学到了架构理解清晰区分了协议端(go-cqhttp)与业务端(云崽Bot)的角色与通信方式。环境搭建在Linux服务器上配置Node.js环境并使用PM2进行进程守护。配置联动通过修改YAML配置文件将两个独立服务连接成一个可工作的系统。运维基础掌握了服务启动、状态检查、日志查看和基础问题排查的方法。安全意识理解了使用小号、选择合适协议、配置服务器防火墙的重要性。下一步你可以探索插件开发如果你有JavaScript/Node.js基础可以阅读云崽的插件开发文档尝试编写自己的机器人插件实现定制化功能。容器化部署使用Docker将go-cqhttp和云崽Bot容器化实现更干净的环境隔离和更便捷的迁移部署。接入AI能力研究如何为云崽接入ChatGPT、文心一言等大语言模型的API打造一个更智能的聊天助手。Web面板管理寻找或开发一个Web管理界面方便在浏览器中管理机器人、查看状态、配置插件而不必总是登录SSH。搭建QQ机器人是一个有趣的起点它串联起了网络协议、服务部署、进程管理和应用开发多个环节。希望这份教程能成为你探索更多服务器端应用开发的坚实基石。如果在实践中遇到新的问题善用搜索引擎、查阅项目官方文档和社区讨论大部分难题都能找到答案。祝你玩得开心打造出独一无二的QQ机器人助手。 
![[第四次作业]](http://pic.xiahunao.cn/yaotu/[第四次作业])
