5分钟搞定！用Docker快速部署AstrBot+NapCat打造QQ智能客服机器人（附常见问题解决）

优质文章学习记录

— 1 min read

5分钟极速部署：基于Docker的AstrBot+NapCat智能QQ机器人实战指南

1. 环境准备与基础概念

在开始部署之前，我们需要先了解几个核心组件及其相互关系。AstrBot是一个支持多平台的多功能聊天机器人框架，而NapCat则是专门为QQ设计的机器人中间件。两者结合可以快速搭建一个具备大语言模型能力的QQ智能客服系统。

必备环境清单：

  • Docker Engine 20.10.0或更高版本
  • Docker Compose 2.0.0或更高版本
  • 至少4GB可用内存
  • 一个可用于机器人的QQ账号（建议使用小号）
注意：QQ账号需要已经完成设备锁验证，否则可能无法正常登录

对于Windows用户，建议使用WSL2来运行Docker。以下是WSL2的快速安装命令（以管理员身份运行PowerShell）：

wsl --install -d Ubuntu

2. 一键部署流程

2.1 快速启动服务

通过以下命令可以一键部署完整的AstrBot+NapCat环境：

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

这个命令会：

  1. 创建项目目录
  2. 下载官方提供的docker-compose配置文件
  3. 启动两个容器服务：
    • NapCat：QQ机器人中间件</
Could not load content