网关与隧道

Documentation Index

Fetch the complete documentation index at: https://docs.cyberun.cloud/llms.txt

Use this file to discover all available pages before exploring further.

代理网关 是每个 Cyberun 代理都会连接的 WebSocket 接口。代理从自身所在位置向网关拨号;一旦建立连接,它们就保持连接开启并从中接收任务。代理主机上没有任何入站监听端口 —— 网关从不主动发起连接。 本页从运维方视角描述该接口。终端用户产品流程见 Cloud 标签页。

​

网关做什么

• 接纳代理。 代理连接时出示代理凭证(ak-)。网关校验凭证,查找团队,并把代理注册到该团队的池中。
• 派发任务。 当 Cyberun Cloud 接受任务后,网关挑选团队池中一个合格的代理并把任务交给它。
• 流式传输进度。 状态、部分输出与最终产物经由代理通过网关回流给提交任务的客户端。
• 代理服务。 当某任务要求代理对外暴露服务 —— ComfyUI UI、运行在代理上的容器服务 —— 网关通过同一个外发连接代理该服务的 HTTPS 请求。运维方无需在代理主机上发布另一个端口。

​

代理在网络上需要什么

• 从代理主机到该部署所配置网关 URL 的出站 HTTPS 连接。Cyberun 托管服务发布单一网关 URL;自托管部署各自选择。
• 代理主机无需任何入站暴露。阻挡入站连接的防火墙没有影响。
• 不需要持久的代理到代理路径。代理之间无需互相可达。

在多站点部署中,可能运行多个网关。代理连接到对其而言最近的网关;平台其余部分看到的是统一的池。

​

隧道化服务

工作流可以在任务运行期间要求代理对外暴露服务 —— 最常见的是 ComfyUI 网页 UI,让用户与之交互。流程如下:

1. 代理在本地端口上启动服务。
2. 网关通过既有的外发连接打开到该端口的隧道。
3. 浏览器对部署 URL 的请求被路由到 Cloud,再到网关,然后通过隧道到达服务。
4. 当任务结束(或用户关闭标签页),隧道随之关闭。

从用户视角看,该服务呈现为部署提供的普通 URL。从运维方视角看,代理从未对外开放过任何端口。 同样的模型也处理容器服务 —— 代理托管的长期容器,网关按名字寻址。契约相似;细节归入与运维合作伙伴共享的运行手册。

​

本页不涉及的内容

• 网关与代理在 WebSocket 连接内部所讲的分片级协议。
• 平台组件之间的内部 RPC(服务端到网关、网关到网关)。
• 调优旋钮、超时与重试预算。

这些属于合作伙伴通道材料。客户端与集成所用的公开 HTTP 接口见 API 参考。