修改下列命令使用

docker run -d \
-e ACCOUNT="机器人qq" \
-e NAPCAT_GID=0 \
-e NAPCAT_UID=0 \
-e MESSAGE_POST_FORMAT="string" \
-e WSR_ENABLE=true \
-e WS_URLS='["ws://自己的ws ip加端口/适配器路径"]' \ 
-p 6099:6099 \
-v /自己的目录只改这前面/QQ:/app/.config/QQ \
-v /自己的目录只改这前面/config:/app/napcat/config \
-v /自己的目录只改这前面/logs:/app/napcat/logs \
--name napcat \
mlikiowa/napcat-docker:latest

参数解释

  • -d:以分离模式运行容器(即在后台运行)。

  • -e:设置环境变量,这些变量将传递给容器内的应用程序。

  • ACCOUNT:设置账户信息。填写自己的机器人QQ

  • NAPCAT_GID 和 NAPCAT_UID:设置容器内的用户和组 ID。

  • MESSAGE_POST_FORMAT:设置消息的格式。

  • WSR_ENABLE:启用 WebSocket 连接。

  • WS_URLS:指定 WebSocket 服务器的 URL。填写自己框架的ws地址

  • -p 6099:6099:将主机的 6099 端口映射到容器的 6099 端口。

  • -v:挂载卷,将主机的目录映射到容器内的指定路径。

  • /opt/apps/napcat/QQ:用于 QQ 配置。

  • /opt/apps/napcat/config:用于 Napcat 配置。

  • /opt/apps/napcat/logs:用于存放日志文件。

  • --name napcat:指定容器的名称。

  • mlikiowa/napcat-docker:latest:要使用的 Docker 镜像。

注意事项

  1. 端口冲突:确保主机的 6099 端口没有被其他服务占用。如果已经被占用,您可以选择另一个可用的端口。
  2. 文件夹权限:确保您挂载的目录(如 /opt/apps/napcat/QQ/opt/apps/napcat/config/opt/apps/napcat/logs)具有适当的权限,以便容器能够读写这些目录。
  3. 环境变量的正确性:确保所有传递的环境变量(如 ACCOUNTWS_URLS)都是正确的并符合您的需求。

登陆基础配置介绍

下文所指的 NapCat 的目录为 ${QQ 安装目录}/resource/app/app_launcher/napcat,对于 ${QQ 安装目录},Linux 一般在 /opt/QQ;Windows 一般在 <系统盘>:\Program Files\Tencent\QQNT

用 WebUI 配置扫码登陆 【浏览器】

  1. 如果你已经启动了 NapCat,并且有多于 1 个开放端口,则可以通过 WebUI 进行配置。
  2. 默认地址为 0.0.0.0,即监听所有地址。当配置了不可用的地址时 WebUI 将被禁用。
  3. 默认端口为 6099。当端口被设置为 0 时将禁用 WebUI。当端口被占用时,会自动对端口 +1,直到找到可用端口(最多尝试100次,失败则会禁用 WebUI),端口号会在启动日志中显示。
    启动后可在启动日志中看到形如 [WebUi] Login Token is xxxx 的token信息,亦可打开 NapCat 的config 目录下的我们挂载目录就是文章一开始让大家创建的目录内就会生成一个webui.json的文件,我们可以在里面修改token,方便我们自己好记

{
    "host": "0.0.0.0", // WebUI 监听地址
    "port": 6099, // WebUI 端口
    "prefix": "", // WebUI 工作前缀,此项功能将在进阶配置中解释
    "token": "xxxx", //登录密钥,默认是自动生成的随机登录密码
    "loginRate": 3, //每分钟登录次数限制
}

配置完成后,点击保存,重启即可生效。

浏览器访问 `http://$host:$port$prefix/webui,然后进行以下操作:

改好后我们就可以利用公网或者穿透,直接在外面就可以更改配置,记得端口噢!尾巴要带webui才可。比如:http://你的ip:6099/webui,记得在地址后面加 /webui 接着输入你上面设定的token,或者他自带的token,就能访问了。

这里我没挂载webui.json目录有点长

配置完成后,点击保存,即可生效。。

dokcer容器编排

简单易懂 新建文件命名为docker-compose.yml
然后把ACCOUNT= 后面改成你botQQ就可以了

version: '3.8'
services:
  napcat:
    image: mlikiowa/napcat-docker:latest
    container_name: napcat
    network_mode: "bridge"
    environment:
      - ACCOUNT=
      - WS_ENABLE=true
      - NAPCAT_GID=0
      - NAPCAT_UID=0
    ports:
      - "6099:6099"
    volumes:
      - ./bot/QQ:/app/.config/QQ
      - ./bot/config:/app/napcat/config
      - ./bot/logs:/app/napcat/logs 
    restart: always

然后执行

docker-compose up -d

仓库地址|官方文档