[2026-11-16] Rancher 社区双周报|聚焦 Longhorn 稳定性与 Harvester 新功能

各位 Rancher 社区的朋友们,大家好!

欢迎阅读本期 Rancher 社区双周报。近两周,Rancher 生态多个核心项目陆续发布正式版本:Rancher v2.15.3 集中修复安全问题并带来维护更新,Longhorn v1.12.2 聚焦稳定性与 V2 数据引擎修复,Harvester v1.9.1 更新安全补丁并推进多项功能正式可用;RKE2 和 K3s 也同步发布了覆盖多个 Kubernetes 分支的补丁版本。


Longhorn v1.12.2

Longhorn v1.12.2 是一个以稳定性、数据一致性和 V2 Data Engine 修复为主的维护版本。本次发布包含 V1/V2 数据引擎的重要修复,也对 V2 升级路径、备份建议和旧版 linked-clone 行为给出了明确说明。

升级与数据保护注意事项

  • V2 Data Engine 不支持从 v1.12.2 直接在线升级到 v1.13.0:Release Notes 明确指出,v1.13.0 缺少 v1.12.2 和 v1.13.1 中包含的部分 V2 rebuild 与 live-upgrade 修复。若从 v1.12.2 升级到 v1.13.0,需要先 detach 所有 V2 volumes;升级到 v1.13.1 或更高版本时,才支持 V2 Data Engine live upgrade。
  • 建议为 V2 volumes 配置周期性备份:如果 V2 Data Engine 在 snapshot 删除或 system-snapshot purge 过程中发生中断,可能导致 blobstore metadata 不一致,进而引发数据损坏、spdk_tgt crash 或 lvstore load failure。Release Notes 建议为 V2 volumes 配置周期性备份,并避免在 snapshot 删除或 purge 过程中重启 V2 instance-manager pod 或节点。

Breaking Changes

  • 废弃 Legacy V2 Linked Clone Volumes:v1.12.0 或更早版本创建的 V2 linked-clone volumes 在 v1.12.1 及之后版本中会被标记为 legacy 并废弃。升级后,这类 legacy linked-clone volumes 只能 detach 或 delete,不能继续执行其他操作。需要替换时,应基于相同 source volume 创建新的 linked-clone volume。

V1 Data Engine 修复

  • Backing Image 支持 IPv6 与 Dual-Stack:backing image manager 和 data source 现在会遵循 Longhorn 的 IP family selection 逻辑,根据集群或 storage network 使用 IPv4 或 IPv6 地址,支持 IPv4-first 和 IPv6-first dual-stack 集群。
  • 修复 replica rebuild 期间并发非对齐写入导致的数据丢失问题:在 replica rebuild 过程中,对同一 4 KiB sector 的小于 4 KiB 并发写入可能出现 read-modify-write 未加锁导致的数据覆盖。v1.12.2 通过 range lock 串行化此类写入。
  • 修复 replica rebuild 中 gRPC TCP keepalive 丢失导致的随机失败:sync-agent 现在使用操作系统默认 keepalive 参数,避免单次 keepalive 丢包导致连接在 20 秒后终止。

V2 Data Engine 修复与优化

  • SPDK admin reactor 独占 CPU core:SPDK CPU mask 的第一个 core 现在只运行 admin reactor,其余 core 用于 I/O pollers,减少 I/O 负载对管理路径的影响。Release Notes 建议 V2 Data Engine 至少配置 2 个 CPU cores。
  • 新增 NVMe-TCP Initiator I/O queue 数量配置:可以通过全局 default-nvme-tcp-nr-io-queues 或 volume 级别 nvmeTcpNrIoQueues 限制 NVMe-TCP I/O queue 数量,降低高核数节点上的内存消耗。
  • 修复多类 spdk_tgt crash 场景:包括 replica rebuild 完成时仍有 I/O、rebuild 过程中的 double free、large-block reads interrupt mode 下的 flush retry、expanded volume snapshot 删除后的 SPDK metadata 问题等。
  • 修复 rebuild destination failure 导致整个 engine fault 的问题:现在 destination replica 失败时只会将该 replica 标记为 ERR,保留 engine、frontend 和 I/O。
  • 修复 arm64 上 erasure-coded volume write stall:解决 SPDK erasure-coding bdev 中 lost wakeup 导致写入停滞的问题。

安装与升级要求

  • 安装或升级到 Longhorn v1.12.2 前,集群需要运行 Kubernetes v1.25 或更高版本。
  • Longhorn 仍然只允许从受支持版本进行升级。

如需详细了解完整更新内容,请查阅:


Harvester v1.9.1

