基于 Termux 在安卓手机部署 AstrBot 及 NapCat 搭建 QQ 机器人
前置准备
需要一台安卓手机(旧机型即可)、一个 QQ 号(用于扫码登录)。
一、环境搭建
1. 安装 Termux
请从 F-Droid 下载 Termux,Google Play 版本可能过时。部分国内应用商店也可找到,但需确认版本较新。
2. 初始化与权限
打开 Termux,执行以下命令更新源并安装基础工具:
pkg update && pkg upgrade && pkg install python git wget curl
如需更换镜像源以获得更稳定的连接,可运行 termux-change-repo,选择中国大陆镜像组。
接着申请存储权限,按提示允许文件访问:
termux-setup-storage
二、部署 AstrBot
1. 安装 Ubuntu 环境
由于 AstrBot 依赖较多,建议在 Termux 内通过 proot-distro 运行 Ubuntu 容器。
pkg install uv git proot-distro
proot-distro install ubuntu
proot-distro login ubuntu
2. 配置 Python 环境
AstrBot 推荐使用 Python 3.10。Ubuntu 默认源中可能不包含该版本,需添加第三方 PPA:
apt update && apt install software-properties-common
add-apt-repository ppa:deadsnakes/ppa && apt update
apt install python3.10
3. 拉取并运行项目
确保当前路径为根目录,克隆仓库:
git clone https://github.com/AstrBotDevs/AstrBot.git && cd AstrBot
若遇到网络问题导致 git clone 失败,请检查代理设置或稍后重试。
启动 AstrBot:
uv run main.py
若下载包速度慢,可切换清华源:
export UV_DEFAULT_INDEX="https://pypi.tuna.tsinghua.edu.cn/simple"
启动成功后,终端会显示 WebUI 访问地址(如 localhost:6185),默认账号密码均为 astrbot。
三、部署 NapCat
1. 一键脚本安装
退出 Ubuntu 环境(输入 exit),回到 Termux 主界面,运行以下脚本:
curl -o napcat.termux.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.termux.sh && bash napcat.termux.sh
脚本执行完毕后,根据日志获取 WebUI 链接。
2. Docker 部署备选
若使用 Docker 部署,将无法接收语音和文件数据,仅支持文本和图片。


