NapCat-Docker
Go to file
2025-11-12 12:26:51 +08:00
.github/workflows fix 2025-07-22 08:35:32 +08:00
base 使用 NativePacketClient 作为后端 2024-11-05 22:51:59 +08:00
compose Improve astrbot template OOBE. 2025-09-08 21:13:27 +08:00
templates/templates update templates 2025-05-23 19:46:11 +08:00
Dockerfile Update Dockerfile 2025-10-30 13:01:36 +08:00
entrypoint.sh Update entrypoint.sh 2025-11-12 12:26:51 +08:00
get_artifacts.sh packet-server start with python 2024-10-22 23:35:05 +08:00
README.md Update README.md 2025-08-08 16:02:12 +08:00

NapCat-Docker

DockerHub

Support Platform/Arch

  • Linux/Amd64
  • Linux/Arm64

启动容器

获取日志/查看Token

docker logs 容器名

示例 docker logs napcat 默认登录Token napcat

命令行运行

docker run -d \
-e NAPCAT_GID=$(id -g) \
-e NAPCAT_UID=$(id -u) \
-p 3000:3000 \
-p 3001:3001 \
-p 6099:6099 \
--name napcat \
--restart=always \
mlikiowa/napcat-docker:latest
ps在win下部署 以上代码docker萌新小白可能会直接复制粘贴导致报错提交一个可以直接复制粘贴用的
 按照astrbot默认端口建议6199所以新加了个6199那个uid还没搞清楚是什么
docker run -d -p 6099:6099  -p 3001:3001 -p 6199:6199 --name napcat --restart=always mlikiowa/napcat-docker:latest

docker-compose 运行

创建 docker-compose.yml 文件

# docker-compose.yml
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

使用 NAPCAT_UID=$(id -u) NAPCAT_GID=$(id -g) docker-compose up -d 运行到后台

固化路径,方便下次直接快速登录

QQ 持久化数据路径:/app/.config/QQ

NapCat 配置文件路径: /app/napcat/config

登录

登录 WebUI 地址http://<宿主机ip>:6099/webui

Tips

关于 NAPCAT_UID 与 NAPCAT_GID 环境变量

前往了解

一键模板化配置

AstrBot Compose模板

Koishi Compose模板

WebsockServer Compose模板

欢迎Pr.此方案快速填充NapCat侧配置,你只需要配置应用侧,注意当你不需要WebUi或者处于公网环境,请注意6099端口和WebUi默认密码。