想要拥有一个属于自己的 QQ 机器人吗？本教程将手把手教你使用 Docker Compose 在 Linux 服务器上快速搭建现代化的 QQ 机器人解决方案。
Koishi 是一个跨平台、可扩展、高性能的聊天机器人框架，拥有丰富的插件生态和直观的 Web 控制台。NapCat 则是新一代的 QQ 协议适配器，稳定性和兼容性都非常出色。
通过本教程，你将学会：
如果你还没有安装 Docker，可以使用以下命令快速安装：
# 一键脚本安装 Docker 和 Docker Compose
sudo bash <(curl -sSL https://linuxmirrors.cn/docker.sh)
首先创建项目目录结构：
mkdir koishi && cd koishi
创建 Docker Compose 配置文件：
将以下内容复制到文件中：
services:
napcat:
container_name: napcat
image: mlikiowa/napcat-docker:latest
restart: always
environment:
- NAPCAT_UID=${NAPCAT_UID:-1000}
- NAPCAT_GID=${NAPCAT_GID:-1000}
- MODE=koishi
ports:
- 6099:6099
volumes:
- ./napcat/config:/app/napcat/config
- ./ntqq:/app/.config/QQ
- ./koishi:/koishi
networks:
- koishi_network
mac_address: "02:42:ac:11:00:02"
koishi:
container_name: koishi
image: koishijs/koishi:latest
restart: always
environment:
- TZ=Asia/Shanghai
ports:
- 5140:5140
volumes:
- ./ntqq:/app/.config/QQ
- ./koishi:/koishi
networks:
- koishi_network
networks:
koishi_network:
driver: bridge
使用以下命令启动服务：
NAPCAT_UID=$(id -u) NAPCAT_GID=$(id -g) docker-compose -f ./compose/koishi.yml up -d
首先配置 NapCat 以连接 QQ：
访问 NapCat WebUI：
QQ 登录配置：
配置 OneBot 适配器：
6099接下来配置 Koishi 连接到 NapCat：
访问 Koishi 控制台：
安装 OneBot 适配器：
adapter-onebot配置适配器：
在 Koishi 控制台的「插件配置」中找到 OneBot 适配器
配置连接参数：
protocol: http
selfId: "你的QQ号"
endpoint: http://napcat:6099
token: "你设置的access_token" # 如果设置了的话
启用适配器：
发送测试消息：
help查看日志：
# 查看 NapCat 日志
docker logs napcat
# 查看 Koishi 日志
docker logs koishi
数据库配置：
插件权限管理：
# 查看服务状态
docker compose -f ./compose/koishi.yml ps
# 查看日志
docker compose -f ./compose/koishi.yml logs
# 停止服务
docker compose -f ./compose/koishi.yml down
# 重启服务
docker compose -f ./compose/koishi.yml restart
NAPCAT_UID 和 NAPCAT_GID 环境变量docker-compose logs 查看详细错误信息sudo systemctl status dockernetstat -tlnp | grep :5140通过以上步骤，你就成功在 Linux 上搭建了 Koishi + NapCat 环境。现在可以开始配置你的 QQ 机器人并安装各种插件来扩展功能了！
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。