NapCat-Docker

Docker Hub · Linux amd64 / arm64

启动

保存为 compose.yaml，修改 WEBUI_TOKEN：

services:
  napcat:
    image: mlikiowa/napcat-docker:latest
    restart: unless-stopped
    environment:
      MODE: ws
      WEBUI_TOKEN: replace-with-your-own-token
    ports:
      - "127.0.0.1:6099:6099"
      - "127.0.0.1:3001:3001"
    volumes:
      - ./data/qq:/app/.config/QQ
      - ./data/config:/app/napcat/config
      - ./data/plugins:/app/napcat/plugins

docker compose up -d
docker compose logs -f napcat

打开 http://127.0.0.1:6099/webui 登录。远程访问需调整端口绑定地址或使用 SSH 转发。

配置与更新

• MODE=ws 启用正向 WebSocket；反向连接使用 reverse_ws / reverse_http，并设置 ONEBOT_URL。
• WEBUI_TOKEN、MODE 仅初始化缺失的配置。已有部署在 WebUI 中修改。
• NAPCAT_UID、NAPCAT_GID 指定运行用户，挂载目录需允许该用户读写；群晖还需设置共享目录 ACL。
• 更新执行 docker compose pull && docker compose up -d，保留三个数据目录。固定版本时将 latest 换成发布标签。
• 镜像拉取的代理需配置在 Docker daemon 中。
• 需要调试 core dump 时设置 NAPCAT_ENABLE_COREDUMP=1。

机器人框架模板

AstrBot · Koishi · qq-ai-bot · WebSocket