Harvester v1.9.1 包含安全修复、升级行为调整,以及多个功能从实验或预览状态进入 GA。本次发布重点涉及 SUSE Linux Micro 安全补丁、eMudhra CA 信任链处理、Bare-Metal Workloads、LVM CSI Driver、Virtual Machine Auto Balance,以及 Rancher on Harvester 的新 add-on 路径。

安全修复

  • SUSE Linux Micro BaseOS 安全更新:Harvester 节点基础系统更新了 SUSE 安全补丁,修复 Linux kernel IPv4 网络相关漏洞。
  • 处理 eMudhra CA compromise:
    • ca-certificates-mozilla 已更新,使 Harvester 节点不再信任受影响的 root certificates。
    • Harvester 组件使用 Go 1.26.10 重新构建,Go 证书校验逻辑会拒绝受影响的中间证书。
    • 如果此前应用过相关 workaround,升级后需要删除 emudhra-blocklist CloudInit resource 并重启节点。

升级行为变更

  • 虚拟机 live migration 失败时不再默认关机:从 v1.7.0 开始,Harvester 在节点升级 pre-drain 阶段,如果 VM 无法 live migrate,可能会自动关闭 VM 以继续升级。v1.9.1 新增 shutdownVMOnMigrationFailure 字段控制该行为。
    • false:默认值。VM 继续运行,升级等待 live migration 成功,或由管理员手动停止 VM。
    • true:恢复旧行为,即在 live migration 失败时关闭 VM 以继续升级。
  • 当前 Harvester UI 尚未提供该字段配置,需要通过 kubectl edit settings.harvesterhci.io upgrade-config 修改。

核心特性

  • Bare-Metal Workloads GA:通过 Rancher 中的 harvester-baremetal-container-workload feature flag,可以将托管的 Harvester 集群作为标准 downstream Kubernetes cluster 暴露在 Rancher UI 中,让容器化应用直接运行在 bare-metal 节点上,并与虚拟机工作负载并存。
  • K3k 与 rancher-k3k Add-On:rancher-k3k add-on 支持在 Harvester 集群上运行 Rancher,并替代已废弃的 rancher-vcluster add-on。启用后,Harvester 会部署嵌套 K3s 集群并自动创建 Rancher 实例,用于管理底层 Harvester 集群。
  • LVM CSI Driver GA:harvester-csi-driver-lvm add-on 进入 GA,可提供 node-local LVM volumes。使用 node-local LVM volumes 的虚拟机不支持 live migration。升级到 GA 前,需要备份关键数据,并删除使用 pre-GA driver 创建的 LVM volumes;pre-GA volumes 与 GA driver 不兼容。
  • Virtual Machine Auto Balance GA:该 add-on 基于 Kubernetes Descheduler 自动平衡虚拟机工作负载,可根据管理员定义的策略在节点之间迁移适合迁移的 VM,避免资源倾斜。该版本提供生产可用默认配置、add-on 生命周期管理、节点利用率阈值配置,以及单节点集群保护逻辑。

废弃与移除

  • LVM CSI Driver 的 striped volume type 废弃:该类型缺少 CSI workflow 所需的 snapshot、clone 和 restore 能力。后续 LVM storage 需要使用 dm-thin StorageClass,且不支持原地转换。
  • rancher-vcluster add-on 废弃:Harvester v1.9.1 起废弃,并计划在 v1.10.0 移除。需要在 Harvester 集群上运行 Rancher 时,应使用 rancher-k3k add-on。

如需详细了解完整更新内容,请查阅:


Rancher v2.15.3

Rancher v2.15.3 是 Rancher v2.15 系列的最新补丁版本,主要包含安全修复、维护更新和缺陷修复。该版本属于 Community 版本;

安全修复

