📚前言

         一日不见，如隔三秋，我想你们了！亲爱的，我最近知道了一个云服务器平台——雨云。我使用的是雨云云服务器+AstrBot+NapCat搭建QQ个人机器人（非官方机器人），主要是QQ官方机器人需要用到域名，我只能搭建QQ个人机器人（非官方）。

---

📖目录

📚前言

📖目录

📚前言

⭐简介（介绍使用的平台工具🛠️）

🌙步骤（要用到的代码可copy哦） 

🌸友链 （出现问题转官方网read）

✌🏻结尾

⭐简介

🌙步骤（仔细read，亲爱的）

通过 雨云 一键部署

雨云云服务器

云应用部署方式

补充：NapCat.Installer - Linux 一键使用脚本(支持Ubuntu 20+/Debian 10+/Centos9) recommend

docker容器部署

在终端执行以下命令即可一键部署。

获取日志/查看Token

docker-compose 运行

固化路径，方便下次直接快速登录

连接到 AstrBot

在 AstrBot 配置 aiocqhttp

配置管理员

登录

在 NapCatQQ 中添加 WebSocket 客户端

🌸友链 （魔法上网，跳转网站）

✌🏻结尾

---

⭐简介

雨云平台：

雨云是国内领先的具有自主知识产权的云计算平台，有云服务器、虚拟主机、游戏云、云电脑等产品，无论你是新手小白，还是云上大佬，都能给您优秀的体验。 这里有完善的文档，可以帮助您快速上手雨云。

我作为一个接触雨云平台没几天的萌新来说，我觉得上手还是可以的，毕竟还有官方的各种文档玩法说明和搭建指南，不懂的宝子可以进QQ群问问或者点交流社区提出你的疑问。

优惠码：bZ可打折，当然你可以点击雨云平台跳转登录页面。但是还是建议使用优惠码哦，亲爱的♡ⅴ♡！你们可以注册登录，然后进 Q群问问！

AstrBot:

AstrBot 致力于成为一个开源的一站式 Agentic 聊天机器人平台及开发框架。通过它，你能够在多种消息平台上部署和开发一个支持大语言模型（LLM）的聊天机器人。

• 大模型对话。支持接入多种大模型服务。支持多模态、工具调用、MCP、原生知识库、人设等功能。
• 多消息平台支持。支持接入 QQ、企业微信、微信公众号、飞书、Telegram、钉钉、Discord、KOOK 等平台。支持速率限制、白名单、百度内容审核。
• Agent。完善适配的 Agentic 能力。支持多轮工具调用、内置沙盒代码执行器、网页搜索等功能。
• 插件扩展。深度优化的插件机制，支持开发插件扩展功能，社区插件生态丰富。
• WebUI。可视化配置和管理机器人，功能齐全。

  

NapCat:

基于 TypeScript 构建的 Bot 框架，通过相应的启动器或者框架，主动调用 QQ Node 模块提供给客户端的接口，实现 Bot 的功能。

魔法版：猫猫框架通过魔法的手段获得了 QQ 的发送消息、接收消息等接口。

为了方便使用，猫猫框架将通过一种名为 OneBot 的约定将你的 HTTP / WebSocket 请求按照规范读取，再去调用猫猫框架所获得的 QQ 发送接口之类的接口。

通过 NapCatQQ 协议实现端接入 QQ

• 请合理控制使用频率。过于频繁地发送消息可能会被判定为异常行为，增加触发风控机制的风险。
• 本项目严禁用于任何违反法律法规的用途。若您意图将 AstrBot 应用于非法产业或活动，我们明确反对并拒绝您使用本项目。

前置准备：

• 一个 QQ 号（最好不是新创建的 QQ 号）。
• 一台具有摄像功能的手机以扫码登录 QQ。

NapCat 提供了大量的部署方式，包括 Docker、Windows 一键安装包等等。

注意适当打开加速器或者是代理进行可能有关的操作。

---

🌙步骤（仔细read，亲爱的）

通过 雨云 一键部署

AstrBot 已经上架至雨云的预装软件列表，支持一键安装 AstrBot 并提供高性能的云计算资源，保证 AstrBot 24 小时在线。

目前有两种部署方式：云服务器部署和云应用部署。

此处我选雨云云服务器一键部署

雨云云服务器

• 注册雨云账号登录，购买云服务器设备自己需要的配置，不要选江苏宿迁的云服务器（bear 试过了，打开不了webui界面【海外的】，也问了群里的佬说是宿迁封UDF和海外）。

可以选一台自己觉得合适的云服务器试用，不合适直接退订就行了。

• 点击控制台，进行云服务器部署方式

在这一步，你需要选购一个云服务器，你也可以选购更高配置的服务器。

1. 打开 雨云官网。
2. 根据你的喜好和预算，选择一个合适的服务器配置。
3. 🥰 如果您希望更支持和长期使用本开源项目，可以选购更高配置和更长时长的服务器。（所有的推广费用将用于 AstrBot 目前使用的云服务器开销）
4. 在下面的 系统和软件安装 一节，选中 AstrBot，然后点击 立即购买。
5. 如果您的余额不足，将会跳转至充值页面。充值完成后再返回点击 立即购买 即可。

接下来，雨云会自动帮您安装好系统和 AstrBot 软件。

如果有疑问，请：

