后续可能会有手机搭建教程，得看我有没有时间写,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内存：4H8G

 

首先，连接系统SSH获得root权限（不用教吧......）

执行以下代码（俩行代码之间的空格请自行删除掉，主题bug删不掉）

curl -o \

napcat.sh \

https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh \

&& bash napcat.sh

选择建议：

[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 (命令行工具)?

建议安装，看你自己，我觉得这个挺好用的

 

安装成功：

目前暂时不启动，请继续往下走

2.安装AstrBot

例如我想将AstrBot安装到/opt文件夹下：cd /opt并运行以下代码即可

 

在此处默认安装在/root文件夹下，无需cd /root，直接执行以下代码：

bash <(curl -sSL https://raw.githubusercontent.com/zhende1113/Antlia/refs/heads/main/Script/AstrBot/Antlia.sh)

如果你的系统没有 curl，你可以使用 wget：

wget -qO- https://raw.githubusercontent.com/zhende1113/Antlia/refs/heads/main/Script/AstrBot/Antlia.sh | bash

如果是国内服务器选1即可，国外的选3即可

安装成功示例：

无宝塔（或不打算安装宝塔）

安装成功后请输入以下代码，直接选择1选项

./astrbot.sh

安装成功后执行以下代码启动Napcat

xvfb-run -a /root/Napcat/opt/QQ/qq --no-sandbox

出现二维码即启动成功，3个红箭头所指的就是随机生成的密码，复制到一旁备用

后面教程需要宝塔面板，并下滑到 napcat设置（用宝塔面板主要就是自启动，命令自启动我懒得查，官方也没自启动的，直接宝塔完事了）

有宝塔

安装成功后请输入以下代码，直接选择2选项

./astrbot.sh

前台运行显示此说明运行正常，请按Ctrl+C结束运行

进入宝塔面板，点击网站→Python项目→Python环境管理→版本管理 安装最新的Python版本

然后点击添加项目,名称AstrBot，Python环境选择你刚刚安装的，启动方式默认，项目路径选择刚刚AstrBot安装的文件夹，启动命令是下面这条，环境变量默认，启动方式root，余下全默认

uv run main.py

确定后100%打不开，因为还缺了依赖，就是因为这破问题那时候折腾我3个小时，服了
点击刚创建的项目，环境管理→普通安装→名称输入uv点击安装即可（安装好后点项目信息，若开机启动未勾选请勾选）

点击服务状态选择开启即可正常运行

后续设置教程请点击前往查看（合在一起太卡了，而且其他部署教程也需要这个设置）

点击前往设置教程

本教程到此为止，886!