前言

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

教程部分

通过ssh连接到服务器

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

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

输入y 确定创建连接

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

安装Docker

养成好习惯 先更新软件源

apt update

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

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

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

选着第一个 默认

直接回车 使用默认参数

直接回车 使用默认参数

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

apt install docker-compose -y

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

docker -v
docker-compose -v

运行NapCat

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

mkdir -p /opt/napcat

前往目录

cd /opt/napcat

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

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 保存并退出

然后输入

docker-compose up -d

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

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

docker logs napcat

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

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

登录QQ号

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

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

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

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

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

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

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