搭建帮助-NapCat

lsla大约 4 分钟搭建方法非常简单

NapCatQQ 是现代化的、基于 NTQQ 的 Bot 协议端实现（天生无头、内存占用小），同样是「协议端」，要连上 TRSS（Yunzai）才能收发消息。官网与文档：napneko.github.io。

说明

本篇只讲「装好 NapCat + 连上 TRSS」，TRSS 本身的搭建见搭建帮助-win、搭建帮助-linux。

1.安装 NapCat

Windows 一键版（最省事，推荐）

一键包只适用于 Windows AMD64，内置 QQ 和 NapCat，不用自己装 QQ。

前往 NapCatQQ Releases 下载 NapCat.Shell.Windows.OneKey.zip
解压后运行 NapCatInstaller.exe，等它自动配置完成
进入生成的 NapCat.XXXX.Shell 目录，双击 napcat.bat 启动

想免扫码快速启动，可以新建一个 bat：

NapCatWinBootMain.exe 10001

（把 10001 换成你的 QQ 号）

Windows 手动版

前往 Releases 下载 NapCat.Shell.zip 并解压
确保本机 QQ 已安装且是最新版本
双击目录里的 launcher.bat 启动（Win10 用 launcher-win10.bat）

需要快速登录就把 QQ 号当参数传进去：

launcher.bat 123456

Linux 服务器（一键脚本）

支持 Ubuntu 20+ / Debian 10+ / CentOS 9：

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

常用参数：

# 可视化交互安装（不确定选什么就用这个）
bash napcat.sh --tui

# 不用 Docker，并顺便装 TUI-CLI（无桌面环境时很有用）
bash napcat.sh --docker n --cli y

# 强制重装 / 指定下载代理
bash napcat.sh --docker n --cli n --proxy 0 --force

提醒

想用 Docker 部署可以看 NapCat-Docker（支持 compose 一键模板）；群晖 DSM 部署遇到 permission denied，需要去 File Station 给挂载目录加 Everyone 读写权限
macOS / 安卓 Termux / 宝塔 / 1Panel 等其它方式见官方 Shell 安装页

2.登录 QQ 并打开 WebUI

启动后终端会打印 WebUI 地址和 token，形如：

[NapCat] [WebUi] WebUi User Panel Url: http://127.0.0.1:6099/webui?token=xxxxx

浏览器打开 http://ip:6099/webui/（默认端口 6099，被占用会自动 +1 并打印在日志里）
找不到 token 就打开 webui.json 看（Linux 一键脚本装的话在 /opt/QQ/resources/app/app_launcher/napcat/config/webui.json）
进 WebUI → QQ 登录 → 点 QRCode 扫码；登录后 token 会刷新，去手机端「自己的消息」或控制台看新的 token
再次进入会强制要求修改密码（不改会禁用大部分功能）

3.新建反向 WS（连 TRSS 的关键一步）

TRSS 这一侧已经在 2536 端口提供了 OneBot v11 的 WS 服务端，所以 NapCat 这边要建一个 反向 WS（在 NapCat 里叫「WebSocket 客户端」）：

WebUI → 网络配置 → 新建
类型选 WebSocket 客户端（就是反向 WS）
URL 填：

ws://ip:2536/OneBotv11

勾选「保存时启用」（或保存后手动启用）

提醒

ip 填 TRSS 所在机器的地址：同一台机器写 127.0.0.1，不同机器写 TRSS 的内网/公网 IP，例如 ws://192.168.1.10:2536/OneBotv11
端口和路径以 TRSS 启动时打印的为准，默认 2536 + /OneBotv11
公网部署务必设置 token（和 TRSS 的鉴权保持一致），否则等于把 QQ 交出去

也可以直接改配置文件

不习惯用 WebUI 的话，编辑 config/onebot11_你的QQ号.json，在 network.websocketClients 里加一项：

{
  "network": {
    "httpServers": [],
    "httpClients": [],
    "websocketServers": [],
    "websocketClients": [
      {
        "name": "TRSS",
        "enable": true,
        "url": "ws://127.0.0.1:2536/OneBotv11",
        "messagePostFormat": "array",
        "reportSelfMessage": false,
        "reconnectInterval": 5000,
        "token": "",
        "debug": false,
        "heartInterval": 30000
      }
    ]
  }
}

如果安装时选了 TUI-CLI，也可以在终端里敲 sudo napcat 进入命令行界面配置。

4.确认连上 TRSS

TRSS 启动完成后会打印一行连接地址：

连接地址：ws://localhost:2536/[GSUIDCore,OPQBot,ComWeChat,OneBotv11]

方括号里是支持的协议路径，接 OneBot v11 就取 ws://localhost:2536/OneBotv11 这一段填给 NapCat。反向 WS 建好并启用后：

NapCat 的「网络配置」里该连接会显示已连接
TRSS 那边会显示 OneBotv11 连接就绪，群里 @ 机器人发个 #帮助 有回应就算通了

如果 TRSS 开了鉴权（config/config/server.yaml 里的 auth.Authorization），要把那个 token 填到 NapCat 反向 WS 的 token 里（TRSS 默认不启用鉴权）。

5.连不上怎么办

先确认 TRSS 已经启动、2536 端口在监听（ss -lntp | grep 2536）
确认 NapCat 那台机器能 ping 通 TRSS 的 IP，端口没被防火墙 / 安全组挡掉
连接报 403：token 不一致，NapCat 里填的 token 要和 TRSS server.yaml 里的 Bearer xxx 一样
消息发出去没反应：messagePostFormat 用 array，并确认 TRSS 装了对应插件
改配置文件不要写注释（v4.4.7 以下会直接解析失败）
更多问题见 NapCat 官方文档