yurt-hub是为ACK集群混合云节点池提供自治能力的节点组件。本文为您介绍yurt-hub组件,以及使用说明和相关内容的最新动态。
组件介绍
yurt-hub作为节点维度的流量代理,专为云边网络不稳定场景提供可用性与体验。
该组件的主要作用如下:
提供数据缓存能力。当节点到云端API Server的链路不可用时,您的业务Pod和系统组件即使发生重启,也可以从yurt-hub的本地缓存读取关键资源数据,避免因“拿不到配置/状态”导致启动失败或长时间不可用。
避免因访问API Server中断引发的连锁反应(驱逐/重启风暴)。在专线中断或不稳定时,yurt-hub作为节点本地代理承接访问请求,减少因 apiserver 不可达带来的超时与错误,降低节点上 Pod 被异常影响、频繁重启等风险,让边缘侧更“抗断连”。
支持API Server访问链路自适应。集群内使用InClusterConfig的应用/组件,访问API Server时会自动经由yurt-hub代理转发,实现链路自适应;无需为网络不稳定场景专门改造应用。
支持系统组件的镜像仓库自动适配,在专线或公网连接场景下,系统组件会自动切换为使用私网镜像或公网镜像。

使用说明
仅支持 1.33 及以上版本的 ACK 托管集群使用,且仅支持混合云节点池部署使用。
使用该组件前,需提前安装控制面组件yurt-hub-controlplane。
yurt-hub安装说明:
在阿里云OpenAPI门户中调用OpenAPI InstallNodePoolComponents,填入需要安装yurt-hub的集群ID与混合云节点池ID,然后在组件名称中填入yurt-hub,组件版本选择0.15.0。可通过config.customConfig配置参数,当前支持配置
"cacheAgents": {User-Agent}以开启数据缓存能力,示例配置如下,其中 User-Agent通常是业务容器的启动命令。apiVersion: v1 kind: Pod metadata: name: hybrid-app-pod spec: containers: - name: "hybrid-app" image: "xxx/hybrid-app-amd64:1.18.8" command: - /bin/sh - -ec - | # User-Agent 即为启动命令: hybrid-app。 /usr/local/bin/hybrid-app --v=2
变更记录
2026 年 01 月
版本号 | 镜像地址 | 变更内容 | 变更时间 | 变更影响 |
v0.15.0 | registry.cn-hangzhou.aliyuncs.com/acs/yurt-hub:v0.15.0 | ACK 集群混合云节点池的首个 yurt-hub 版本。 | 2026 年 01 月 13 日 | 此次升级不会对业务造成影响。 |