# CKBNAS · Docker 容器分组登记册

> **用途**：公司 NAS（CKBNAS）Container Manager 内所有 Docker 项目的**中文分组真源**——分组规则、项目清单、DSM 显示名、与本机 Mac「datacenter / website」约定的对应关系。  
> **维护**：金仓 · 群晖 NAS 管理 | **2026-06-01**  
> **关联**：`CKBNAS_公司NAS登记册.md` · `运营中枢/工作台/唯一MongoDB约定.md` · `scripts/ckbnas_docker_groups.json`

---

## 一、解决方案说明

### 1.1 问题

- `/volume1/docker/` 下 **20+ 独立 compose**，Container Manager 默认显示**英文目录名**，难以一眼区分用途。
- 与本机 Mac 已有 **datacenter / website** 分组约定不一致，Agent 易选错栈。

### 1.2 做法（已落地）

| 层 | 内容 |
|:---|:-----|
| **compose 项目名** | 每个 `docker-compose.yml` 增加 `name: {序号}-{分组中文}-{简称}`，DSM 列表按序号排序、显示中文 |
| **机器可读** | `scripts/ckbnas_docker_groups.json` |
| **批量写入** | `python3 scripts/apply_ckbnas_docker_groups.py --apply` |
| **登记册** | 本文件（人读） |

### 1.3 DSM 生效方式

1. 脚本已改 compose 后，打开 **Container Manager → 项目**。  
2. 对已有项目：**操作 → 重新部署**（或停止后再启动），项目名会更新为中文。  
3. 新项目：从对应目录 **创建 → 从 compose 创建**，自动带中文 `name:`。

> **注意**：只改 `name:` **不会**移动数据卷；`.bak.group` 为同目录备份。

---

## 二、分组一览（9 组）

| 序号 | 分组中文 | 用途 | 典型端口 |
|:----:|:---------|:-----|:---------|
| **01** | **数据中心** | MongoDB、Qdrant、底座合集 | 27017、6333 |
| **02** | **卡若AI** | Gateway、Executor、部署栈 | 8080、8081 |
| **03** | **AI推理** | Ollama | 11434 |
| **04** | **代码仓库** | Gitea、Git | 3000 |
| **05** | **业务网站** | 官网、Soul、工作手机、银掌柜 | 3100 等 |
| **06** | **网络穿透** | frpc（外网 open.quwanzhi.com） | — |
| **07** | **远程桌面** | Win/Mac VM、VNC、noVNC | 8006、8007 |
| **08** | **运维备份** | 宝塔、腾讯云库镜像 | 8888 等 |
| **09** | **模拟实验** | Android 模拟器 | 6080 |

---

## 三、项目清单（Container Manager 显示名）

| 显示名（name） | 目录 | 分组 | 说明 |
|:---------------|:-----|:-----|:-----|
| `01-数据中心-mongodb` | `/volume1/docker/mongodb` | 数据中心 | 独立 MongoDB 栈 |
| `01-数据中心-qdrant` | `/volume1/docker/qdrant` | 数据中心 | 向量库 |
| `01-数据中心-底座合集` | `/volume1/docker/docker-compose.yml` | 数据中心 | 含 Mongo/Qdrant/RustDesk/MeshCentral/调度器（历史合集，与独立栈勿重复起） |
| `02-卡若AI-网关栈` | `/volume1/docker/karuo-ai` | 卡若AI | gateway / executor / nginx 等 |
| `02-卡若AI-部署` | `/volume1/docker/karuo-ai-deploy` | 卡若AI | 部署用 |
| `02-卡若AI-独立frpc` | `/volume1/docker/frpc-karuo-ai` | 卡若AI | **已废弃**，仅 pkill，勿启 |
| `03-AI推理-ollama` | `/volume1/docker/ollama` | AI推理 | 千问等本地模型 |
| `04-代码仓库-gitea` | `/volume1/docker/gitea` | 代码仓库 | CKB Git |
| `04-代码仓库-git` | `/volume1/docker/git` | 代码仓库 | 裸 Git |
| `05-业务网站-官网` | `/volume1/docker/karuo-site` | 业务网站 | 卡若官网 |
| `05-业务网站-soul` | `/volume1/docker/soul-book` | 业务网站 | Soul 创业实验 |
| `05-业务网站-银掌柜` | `/volume1/docker/yinzhanggu-web` | 业务网站 | 银掌柜 Web |
| `05-业务网站-工作手机` | `/volume1/docker/workphone-sdk` | 业务网站 | 工作手机 SDK + 站 |
| `05-业务网站-丸电竞` | `/volume1/docker/wandj` | 业务网站 | 玩值电竞 + BUDDY 获客 + 老坑爹/老油条网关（3 容器） |
| `06-网络穿透-frpc` | `/volume1/docker/frpc` | 网络穿透 | compose 版；**生产以** `~/frp-standalone/frpc` **为准** |
| `07-远程桌面-*` | `windows-vm` / `macos-vm` / `*-vnc` / `novnc*` | 远程桌面 | 按需启动 |
| `08-运维备份-宝塔` | `/volume1/docker/baota` | 运维备份 | 若有 compose |
| `08-运维备份-腾讯云同步` | `/volume1/docker/tencent_cloud` | 运维备份 | 云库同步 |
| `09-模拟实验-android` | `/volume1/docker/android` | 模拟实验 | 兼容性待验证 |

---

## 四、与本机 Mac 分组对照

| 本机（卡若AI 约定） | NAS CKBNAS | 说明 |
|:--------------------|:-----------|:-----|
| **datacenter** | **01-数据中心-*** | NAS 上 Mongo/Qdrant 为生产实例（27017/6333） |
| **website** | **05-业务网站-*** | 官网、Soul 等 |
| **卡若AI 网关** | **02-卡若AI-*** | NAS 侧 Gateway/Executor |
| **frp / 工具** | **06-网络穿透**、**08-运维备份** | 外网入口见 `CKBNAS_公司NAS登记册.md` |

**强制**：NAS 上**不要再新建第二个 MongoDB 容器**（与 `唯一MongoDB约定.md` 精神一致；NAS 实例即 `mongodb` / `mongodb_nas`）。

---

## 五、常见问题（防错）

| 现象 | 原因 | 处理 |
|:-----|:-----|:-----|
| Container Manager 仍显示英文名 | compose 改完后**未重新部署** | 项目 → 重新部署 |
| 两个 MongoDB 同时跑 | 根目录「底座合集」与 `mongodb/` 独立栈重复 | 只保留**实际在用的一个**，停另一个 |
| frpc 双连接 | `frpc-karuo-ai` 与主 frpc 同时启 | 只保留 `~/frp-standalone/start-frpc-main.sh` |
| 改分组后容器消失 | 项目名变了，DSM 当新项目 | 用 `.bak.group` 回滚 compose |

---

## 六、维护命令

```bash
# 预览分组（不改文件）
python3 群晖NAS管理/scripts/apply_ckbnas_docker_groups.py

# 写入 NAS（默认 110.101）
python3 群晖NAS管理/scripts/apply_ckbnas_docker_groups.py --apply

# 公司网段
python3 群晖NAS管理/scripts/apply_ckbnas_docker_groups.py --apply --host 192.168.1.201
```

新增 Docker 项目时：编辑 `ckbnas_docker_groups.json` → 再跑 `--apply`。

---

## 七、触发词

**NAS Docker 分组、容器中文名、Container Manager 分类、CKBNAS compose 分组** → 读本文件 + 跑 `apply_ckbnas_docker_groups.py`。

---

*版本 v1.0 | 2026-06-01*