手机部署 NapCat 教程

在安卓手机上部署 NapCat,可通过 Termux 或 ZeroTermux 搭建 Linux 环境,实现 QQ 协议接入并与 AstrBot 等机器人框架联动。

1. 安装 Termux

F-Droid 下载最新版(Google Play 版本已停止维护)。

2. 初始化环境

pkg update && pkg upgrade -y
pkg install git wget curl proot-distro -y

3. 申请权限

termux-setup-storage

4. 安装 NapCat

curl -o napcat.termux.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.termux.sh && bash napcat.termux.sh

5. 配置与启动

前台启动

proot-distro sh napcat -- bash -c "xvfb-run -a /root/Napcat/opt/QQ/qq --no-sandbox"

后台启动

screen -dmS napcat bash -c 'proot-distro sh napcat -- bash -c "xvfb-run -a /root/Napcat/opt/QQ/qq --no-sandbox"'

web控制台地址

http://127.0.0.1:6099

启动后在日志中找到 WebUI 密匙,浏览器访问并完成 QQ 扫码登录。

  • 后台保活:保持 Termux/ZeroTermux 后台运行,上面的命令可能地址不一样不能用,自行更改地址
  • 风控规避:合理控制消息频率以避免风控