使用NapCat搭建QQ机器人/群服互通

以 Debian 12 作为演示你将会当做一个没有任何 Linux 基础的纯小白教你搭建 NatCat

教程部分

通过 ssh 连接到服务器

首先你需要有一台 VPS/虚拟机用来运行 NapCat 程序通过 ssh 连接到 VPS/虚拟机

如果你不知道怎么通过 ssh 连接请在应用商店/浏览器搜索 ssh 客户端
Windows 用户可直接使用ssh root@ip进行连接如下图

输入y 确定创建连接

输入yes 然后输入你的 root 账户密码完成连接

安装 Docker

养成好习惯先更新软件源

1	apt update

等待完成后使用脚本安装 Docker
(你也可以使用其他的方式本教程面向纯小白中国大陆可能遇到连通性问题所以不使用官方安装方式)

1	bash <(curl -sSL https://linuxmirrors.cn/docker.sh)

输入上方命令回车执行后选择第一个阿里云 (通过上下键选择)c

选着第一个默认

直接回车使用默认参数

脚本中没有附带安装 Docker-compose 手动通过 apt 安装

1	apt install docker-compose -y

安装完成后检查一下 docker 和 docker-compose 版本

1 2	docker -v docker-compose -v

运行 NapCat

找一个你喜欢记得住的目录来存储 NapCat 数据我喜欢存储在/opt 所以以/opt/napcat为例
创建目录

1	mkdir -p /opt/napcat

前往目录

1	cd /opt/napcat

编辑 Docker-compose 文件我喜欢使用vim作为编辑器你也可以使用其他的(如果你没有电脑这一步操作会很麻烦建议使用宝塔 1pane 等 Web 面板编辑)

1	vim docker-compose.yml

输入 i 进入编辑模式
粘贴以下内容

version: "3"
services:
  napcat:
    environment:
      - NAPCAT_UID=${NAPCAT_UID}
      - NAPCAT_GID=${NAPCAT_GID}
    ports:
      - 3000:3000
      - 3001:3001
      - 6099:6099
    container_name: napcat
    network_mode: bridge
    restart: always
    image: mlikiowa/napcat-docker:latest
    volumes:
      - ./napcat/config:/app/napcat/config
      - ./ntqq:/app/.config/QQ

默认会使用 3000 3001 6099 端口
如果你想修改端口例如将 3000 修改为 3999 只需要修改第一个 3000 如下

ports:
  - 3999:3000
  - 3001:3001
  - 6099:6099

编辑完成后按ESC键(键盘左上角) 然后输入 :wq 保存并退出

然后输入

1	docker-compose up -d

耐心等待镜像拉取和容器创建这取决于你的网络环境和设备

完成后使用 docker logs 命令查看容器日志获取 Webui 访问路径
因上面使用 docker compose 部署已经指定了容器名为napcat 所以可以直接使用下方命令来获取日志

1	docker logs napcat

会看到这样的信息其中WebUi Local Panel Url就是我们需要的信息

复制链接在浏览器访问因使用 Docker 部署所以我们需要将127.0.0.1替换为真实 ip 一般为你 ssh 连接的 ip
如无法访问请检查服务器安全组等 Debian12 无内置防火墙理论上不会是系统原因导致

登录 QQ 号

用浏览器访问链接(记得替换 ip)

选择扫描登录使用你的手机扫描(不要截图相册识别你需要有两台设备)

登录成功后就会看到如下页面

点击左侧网络配置 点击新增

选择倒数第二个Websocket服务端 (是服务端不是客户端啊!!!

开启启用 名称任意如你的 ws 服务部署在公网通过公网连接务必设置 token 否者所有人都可以用你的 ws 且无需鉴权

好了现在你成功的搭建了自己的 ws 服务