🔄 卡若AI 重建本地主仓 | 保留有效小文件

01_卡资（金）/金仓_存储备份/群晖NAS管理/参考资料/CKBNAS_本机Docker远程快捷方式.md

@@ -0,0 +1,86 @@
+# 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*