准备工作

• 一台 Linux VPS 或本地机器：2 核 1G 内存够跑，推荐 Ubuntu 22.04 或 Debian 12

• 安装好 Docker：没装的话直接搜 Docker 官方文档安装，国内机器可以换 DaoCloud 加速源

• 一个 QQ 号：用来登录成机器人，强烈不建议用主号，风控触发直接封号很难受

• 一台手机：NapCat 登录 QQ 需要扫码，手机要在旁边

第一步：部署 AstrBot

Docker Compose（推荐）

首先，需要 Clone AstrBot 仓库到本地：

git clone https://github.com/AstrBotDevs/AstrBot

cd AstrBot

然后，运行 Compose：

sudo docker compose up -d

如果您想对接 NapCat，使用这种方式可以同时部署 AstrBot 和 NapCat

mkdir astrbot
cd astrbot
wget https://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.yml
sudo docker compose -f astrbot.yml up -d

通过 Docker 部署

mkdir astrbot
cd astrbot
sudo docker run -itd -p 6185:6185 -p 6199:6199 -v $PWD/data:/AstrBot/data -v /etc/localtime:/etc/localtime:ro -v /etc/timezone:/etc/timezone:ro --name astrbot soulter/astrbot:latest

🎉 大功告成

如果一切顺利，你会看到 AstrBot 打印出的日志。

如果没有报错，你会看到一条日志显示类似 🌈 管理面板已启动，可访问 并附带了几条链接。打开其中一个链接即可访问 AstrBot 管理面板。

第二步：部署 NapCat，登录 QQ

如果你用的是方式一的  如果您想对接 NapCat，使用这种方式可以同时部署 AstrBot 和 NapCat NapCat 已经随着 AstrBot 一起部署好了，直接看 NapCat 的日志：

如果你是单独部署 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

几个关键端口说明一下：

6185：WebUI 管理面板，浏览器访问用这个

6199：OneBot/aiocqhttp 协议端口，NapCat 接进来用这个

11451：微信回调端口，只接 QQ 的话用不到

部署完查看日志确认状态：

然后同样 docker logs napcat 拿 Token

第三步：连接 NapCat 和 AstrBot

在 NapCat WebUI 配置 WebSocket 客户端

1. 进入 NapCat 管理面板 → 网络配置 → 新建 → 选 WebSocket 客户端

2. URL 填：ws://宿主机IP:6199/ws（注意末尾要有 /ws，少了这个连不上）

3. 消息格式：Array

4. 心跳间隔：5000

5. 重连间隔：5000

6. Token：随便设一个强密码，后面 AstrBot 那边要填一样的

7. 保存

在 AstrBot WebUI 开启 aiocqhttp 适配器

1. 进入 AstrBot 管理面板 → 消息平台 → 新增适配器

2. 选择「接入 QQ 个人号（aiocqhttp）」

3. 反向 WebSocket 主机地址填：0.0.0.0

4. 端口：6199

5. Token：填和 NapCat 一样的那个密码

6. 保存，然后重启 AstrBot 容器

🎉 大功告成