如何在Linux部署Napcat+AstrBot的QQ机器人（安装部分）
发表于2026-01-17
更新于2026-01-18
总字数: 1.1k字
阅读时长: 3分钟
访问量: 前言
后续可能会有手机搭建教程，得看我有没有时间写,Napcat和AstrBot配置也适用于其他搭建教程
不会的地方可以进群问，别问出如何输入代码这种脑残问题即可
免责声明：该教程仅作于教学，一切后果作者概不负责
Napcat官网：
AstrBot官网：
准备材料
必要！！！没有的请把条件符合了再搞
1.系统要求：Ubuntu 20+/Debian 10+/Centos9
2.服务器要求:最低2H2g，1H1G理论能运行，但AstrBot就能占用掉一个G，所以最低2H2G，最好4H8G
3.推荐一个注册3个月以上还比较活跃的小号QQ，最低限制一个月，新注册的特别容易被风控
4.聪明的大脑
5.灵活的双手
可选！！！可选！！！不是必选！！！
1.宝塔面板（1Panel也行，但我不熟悉，不会）
2.域名（用来外面访问Napcat和AstrBot的WebUi界面，云服务器可要可不要，我不想记IP，所以我配置了域名）
在此处就不说如何用域名访问了，网上搜：如何用宝塔面板进行反向代理
教程开始
本教程演示机子配置为
系统：Ubuntu 24.04LTS
CPU：Intel
内存：8GB
首先，连接系统SSH获得root权限（不用教吧……）
Napcat安装
执行以下代码
1 | curl -o \ |
选择建议：
[2025-10-30 09:26:28]: 选择安装方式: Docker (容器化) 或 Shell (直接安装)?
[2025-10-30 09:26:28]: 输入 ‘y’ 使用 Docker, 输入 ‘n’ 使用 Shell。
[y/N] (10秒后默认 N):
萌新直接选择Y
建议Shell直接安装，我不太建议使用Docker安装，除非多账号，所以建议直接安装，避免有太多奇奇怪怪的问题，我用Docker遇到过挺多奇奇怪怪的问题的
[2025-10-30 09:26:36]: 是否安装 NapCat TUI-CLI (命令行工具)?
建议安装，看你自己，我觉得这个挺好用的
安装成功：
目前暂时不启动，请继续往下走
安装AstrBot
安装
例如我想将AstrBot安装到/opt文件夹下：cd /opt并运行以下代码即可
在此处默认安装在/root文件夹下，无需cd /root，直接执行以下代码：
1 | bash <(curl -sSL https://raw.githubusercontent.com/zhende1113/Antlia/refs/heads/main/Script/AstrBot/Antlia.sh) |
如果你的系统没有curl，你可以使用wget：
1 | wget -qO- https://raw.githubusercontent.com/zhende1113/Antlia/refs/heads/main/Script/AstrBot/Antlia.sh | bash |
如果是国内服务器选1即可，国外的选3即可
安装成功示例：
无宝塔启动
安装成功后请输入以下代码，直接选择1选项
1 | ./astrbot.sh |
安装成功后执行以下代码启动Napcat
1 | xvfb-run -a /root/Napcat/opt/QQ/qq --no-sandbox |
接下来前往设置教程：
有宝塔启动
安装成功后请输入以下代码，直接选择2选项
1 | ./astrbot.sh |
前台运行显示此说明运行正常，请按Ctrl+C结束运行
进入宝塔面板，点击网站→Python项目→Python环境管理→版本管理 安装最新的Python版本
然后点击添加项目,名称AstrBot，Python环境选择你刚刚安装的，启动方式默认，项目路径选择刚刚AstrBot安装的文件夹，启动命令是下面这条，环境变量默认，启动方式root，余下全默认
1 | uv run main.py |
确定后100%打不开，因为还缺了依赖，就是因为这破问题那时候折腾我3个小时，服了
点击刚创建的项目，环境管理→普通安装→名称输入uv点击安装即可（安装好后点项目信息，若开机启动未勾选请勾选）
点击服务状态选择开启即可正常运行
后续设置教程请点击前往查看（合在一起太卡了，而且其他部署教程也需要这个设置）
本教程到此为止，886!
微信
支付宝