本次 Rancher v2.15.3 修复了多项 Rancher 与 Fleet 相关安全问题:

  • 修复 Rancher meta proxy allowlist 校验位置问题:此前 destination allowlist 的校验位置无法阻止请求继续转发,已认证用户可能让 Rancher server 向 allowlist 本应阻止的内部服务发送请求并接收响应。现在 allowlist 在 request handler 中执行,在建立连接前拒绝不允许的目标。
  • 修复 GlobalRole RBAC 校验中的权限提升问题:GlobalRole 的 inheritedNamespacedRules 字段此前未按权限提升规则校验。拥有管理 global roles 和 global role bindings 委派权限的用户,可能授予超过自身权限范围的 downstream cluster 权限。现在 GlobalRole 与 GlobalRoleBinding admission webhooks 会像校验其他权限字段一样校验该字段。
  • 修复 Rancher Manager meta proxy 凭据转发问题:在部分请求路径中,调用者自身的 Rancher credentials 没有被稳定移除,可能在 provisioning views 的常规使用中被发送到第三方 cloud provider host。现在 proxy 会在所有请求路径上移除调用者凭据。
  • 修复 local cluster shell 授权检查覆盖不完整问题:此前保护 local cluster shell 的授权检查没有覆盖所有可到达该能力的 API route,导致任意已认证用户即使没有 local cluster 权限,也可能在 management cluster 获得低权限 shell pod。现在所有请求形式都会一致执行授权检查。
  • 修复 Fleet agent management controller 权限提升问题:普通用户创建的 Fleet cluster object 此前可能引用 Rancher management(local)cluster 的管理凭据,从而获得 management cluster 以及所有 managed clusters 的 cluster-admin 权限。现在 Fleet 只接受带有目标 namespace 使用标签的跨 namespace kubeconfig secret,并且只会把 agent 部署到自身 system clusters 对应的 management cluster。
  • 修复 Fleet cluster registration 身份绑定问题:此前 cluster registration 中声明的 cluster identity 没有和 registration token 绑定。持有有效 workspace registration token 的用户如果知道另一个 cluster 的 client identifier,可能获取该 cluster 的 Fleet management namespace 凭据并干扰合法 agent。现在 Fleet 会记录 cluster 使用的 registration token,并拒绝同一 cluster identity 搭配不同 token 的注册请求。

Rancher 与集群生命周期修复

  • Rancher settings 环境变量回退修复:修复使用环境变量配置的 Rancher settings 在环境变量移除后仍保留旧值和 source: env 属性的问题。现在环境变量移除后,Rancher 会在启动时清除存储的 environment source 和 value,使 setting 回到默认值。
  • Imported cluster 升级后不可用问题修复:修复 Rancher 升级后,如果 cluster agent 在 registration token 迁移前被重新部署,可能拿到空 token 并导致 imported cluster 不可用的问题。
  • S3 etcd snapshot 集群删除卡住问题修复:修复 provisioned clusters 使用 S3 etcd snapshots 时,删除过程可能长期卡住的问题。

如需详细了解完整更新内容,请查阅:


RKE2 11 月补丁版本

RKE2 本期发布了多个正式补丁版本,覆盖 Kubernetes v1.34、v1.35、v1.36、v1.37 分支:

  • v1.37.2+rke2r1
  • v1.36.6+rke2r1
  • v1.35.10+rke2r1
  • v1.34.13+rke2r1

这些版本主要更新 Kubernetes patch 版本,并同步更新 containerd、Traefik、CNI、vSphere CSI/CPI、Harvester CSI Driver、snapshot-controller 等组件。

Kubernetes 版本更新

  • v1.37.2+rke2r1:Kubernetes 更新至 v1.37.2。
  • v1.36.6+rke2r1:Kubernetes 更新至 v1.36.6。
  • v1.35.10+rke2r1:Kubernetes 更新至 v1.35.10。
  • v1.34.13+rke2r1:Kubernetes 更新至 v1.34.13。

重要兼容性说明

  • v1.36 分支中的 ingress-nginx 到 Traefik 迁移:由于 upstream ingress-nginx 已在 2026 年 3 月 retired,RKE2 v1.36 起新集群默认使用 Traefik。已有集群升级时会保留现有 ingress,以避免破坏性变更。
    • Air-gapped 环境中,rke2-images-core tarball 现在包含 Traefik images,而不再单独提供 rke2-images-traefik tarball。
    • 需要继续使用 ingress-nginx 的用户,需要手动提供 rke2-images-ingress-nginx tarball。
    • 社区用户在 v1.37 中不再保留 ingress-nginx chart。
  • Traefik chart v40.x 的 breaking change:部分版本说明中明确指出,Traefik chart 升级到 v40.x 后,ingress-nginx migration 的 provider name 从 kubernetesIngressNginx 改为 kubernetesIngressNGINX。

组件升级

  • Containerd:
    • v1.37.2 与 v1.36.6 使用 containerd v2.3.7-k3s1。
    • v1.35.10 与 v1.34.13 使用 containerd v2.2.10-k3s1。
  • Runc:RKE2 packaged component 中使用 runc v1.4.3。
  • CoreDNS:更新至 v1.14.7。
  • Metrics Server:更新至 v0.9.0。
  • Traefik:
    • v1.37.2 使用 chart 42.1.301。
    • v1.36.6、v1.35.10、v1.34.13 使用 chart 40.1.022。
  • CNI:
    • Cilium chart 更新到 1.20.400。
    • Canal 使用 Flannel v0.28.10 与 Calico v3.32.2。
    • Calico 更新到 v3.32.2。
    • Multus 更新到 v4.3.1。
  • ingress-nginx:chart 更新到 4.15.115,image 更新到 v1.15.1-prime18。
  • Harvester CSI Driver:更新到 v0.2.11,chart 版本为 0.1.33,并使用 Go 1.26.10 重新构建。
  • vSphere CSI/CPI:vSphere 相关 chart 更新到新版本。
  • snapshot-controller / klipper-helm / HCP:均包含对应版本 bump。

