基于 Docker 部署 AstrBot+NapCat 打造 QQ 智能客服
环境准备与基础概念
在开始部署之前，我们需要先了解几个核心组件及其相互关系。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
一键部署流程
快速启动服务
通过以下命令可以一键部署完整的 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
这个命令会执行以下操作：
- 创建项目目录
- 下载官方提供的 docker-compose 配置文件
- 启动两个容器服务：
- NapCat：QQ 机器人中间件
- AstrBot：核心业务逻辑处理
部署完成后，建议检查容器状态确保服务正常拉起。如果遇到问题，通常可以通过 docker logs 查看具体报错信息。配置文件中包含了必要的环境变量映射，首次运行时会自动拉取所需镜像，耐心等待即可。
后续可根据实际需求修改配置文件中的 API Key 或模型参数，实现更个性化的交互体验。
