配置astrbot实现qq agent机器人教程

发布人：梦发布时间：2026-08-23 15:08 阅读量：188

AstrBot + NapCat 部署教程

🤖 AstrBot + NapCat 部署教程

完整的云服务器部署指南 · 包含一键复制命令

1 准备云服务器

在产品中心购买一台云服务器，推荐配置：4核CPU + 4GB内存，系统建议选择 Ubuntu 20.04/22.04 或 CentOS 7/8。

💡 提示： 如果预算充足，建议选择更高配置以获得更好性能。

2 连接 SSH 并安装宝塔面板

使用你喜欢的 SSH 工具（如 Xshell、FinalShell、PuTTY 或终端）连接到服务器。

执行以下命令安装宝塔面板：

if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh c8e9b16e

📌 注意： 安装完成后，请根据终端输出的信息访问宝塔面板地址，并绑定你的宝塔账户（如果没有请注册）。

3 安装 Docker

在宝塔面板中，进入 软件商店 → 搜索 Docker → 点击安装。

或者使用命令行安装：

curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

✅ 验证安装： 运行 docker --version 查看版本号。

4 部署 AstrBot

在 Docker 中运行 AstrBot 容器，映射端口 6185：

docker run -d \
  --name astrbot \
  -p 0.0.0.0:6185:6185 \
  --restart=always \
  soulter/astrbot:latest

📌 说明： --restart=always 保证容器在服务器重启后自动启动。

5 部署 NapCat

运行 NapCat Docker 容器，映射端口 3000、3001、6099：

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

📌 说明： NAPCAT_GID 和 NAPCAT_UID 用于设置文件权限，确保数据持久化正常。

6 调整 Docker 内网地址

查看 NapCat 容器的内部 IP 地址：

docker inspect napcat | grep IPAddress

或者进入容器查看：

docker exec -it napcat cat /etc/hosts

💡 提示： 记下 NapCat 容器的 IP 地址（通常为 172.17.0.x），后续配置 AstrBot 时需要用到。

7 配置 NapCat 与 AstrBot 通信

进入 AstrBot 容器进行配置：

docker exec -it astrbot /bin/bash

在 AstrBot 配置文件中，将 WebSocket 地址设置为 NapCat 容器地址：

ws://[napcat容器IP]:6099

示例配置（假设 NapCat IP 为 172.17.0.3）：

{
  "websocket": {
    "host": "172.17.0.3",
    "port": 6099
  }
}

✅ 完成！ 配置完成后，重启 AstrBot 容器使配置生效：
docker restart astrbot

📋 所有命令汇总

# 1. 安装宝塔面板
if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh c8e9b16e

# 2. 安装 Docker
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

# 3. 部署 AstrBot
docker run -d \
  --name astrbot \
  -p 0.0.0.0:6185:6185 \
  --restart=always \
  soulter/astrbot:latest

# 4. 部署 NapCat
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

# 5. 查看容器 IP
docker inspect napcat | grep IPAddress

# 6. 进入 AstrBot 容器
docker exec -it astrbot /bin/bash

💻 部署完成后，访问 http://你的服务器IP:6185 即可使用 AstrBot

文章标签：教程

上一篇：关于vps高占用

下一篇：梦云互联nat云服务使用教程

更多栏目