Skip to content

NapcatQQ

用于连接QQ与各Bot端 By 清蒸云鸭
2025/11/21

INFO

官方文档: https://napneko.github.io/

Docker一键安装

TIP

安装Docker: 使用LinuxMirros脚本一键安装~

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

在Bot文件夹(例如AstrBot)内新建Compose文件
此编排使用host网络,可直接访问本机项目/端口
如果是AstrBot建议放在AstrBot data文件夹下,并取消``# - ./data:/AstrBot/data`的注释(删除#,并对齐)

Napcat Docker napcat.yml
yml
services:
  napcat:
    environment:
      - NAPCAT_UID=${NAPCAT_UID:-1000}
      - NAPCAT_GID=${NAPCAT_GID:-1000}
      # AstrBot请取消下面的注释以配置默认连接
      # - MODE=astrbot
    container_name: napcat
    restart: always
    image: mlikiowa/napcat-docker:latest
    volumes:
      # AstrBot请取消下面的注释以映射数据文件夹
      # - ./data:/AstrBot/data
      - ./napcat/config:/app/napcat/config
      - ./ntqq:/app/.config/QQ
    network_mode: "host"

完成后使用 docker compose -f napcat.yml up -d
即可自动拉取Napcat镜像,完成后访问 [IP]:6099 即可访问
如果是NAT云服务器,请创建6099的端口映射

Linux安装

以云为翼,栖无界之地,以码为砖,筑万相世界