6.0 KiB
6.0 KiB
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 生效方式
- 脚本已改 compose 后，打开 Container Manager → 项目。
- 对已有项目：操作 → 重新部署（或停止后再启动），项目名会更新为中文。
- 新项目：从对应目录 创建 → 从 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 |
六、维护命令
# 预览分组（不改文件）
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