1. 点击雨云官网右下角 咨询 提交工单
2. 点击雨云官网上方 交流社区 添加雨云 QQ 群。

云应用部署方式

雨云支持更加优惠的云应用部署方式来一键部署 AstrBot。

如果您需要接入 QQ 个人号，雨云云应用还提供 NapCat 应用，您还需部署 NapCat 应用

https://app.rainyun.com/apps/rca/store/5994

---

补充：NapCat.Installer - Linux 一键使用脚本(支持Ubuntu 20+/Debian 10+/Centos9) recommend

docker 安装卡住的请使用下方项目并自行换源

curl -o \
napcat.sh \
https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh \
&& sudo bash napcat.sh \
--docker y \
--qq "123456789" \
--mode ws \
--proxy 1 \
--confirm

---

docker容器部署

在终端执行以下命令即可一键部署。

命令行运行

docker run -d \
-e NAPCAT_GID=$(id -g) \
-e NAPCAT_UID=$(id -u) \
-p 3000:3000 \
-p 3001:3001 \
-p 6099:6099 \
--name napcat \
--restart=always \
mlikiowa/napcat-docker:latest

（ps：在win下部署 以上代码docker萌新小白可能会直接复制粘贴导致报错，提交一个可以直接复制粘贴用的，
 按照astrbot默认端口建议6199所以新加了个6199，那个uid还没搞清楚是什么）
docker run -d -p 6099:6099  -p 3001:3001 -p 6199:6199 --name napcat --restart=always mlikiowa/napcat-docker:latest

获取日志/查看Token

docker logs 容器名

示例 docker logs napcat 默认登录Token napcat

docker logs napcat

请复制管理面板的 URL，然后在浏览器中打开备用。

然后使用你要登录的 QQ 扫描出现的二维码，即可登录。

如果登录阶段没有出现问题，即成功部署。

---

docker-compose 运行

创建 docker-compose.yml 文件

# docker-compose.yml
version: "3"
services:
    napcat:
        environment:
            - NAPCAT_UID=${NAPCAT_UID}
            - NAPCAT_GID=${NAPCAT_GID}
        ports:
            - 3000:3000
            - 3001:3001
            - 6099:6099
        container_name: napcat
        network_mode: bridge
        restart: always
        image: mlikiowa/napcat-docker:latest

使用 

NAPCAT_UID=$(id -u) NAPCAT_GID=$(id -g) docker-compose up -d

 运行到后台

固化路径，方便下次直接快速登录

QQ 持久化数据路径：/app/.config/QQ

NapCat 配置文件路径: /app/napcat/config

---

连接到 AstrBot

在 AstrBot 配置 aiocqhttp

1. 进入 AstrBot 的管理面板
2. 点击左边栏 消息平台
3. 然后在右边的界面中，点击 + 新增适配器
4. 选择 aiocqhttp(OneBotv11)

弹出的配置项填写：

配置项填写：

• ID(id)：随意填写，用于区分不同的消息平台实例。
• 启用(enable): 勾选。
• 反向 WebSocket 主机地址：请填写你的机器的 IP 地址。一般情况下请直接填写 0.0.0.0
• 反向 WebSocket 端口：填写一个端口，例如 6199。

点击 保存。

配置管理员

填写完毕后，进入 配置 页，点击 其他配置 选项卡，找到 管理员 ID，填写你的 QQ 号（不是机器人的 QQ 号）。

切记点击右下角 保存，AstrBot 重启并会应用配置。

登录

登录 WebUI 地址：http://<宿主机ip>:6099/webui

在 NapCatQQ 中添加 WebSocket 客户端

切换回 NapCatQQ 的管理面板，点击 网络配置->新建->WebSockets客户端。

 

在新弹出的窗口中：

• 勾选 启用。
• URL 填写 ws://宿主机IP:端口/ws。如 ws://localhost:6199/ws或ws://127.0.0.1:6199/ws。
• 消息格式：Array
• 心跳间隔: 5000
• 重连间隔: 5000

1. 切记后面加一个 /ws!
2. 这里的 IP 不是 0.0.0.0

点击 保存。

前往 AstrBot WebUI 控制台，如果出现 aiocqhttp(OneBot v11) 适配器已连接。 相关蓝色的日志，说明连接成功。

此时，你的 AstrBot 和 NapCatQQ 应该已经连接成功。使用 私聊 的方式在 QQ 对机器人发送 /help 以检查是否连接成功。

🌸友链 （科学上网，跳转网站）

• 亲爱的，如果你是新手小白第一安装出现问题可以通过点击下面的官网链接跳转官方文档对出现的问题进行处理哦！
• 当然我也在之前在当中遇到了好几处问题，下面是我参考官方文档的解决方法，请亲爱的选择符合自己情况进行处理吧！
• 雨云平台
• NapCatQQ安装方式【请点击NapCatQQ安装方式了解更多详情】

• 关于 NAPCAT_UID 与 NAPCAT_GID 环境变量

  前往了解

•  一键模板化配置

  AstrBot Compose模板

  Koishi Compose模板

  WebsockServer Compose模板

---

✌🏻结尾

温馨提示:此文免费，可转载，不可抄袭！！！

最后给我赞赞，代表亲爱的来过！

非常感谢亲爱的抽空观看！

亲爱的，有问题无法解决或者有更好想法的可以评论区留言讨论哦！