修复与维护项

  • 修复或改进了 external cloud controller 默认行为。
  • 同步 RKE2 uninstall script。
  • 在 killall script 中加入 canal blackhole route cleanup。
  • 更新 CNIs、hardened runtime images、hardened containerd、crictl、etcd images。
  • 多个分支同步引入 Go 1.26.10 构建更新。

如需详细了解完整更新内容,请查阅:


K3s 11 月补丁版本

K3s 本期同样发布了多个正式补丁版本,覆盖 Kubernetes v1.34、v1.35、v1.36、v1.37 分支:

  • v1.37.2+k3s1
  • v1.36.6+k3s1
  • v1.35.10+k3s1
  • v1.34.13+k3s1

这些版本主要同步 Kubernetes patch 版本,并包含 containerd、Traefik、Flannel、CoreDNS、Helm Controller 等组件更新,以及一批 2026 年 10 月 backports。

Kubernetes 版本更新

  • v1.37.2+k3s1:Kubernetes 更新至 v1.37.2。
  • v1.36.6+k3s1:Kubernetes 更新至 v1.36.6。
  • v1.35.10+k3s1:Kubernetes 更新至 v1.35.10。
  • v1.34.13+k3s1:Kubernetes 更新至 v1.34.13。

重要兼容性说明

  • Traefik chart v40.x breaking change:v1.35.10 与 v1.34.13 的 Release Notes 中提示,Traefik chart 升级到 v40.x 后,ingress-nginx migration 的 provider name 从 kubernetesIngressNginx 改为 kubernetesIngressNGINX。使用相关迁移配置的用户需要检查配置名称。

组件升级

  • Containerd:
    • v1.37.2 使用 containerd v2.3.7-k3s1。
    • v1.36.6 使用 containerd v2.3.7-k3s1.36。
    • v1.35.10 与 v1.34.13 使用 containerd v2.2.10-k3s1。
  • Runc:使用 v1.4.2。
  • Flannel:更新至 v0.28.10。
  • Metrics Server:更新至 v0.9.0。
  • Traefik:更新至 v3.7.15。
  • CoreDNS:更新至 v1.14.7。
  • Local Path Provisioner:更新至 v0.0.37。
  • Helm Controller:
    • v1.37.2、v1.36.6、v1.35.10 使用 v0.17.9。
    • v1.34.13 使用 v0.16.27。
  • Gateway API CRD:v1.37.2 中包含 Kubernetes Gateway API CRD 1.6.301。

修复与 Backports

本轮 K3s 补丁版本包含多项 backports 和维护修复:

  • 在没有 default route 时,systemd restart loop 通过等待 default route 出现来避免反复重启。
  • apiserver readiness check 排除 kms-providers。
  • 改进 etcd local 与 S3 snapshot retention flag 的帮助信息。
  • 节点地址变化时更新 ServiceLB status。
  • 使用 service-account-signing-endpoint 时不再传入默认 SA key flags。
  • 修复 SELinux enforcing 场景下 local-path PV 删除问题。
  • 加入 etcd snapshot restrictions 相关修复。
  • 预拉取镜像时报告 image list 读取错误。
  • 修复 etcd disabled 的既有 server 上 etcd member removal 问题。
  • 修复 proxy 中的 goroutine leak。
  • 对 snapshot restore 测试、Docker/GHCR CI、Gateway API 测试等维护项进行了同步更新。

如需详细了解完整更新内容,请查阅:


写在最后

本期更新既包含 Rancher 与 Harvester 的安全修复和维护改进,也涵盖 Longhorn V2 数据引擎、RKE2 与 K3s 多个 Kubernetes 分支的持续演进。升级前,建议结合自身环境仔细阅读对应 Release Notes,重点确认版本兼容性及升级注意事项;使用 Longhorn V2 的用户还应特别关注数据保护建议和升级路径要求。

感谢 Rancher 社区开发者、用户与贡献者的持续支持。欢迎通过 GitHub Issue/PR 和社区交流分享使用反馈,与我们共同推动 Rancher 生态不断完善。

我们下期双周报再见!