5.1 部署前预检 (Preflight)
预检(preflight check)是部署脚本在真正安装前对 host 环境的硬约束检查。CubeSandbox 在 deploy/one-click/online-install.sh:50-180 的 checkearlyprefli
Cubesandbox
4.8 端口与服务拓扑
CubeSandbox 各组件在 host 上分配明确端口,互不冲突:
4.7 跨服务凭据
CubeSandbox 部署依赖多个组件:
4.6 WebUI 数字助理 (DB-backed session)
CubeSandbox 自带 WebUI 控制台,登入后由后端数据库(mysql/postgres)管理 session,不发 cookie,而是用 x-session-token header 携带不透明 token。
4.5 多租户隔离
CubeSandbox 的多租户基于 containerd namespaces(namespaces.WithNamespace(ctx, ns))+ tenant label + Redis keyspace 三层组合。
4.4 /health 豁免
Every request (except /health) must carry an Authorization: Bearer <token> or X-API-Key: <key> header
4.3 共享 HTTP 客户端(连接池上限)
CubeAPI 启动时创建一个全局共享的 reqwest::Client 实例,所有外部 HTTP 调用(auth callback、webhook、镜像拉取)都通过它发出。
4.2 per-API-key 速率限制
CubeSandbox 在 API 层用了 token bucket 限流,按 API key 维度分配独立配额。每条请求到来:
4.1 外部 auth callback
CubeSandbox 自身不实现 OAuth/JWT 之类的内嵌认证,而是把"是否放行"的决定委托给一个外部 HTTP 服务。每次接收请求,CubeAPI 都会把请求转发给外部 authcallbackurl,由 callback 返回
3.8 no_reaper / no_sub_reaper
Linux 进程树的"reaper"机制决定:谁负责回收"孤儿进程"(parent 死掉但子进程还活着)。在 Linux 中: