默认值不是公网暴露建议。部署时可通过对应 HOST / PORT 配置改变监听地址,反向代理只路由指定用途。
本地开发入口
受管理启动器默认配置 Cloudflare 开发通道,要求 cloudflared 可用。它只转发凭据 listener,不转发管理 API。Console 的 Network & ingress 展示通道状态,管理界面可在通道失败时独立工作。 临时通道传输委托 token 和请求 / 响应内容,数据路径包含 tunnel 服务。生产或固定网络环境应使用自行配置的稳定 HTTPS origin。外部模式配置示例:hosted 与预览
hosted 使用稳定 HTTPS 凭据 origin,并拒绝临时 tunnel。云 Sandbox 必须可以访问它;从控制平面 curl 自己成功不能证明云网络可达。 管理 API 保留鉴权。预览使用独立域名与通配 TLS / 路由,每个 grant 有独立子域,不能让生成应用与 Console 共用 origin。预览协议限制见预览指南。OAuth callback 是另一类管理回调路径,不能把凭据通道当作 OAuth 管理 tunnel。出站代理和网络策略
保存的 outbound_proxy 与进程环境控制相应出站路径,显式环境优先,no_proxy 合并并保留 loopback。受保护上游有额外目标限制:直连检查公共 DNS 地址并拒绝重定向;显式可信 egress proxy 必须配合准确主机列表,不能用任意代理绕过目的地址检查。HEXAGON_ACCESS_EGRESS_PROXY_URL 与 HEXAGON_ACCESS_EGRESS_HOSTS 是受保护上游代理设置。列表使用精确 hostname,不是 wildcard。不要因为普通 npm 请求能联网就认为模型 / Tool 路径已经配置成功。
Sandbox allowlist 必须包含凭据 origin 的 hostname,否则预检会拒绝。Provider 的网络策略与控制平面的 Tool 出站策略不同,见网络策略。
沿请求路径定位,而不只看端口
图中表示流量职责,不代表每条箭头共用一套授权。ToolBroker 调用发生在控制平面,Sandbox 域名 allowlist 不管理这段出站。local 模式云任务与恢复记录仅证明其中实际使用的临时入口拓扑,不证明任意 hosted 稳定域名。应在自己的拓扑重做云端可达与预览隔离检查。
诊断顺序
- status / Console:控制平面是否运行、是否连对工作区。
- 凭据入口状态:origin 是否属于当前实例,TLS / 路由是否正确。
- 真实云任务:Sandbox 是否到得了入口,是否被网络 allowlist 阻止。
- 受保护上游:模型协议、固定目标、凭据和出站代理是否匹配。
- 预览:应用进程、端口、grant、独立 origin、过期状态。