# NapCat-Docker 镜像归档

> 上游仓库与 Docker 镜像**均已删除**。本仓库是 39 服现存镜像的完整备份，可能是目前唯一可获取的副本。

## 为什么有这个仓库

NapCatQQ 是 QQ 机器人协议端框架（猫猫框架）。2026-11 期间上游内容被清空，现状如下（2026-11-12 实测）：

| 上游 | 状态 |
|---|---|
| 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）
```

## 使用方法

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

```bash
# 下载 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

```bash
docker compose up -d
```

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

### 方式三：重新构建

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

```bash
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` 中自行配置 |

## 完整性校验

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

## 免责声明

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

## 相关

- 文档站：https://napneko.github.io/guide/napcat
- 源码仓库（内容已被清空）：https://github.com/NapNeko/NapCatQQ