# CKBNAS · 本机 Docker 远程快捷方式

> **你要的效果**：Mac 上像快捷方式一样查看/管理公司 NAS 上的 Docker；**容器仍在 NAS 跑**，本机不复制一份。
> **维护**：金仓 · 群晖 NAS 管理 | **2026-06-04**

---

## 一、原理（3 层）

| 层 | 做什么 | 类比 |
|:---|:---|:---|
| **Docker Context** | `docker --context ckbnas-home ps` 直连 NAS 守护进程 | Docker Desktop 里切换「远程引擎」 |
| **Finder 快捷方式** | `~/CKBNAS-Docker快捷方式/` 下按 9 组放的 `.webloc` | 浏览器书签 / 桌面快捷方式 |
| **状态脚本** | `dk-nas-status` 按分组打印运行中/已停 | 只看状态、不搬家 |

---

## 二、一键配置

```bash
bash "/Users/karuo/Documents/个人/卡若AI/01_卡资（金）/金仓_存储备份/群晖NAS管理/scripts/setup_ckbnas_docker_remote_mac.sh"
```

完成后：

| 入口 | 路径/命令 |
|:---|:---|
| **Finder 分组链接** | `~/CKBNAS-Docker快捷方式/`（桌面有同名替身） |
| **Docker Desktop** | 右上角 context → `ckbnas-home` 或 `ckbnas-company` |
| **终端别名** | `dk-nas-home` · `dk-nas-company` · `dk-nas-status` |

---

## 三、9 组归类（与 NAS Container Manager 一致）

与 `CKBNAS_Docker容器分组登记册.md` / `ckbnas_docker_groups.json` 同步：

01 数据中心 · 02 卡若AI · 03 AI推理 · 04 代码仓库 · 05 业务网站 · 06 网络穿透 · 07 远程桌面 · 08 运维备份 · 09 模拟实验

---

## 四、网络与 context 对照

| 场景 | NAS IP | SSH | Docker context |
|:---|:---|:---|:---|
| **家里 110 网段** | 192.168.110.101 | `ssh ckbnas-home` | `ckbnas-home` |
| **公司 1.x 网段** | 192.168.1.201 | `ssh ckbnas-company` | `ckbnas-company` |
| **外网 frp** | open.quwanzhi.com:5200 | `ssh -p 22201 fnvtk@open.quwanzhi.com` | 建议用 DSM 网页，context 需额外 SSH 隧道 |

脚本会自动 `nc` 探测 5000 端口，优先配置可达的 profile。

---

## 五、docker context 连不上时

1. **NAS 上** `fnvtk` 需能执行 docker（已配置 `docker-fnvtk` + sudoers，见 NAS `~/frp-standalone` 同机维护）。
2. **本机** 确认 `ssh ckbnas-home` 无密码或已配密钥。
3. **回退**：`dk-nas-status` 自动改用 DSM API（`SYNO.Docker.Container`），不依赖 context。

---

## 六、与本机 Docker 的区别

| | 本机 `desktop-linux` | `ckbnas-home` |
|:---|:---|:---|
| 数据卷 | Mac 磁盘 | NAS `/volume1/docker/` |
| 性能 | 本机 CPU | NAS CPU |
| 用途 | 开发、website 分组本地站 | 生产 Mongo/Ollama/Gitea/业务站 |

**不要**在 NAS context 下 `docker compose up` 本地开发栈，除非明确要在 NAS 部署。

---

## 七、相关文件

| 文件 | 说明 |
|:---|:---|
| `scripts/setup_ckbnas_docker_remote_mac.sh` | 一键安装 |
| `scripts/ckbnas_docker_status.py` | 分组状态 |
| `scripts/ckbnas_docker_shortcuts.json` | 链接真源 |
| `scripts/ckbnas_docker_groups.json` | NAS compose 分组 |
| `参考资料/CKBNAS_Docker容器分组登记册.md` | 人读登记册 |

---

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