上游	状态
Docker Hub `mlikiowa/napcat-docker`	404，镜像已删除，无法拉取
GitHub `NapNeko/NapCat-Docker`	404，仓库已删除
GitHub `NapNeko/NapCatQQ`	仓库仍存在但内容被清空（仓库体积 1KB，12755 stars 未变）
文档站 `napneko.github.io`	仍可访问

已经部署过 NapCat 的机器还能继续跑，但重装、迁移、新机器部署都会因为拉不到镜像而失败。本仓库用于解决这个问题。

镜像信息

项	值
原镜像名	`mlikiowa/napcat-docker:latest`
Image ID	`sha256:045cb917c7d6f0147447eb272902a153f51e8cbdb1dc0e6df270ebd4253b4337`
镜像大小	1.47 GB
镜像构建时间	2026-10-21
构建 commit	`60dc2d72126890a0ae88a36f64000c08b7b8bf7a`
基础镜像	`ubuntu:22.04`
内置 QQ	`linuxqq 3.2.34-53644`（QQNT 9.9.36 beta）
导出时间	2026-11-12

仓库内容

.
├── README.md                      本文件
├── Dockerfile                     依据镜像 docker history 还原的构建文件
├── docker-compose.yml             可直接使用的部署配置（QQ 号已脱敏）
├── entrypoint.sh                  镜像内原始启动脚本（原样提取）
├── templates/                     NapCat OneBot 各框架配置模板（9 个，原样提取）
├── NapCat.Shell.zip               镜像内 NapCat 本体（35MB，构建镜像的关键输入）
└── image/
    └── napcat-docker-latest.tar   完整镜像归档（1.47GB）

使用方法

方式一：直接导入镜像（推荐，最快）

# 下载 image/napcat-docker-latest.tar 后
docker load -i napcat-docker-latest.tar
docker tag mlikiowa/napcat-docker:latest napcat-docker:latest

# 启动
docker run -d --name napcat \
  --restart always \
  -p 6099:6099 \
  -e NAPCAT_UID=1000 -e NAPCAT_GID=1000 -e TZ=Asia/Shanghai \
  -e WEBUI_TOKEN=你的token \
  -v ./docker-config/napcat:/app/napcat/config \
  -v ./data/qq:/app/.config/QQ \
  napcat-docker:latest

方式二：docker-compose

docker compose up -d

docker-compose.yml 里的 ACCOUNT 改成自己的 QQ 号。

方式三：重新构建

仓库包含构建所需的全部输入（NapCat.Shell.zip、entrypoint.sh、templates/），可以直接：

docker build -t napcat-docker:latest .

注意 Dockerfile 里会从腾讯 CDN 下载 linuxqq 3.2.34-53644，该地址目前仍可用；如果失效，需要换成本地 deb 包。

目录说明

容器内路径	用途	是否必须持久化
`/app/napcat/config`	NapCat 配置（onebot11.json、webui.json、napcat.json）	必须，否则重启后配置丢失
`/app/.config/QQ`	QQ 本体登录态	必须，否则每次都要重新扫码
`/app/templates`	各框架配置模板	否，镜像自带

端口

端口	用途
6099	NapCat WebUI（默认 `http://IP:6099/webui`）
3000/3001	OneBot HTTP/WS 服务，需在 `onebot11.json` 中自行配置

完整性校验

sha256sum image/napcat-docker-latest.tar
# 2b0a1f5f59c7057bdf32277d1af1c2a2c985f0954b64d458c87e131f39b43689

免责声明

本仓库仅用于归档与灾备，防止上游删除导致已部署服务无法维护。镜像内容版权归 NapCatQQ 原作者所有。使用时请遵守 QQ 用户协议与当地法律法规。

README.md Unescape Escape

NapCat-Docker 镜像归档

为什么有这个仓库