Files
dsh_shenxian/poc
admin 918f1d3a51 feat(models): 平台自建「模型设置」—— 用户自配厂家 / 条目各自开关 / 共享模型开关(档案 87)
- 官方「设置 → 模型」页在平台环境**必然报错**(判据在**浏览器页面**的 loopback 判定;官方 README 原文 Non-loopback pages get no durable settings)⇒ 该分区对全角色(含 admin)隐藏,用户自配改走平台自建页(插件 0.3.11)
- DB 迁移 V6:credential_vault.route/base_url/api/models + users.shared_model_enabled;并**重定义 getEnabledCredentialKeyRef**(互斥删除后原实现无 ORDER BY ⇒ 「任取一条」)
- 新落地层 src/web/model-landing.ts:spawn 时把「已启用条目」写进实例 .credentials.yaml 与 settings.yaml 的 llm-pi-ai.providers.<route>;字段名与官方包实测对齐(apiKeyEnv / baseURL / api,**不是** protocol);只碰自己写过的 + 一次性交接
- 接口 /api/me/keys、/api/me/keys/:id/toggle、/api/me/models/shared;前端新增「设置 → 模型设置」分区(settings.section id=model-settings / order 100 / 全角色)
- 顺手修两处:ensure-role-profile-patch.cjs 的 --force 整文件覆盖会抹掉 admin 的 disable-hmr 与 workspace-scoped-picker 两个平台块(改为 stripManagedBlock 只替换自己那段);verify-mem-model.mjs 因档案 86 重构而长期失败的陈旧断言

⚠️ 本提交同时包含**档案 86(admin 跨用户实例管理 + 两处改名)**的代码改动 —— 该部分已上线并端到端验证;其 import/register 与本次改动同处 src/web/server.ts、poc/business-plugins/lib/client.js 等文件,按**文件粒度无法拆分**,且不带它会让仓库 tsc 直接失败(缺 src/web/routes/admin-user-ops.ts)。
2026-09-14 00:00:15 +08:00
..

Phase 3 核心路径 PoC(不写业务代码)

🧭 ← 返回 README · 结论落地为:K8s 部署教程

对应内部设计稿 §7 的四项风险验证。不引入任何业务代码——全部用一次性 镜像(busybox / node / socat / CloudNativePG)验证基础设施假设。四项全部通过, 才允许进入 Phase 0 镜像化 / Phase 2/3 落地,避免 Phase 3 返工。

前置条件

  • 一个 k3s 集群(k3s --cluster-init 3 server + N worker 皆可,单机 k3s 也能跑 PoC)。
  • 已装且健康:
    • Longhorn(item 1、4 依赖;item 1 是硬前提,必须 longhorn.io StorageClass 可用)
    • Cilium(item 3 依赖;NetworkPolicy 必须被强制)
    • CloudNativePG operator(item 4 依赖)
    • cert-manager / MetalLB / kube-vip 与本 PoC 无关,暂不需要
  • kubectl 指向该集群(kubectl get nodes 有输出)。
  • 本地有 bash + curl(item 2/3 用);item 2 的 WS 客户端用 node(本机或容器内均可)。
kubectl get nodes
kubectl get storageclass longhorn        # item 1/4 前提
kubectl get pods -n kube-system -o wide | grep -E 'cilium|longhorn|csi'
kubectl get crd clusters.postgresql.cnpg.io  # item 4 前提

Item 1 — Longhorn RWX + subPath + runAsUser/fsGroup(§4.9 / §6.0 的 PoC)

验证的未知点:fsGroup 是否会 chown subPath 叶子?非 root 目标 uid 能否在 PVC 根建目录、0700 属主是否正确、子目录挂载后能否读写。

⚠️ 这是 docs/k8s.md §4.9 标明的「PoC 第一项必须验证」。若失败,按 §4.9 的 回退:bootstrap 阶段用特权 Job 完成 chmod 1777(在启 PSA restricted 之前), 时序固定为「初始化 PVC → 启 PSA → 允许用户 Pod」。

cd 01-longhorn-subpath
./run.sh

通过标准(脚本自动断言):

  1. bootstrap Job(特权)chmod 1777 /mnt 成功。
  2. init Job(非 root,runAsUser/fsGroup = 100001)能 mkdir -p /mnt/u1/{ws,home} 且 chmod 0700 /mnt/u1 成功——即非 root uid 能写 PVC 根(chmod 1777 生效)。
  3. 测试 Pod(runAsUser=100001,subPath: u1)能写/读文件,且 stat 显示目录属主 uid=100001、权限 0700。
  4. (可选)另一个 uid(100002)无法读该目录——subPath 叶子 + DAC 的越权边界。

Item 2 — socat 桥 WebSocket 透明转发(§3.2 / §4.3)

验证的未知点:DSH 只监听 loopback,socat TCP-LISTEN:8081 → 127.0.0.1:8080 的纯 TCP 转发对 WebSocket Upgrade 是否透明。

cd 02-socat-ws
./run.sh

通过标准:

  1. 通过 sidecar 的 8081 能拿到 fake-dsh 的 HTTP 200(TCP 基础通)。
  2. WebSocket Upgrade 握手经 8081 返回 101 Switching Protocols,且 Sec-WebSocket-Accept 校验正确(证明 Upgrade 请求与响应都原样穿透 socat)。
  3. 一条文本帧 echo 往返成功(双向透明)。

若 2/3 不透明,回退:换 nginx/netcat sidecar(同端口转发),见 §9。


Item 3 — NetworkPolicy 默认拒绝 + 控制面→DSH 单向(§3.5 / §4.4)

验证的未知点:Cilium 是否强制 NetworkPolicy;default-deny 下「仅控制面可达 DSH 8081」的单向放行是否正确,跨来源访问被拒。

cd 03-networkpolicy
./run.sh

通过标准:

  1. 同 namespace 内打了 app=dsh-orchestrator 的「控制面」Pod 能连通 DSH 8081。
  2. 同 namespace 内其它 Pod(app=attacker)访问 DSH 8081 被拒(超时/拒绝)。
  3. 这也覆盖 §3.5 的「每次 NetworkPolicy 变更后跑自动化验证」——本脚本即该验证的雏形。

若 flannel(k3s 默认)下 2 仍通,说明 CNI 未强制策略,必须切 Cilium(§11.2)。


Item 4 — CloudNativePG on Longhorn 的 pgbench 基线(§4.5)

验证的未知点:Postgres 对延迟/IOPS 敏感,Longhorn RWO 复制是否拖慢同步复制, 延迟是否可接受。

cd 04-cnpg-pgbench
./run.sh

通过标准(人工判读,无固定阈值,取决于硬件):

  1. CloudNativePG 3 实例主备建立、Ready。
  2. pgbench -S(select-only)tps 与延迟与本机 NVMe 基线对比,落在可接受区间。 §4.5 结论:不够则回退「节点本地 NVMe + PG 主备」。

通过后

四项全过 → 记录结果(tps/latency 数字、Longhorn 权限行为结论)到本 README 尾部, 再进入 Phase 0(镜像化)。任一项失败 → 按对应 §9 回退方案调整后重跑。