113 lines
3.9 KiB
Markdown
113 lines
3.9 KiB
Markdown
# 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
|