【Release】Harvester v1.9.1 正式发布！

新版本发布
1

Harvester v1.9.1 Release Notes

本版本引入了多项功能、增强和 Bug 修复，用于提升系统质量和整体用户体验。文档可参见 https://docs.harvesterhci.io/v1.9。

Harvester 团队感谢大家的贡献，并期待收到关于此版本的反馈。

下载

AMD64

Full ISO

:cd: https://releases.rancher.com/harvester/v1.9.1/harvester-v1.9.1-amd64.iso

:file_folder: https://releases.rancher.com/harvester/v1.9.1/harvester-v1.9.1-vmlinuz-amd64

:file_folder: https://releases.rancher.com/harvester/v1.9.1/harvester-v1.9.1-initrd-amd64

:file_folder: https://releases.rancher.com/harvester/v1.9.1/harvester-v1.9.1-rootfs-amd64.squashfs

:white_check_mark: https://releases.rancher.com/harvester/v1.9.1/harvester-v1.9.1-amd64.sha512

:memo: https://releases.rancher.com/harvester/v1.9.1/version.yaml

Net Install ISO

:cd: https://releases.rancher.com/harvester/v1.9.1/harvester-v1.9.1-amd64-net-install.iso

:memo: Net Install ISO | Harvester

ARM64

:cd: https://releases.rancher.com/harvester/v1.9.1/harvester-v1.9.1-arm64.iso

:file_folder: https://releases.rancher.com/harvester/v1.9.1/harvester-v1.9.1-vmlinuz-arm64

:file_folder: https://releases.rancher.com/harvester/v1.9.1/harvester-v1.9.1-initrd-arm64

:file_folder: https://releases.rancher.com/harvester/v1.9.1/harvester-v1.9.1-rootfs-arm64.squashfs

:white_check_mark: https://releases.rancher.com/harvester/v1.9.1/harvester-v1.9.1-arm64.sha512

:memo: https://releases.rancher.com/harvester/v1.9.1/version-arm64.yaml

安全修复

此版本修复了以下底层组件中的安全漏洞：

  • 操作系统（SUSE Linux Micro）：BaseOS 镜像已更新，包含最新的 SUSE Linux kernel 安全补丁，修复了 IPv4 网络代码中的以下漏洞：

    • CVE-2026-99999（PwnEscape）：kernel 现在会在完成校验和之前验证 IPv4 数据包的 checksum offset。该漏洞可能允许从 KVM guest 逃逸到 host（#11998）。

    • CVE-2026-98432：kernel 现在只会在 RCU grace period 结束后释放 IPv4 options。该修复解决了建立新的 IPv4 TCP 连接时的竞态条件，该问题会导致 use-after-free，并可能允许远程代码执行（#12110）。

  • CA 信任存储（eMudhra CA compromise）：2026 年 10 月，多个 eMudhra 中间证书颁发机构的私钥被发现可从其公开证书中恢复。持有其中一个密钥的攻击者可以为任意主机名签发证书，并对仍信任这些中间证书的客户端冒充任意 TLS server。此版本在以下组件中修复了该问题：

    • 操作系统（SUSE Linux Micro）：已更新 ca-certificates-mozilla 软件包，使 Harvester Node 不再信任受影响的 root certificates。更多信息请参见 CVE-2026-114406。

    • Go toolchain（Harvester 组件）：Harvester 组件已使用 Go 1.26.10 重新构建，该版本会在证书验证期间拒绝受影响的中间证书（#12054）。更多信息请参见 CVE-2026-111943。

    如果你已经应用了 knowledge base article 中描述的 workaround，请在升级后删除 emudhra-blocklist CloudInit resource 并重启 Node。

安装

Harvester 可以通过 ISO 镜像、可启动 USB 设备 和 PXE boot 安装。更多信息请参见文档中的 Installation 部分。

升级

Harvester 仅允许从受支持的版本升级。有关升级路径和流程的更多信息，请参见 Upgrading Harvester。

[!IMPORTANT]
当 live migration 在升级过程中失败时，Harvester 不再在没有警告的情况下关闭虚拟机。

从 v1.7.0 开始，在 Node 升级的 pre-drain 阶段，如果某些虚拟机无法完成 live migration，Harvester 会自动关闭这些虚拟机，以便升级继续进行（参见 PR #9326）。这可能导致生产虚拟机在无预警的情况下被关闭，并且你无法阻止这种行为。

v1.9.1 在 upgrade-config setting 中新增了 shutdownVMOnMigrationFailure 字段，使你可以决定 Harvester 如何处理这些虚拟机。默认情况下，当虚拟机 live migration 失败时，Harvester 不会关闭该虚拟机。

  • false（默认）：虚拟机保持运行，升级会等待 live migration 成功，或等待你手动停止该虚拟机。

  • true：Harvester 会关闭虚拟机以允许升级继续进行，这是之前的行为。升级完成后，你必须手动启动该虚拟机。

升级到 v1.9.1 后，默认值会自动生效。若要保留之前的行为，请在开始升级前将该字段设置为 true。Harvester UI 目前尚未提供该字段，因此你必须使用 kubectl edit settings.harvesterhci.io upgrade-config 命令进行配置。

Documentation | GitHub issue

重点更新

支持 Bare-Metal Workloads（General Availability）

通过在 Rancher 中启用 harvester-baremetal-container-workload feature flag，受管 Harvester 集群会在 Rancher UI 中作为标准 downstream Kubernetes 集群暴露，从而允许容器化应用与虚拟机一起直接运行在 bare-metal Node 上。

你可以使用外部 Rancher 实例，或使用部署在 Harvester 集群上的 rancher-k3k add-on 中的 Rancher 实例，同时管理这些容器 workload 和虚拟机 workload。

Documentation | GitHub issue

K3k 和 Rancher-K3k Add-On（Experimental）

rancher-k3k add-on 允许你将 Rancher 作为 workload 运行在 Harvester 集群上，并替代已弃用的 rancher-vcluster add-on。它需要 k3k add-on，后者会部署 K3k controller。启用 rancher-k3k 后，Harvester 会部署一个嵌套的 K3s 集群，并自动预置一个 Rancher 实例，用于管理底层 Harvester 集群。

Documentation | GitHub issue

LVM CSI Driver（General Availability）

harvester-csi-driver-lvm add-on 现已在 Harvester v1.9.1 中正式 GA。它会预置 Node-local LVM volumes，要求 workload 运行在其存储所在的 Node 上。因此，使用 Node-local LVM volumes 的虚拟机不支持 live migration。

升级到 GA 版本之前，请备份所有关键数据，并删除所有使用 GA 前驱动创建的 LVM volumes。GA 前创建的 volumes 与 GA driver 不兼容，升级后无法恢复。

Documentation | GitHub issue

Virtual Machine Auto Balance（General Availability）

Virtual Machine Auto Balance add-on 现已在 Harvester 中正式 GA。该 add-on 基于 Kubernetes Descheduler，根据管理员定义的策略自动在集群 Node 之间重新平衡虚拟机 workload，从而提升集群性能并避免资源争用。

此版本包含可用于生产的默认配置、通过 Harvester add-on framework 进行完整生命周期管理、可自定义的 Node utilization thresholds，以及防止在单节点集群上启用的内置保护。当阈值被超过时，add-on 会将符合条件的 workload 迁移到利用率较低的 Node，同时自动保护不可迁移的虚拟机。

Documentation | GitHub issue

弃用和移除

LVM CSI Driver 的 striped Volume Type

LVM CSI driver GA 版本中已弃用对 striped volume type 的支持。该 volume type 缺少 CSI workflow 所需的高效 snapshot、clone 和 restore 能力。因此，所有 LVM storage 现在都需要使用 dm-thin StorageClass。由于不支持原地转换，请在升级到完全移除该类型的 Harvester 版本之前，从现有 striped volumes 迁移数据。

rancher-vcluster Add-On

rancher-vcluster 在 Harvester v1.9.1 中已弃用，并将在 v1.10.0 中移除。若要在 Harvester 集群上以 workload 形式运行 Rancher，请改用 rancher-k3k add-on。Harvester 不会将现有 rancher-vcluster deployment 的数据迁移到 rancher-k3k，因此你必须重新导入 Harvester 集群并重新创建 Rancher 配置。

GitHub issue

功能

  • [EPIC] Local Storage Support (LVM) GA #10564
  • [FEATURE] Virtual Machine Auto Balance (descheduler) GA #10779
  • [FEATURE] 用于 Rancher Liz 集成的 Harvester MCP server #10373
  • [FEATURE] Terraform provider：暴露 VM 的 CPU/memory resource requests #10050
  • [FEATURE] Baremetal container workload support GA #5820

增强

  • [backport v1.9] [ENHANCEMENT] 防止升级期间迁移失败时静默关闭 VM #12172
  • [ENHANCEMENT][UI] 在 UI 中移除 LVM storage class 的 striped VG type #11731
  • [backport v1.9] [ENHANCEMENT] 当请求不被允许时，将状态码改为 403 #11725
  • [backport v1.9] [ENHANCEMENT] 升级期间检测失败的 live migration 时增加更多日志 #11724
  • [backport v1.9] [ENHANCEMENT] 支持基于 longhorn backing image 的 StorageClass 确定性命名 #11610
  • [backport v1.9] [ENHANCEMENT] 为支持 rancher-k3k addon 进行 UI 调整 #11512
  • [Documentation] 记录 striped volume type 的弃用说明 #11334
  • [ENHANCEMENT] 使用 512 KiB chunks 和 16 GiB metadata 标准化 dm-thin pool 创建 #11333
  • [ENHANCEMENT] 禁用 LVM add-on 时增加保护机制 #11281
  • [ENHANCEMENT] 简化 add-on 管理 #10648
  • [ENHANCEMENT] 提供用于 prepared（sysprepped）images 的 Windows template，而不仅是安装 ISO #11668
  • [ENHANCEMENT] 在 VM 和 Volume UI 中暴露 KubeVirt 高性能存储特性 #11550

Bug 修复

  • [backport v1.9] [BUG] 如果没有提供 multipath kernel arg，从 v1.9.x 升级到 master 会因找不到 xargs 命令而卡在 post drain #12182
  • [BUG] 处理 IPv4 数据包时可能发生远程代码执行（CVE-2026-98432）#12110
  • [backport v1.9] [BUG] Forklift 迁移的 VM 没有 resource overcommit（requests 默认等于 limits）#12006
  • [backport v1.9] [BUG] 升级后 non-migratable VM 未触发 restoreVM job #11979
  • [backport v1.9] [BUG] 没有默认 StorageClass 时 VirtualMachineImage 更新失败，阻塞升级清理 #11973
  • [BUG] storage-validator 不适用于 block storage CSI drivers #11829
  • [BUG] Uncordon Node 后立即 live migration 会导致 FailedAttachVolume 错误 #11782
  • [BUG] LVM CSI retry amplification 可能导致批量 volume 操作卡住 #11747
  • [backport v1.9] [BUG] Harvester UI 以无效顺序创建混合 MIG profiles，导致 NVIDIA exit code 23 #11734
  • [BUG] 升级卡在 configmap chart-content-rke2-traefik-crd not found #11730
  • [BUG] LVM CSI 3 分钟 timeout 会中断缓慢的 dm-thin pool 初始化，并留下部分创建的 LVs #11728
  • [BUG][UI] 使用 LVM volume 的 VM 没有 “Take VM Snapshot” 按钮 #11676
  • [backport v1.9] [BUG] v1.9.0 中 mgmt clusternetwork 缺少 MTU annotation #11673
  • [BUG] 升级期间丢失 VIP 和 UI 可访问性（ARM 集群）#11634
  • [BUG] 从 1.8.2 升级到 1.9.0-rc7 时，由于 CPU extra features: ht，VM Live migration 失败 #11615
  • [BUG] 升级后 kubevirt-migration setting 未反映现有 KubeVirt migration configuration #11517
  • [backport v1.9] [BUG] 单节点从 v1.8.2 升级到 v1.9.0-rc6 时丢失 VIP 连接 #11496
  • [BUG][UI] preferences 页面出现 500 PUT 错误 #11441
  • [backport v1.9] [BUG] pr-helper image 缺少 /entrypoint.sh — PersistentReservation feature gate 会使 Harvester 1.7.x 和 1.8.0 上所有 virt-handler pods CrashLoop #11423
  • [backport v1.9] [BUG] logout 功能工作不正常 #11405
  • [BUG] v1.8.1 到 v1.9.0-rc4 升级期间，VM 没有 LiveMigrate 而是变为 Off #11356
  • [BUG] 可以创建/克隆没有名称的 Cloud Config（User Data & Network Data）#11299
  • [backport v1.9] [BUG] 无法对带有 lvm disk 的 VM 执行 snapshot #11272
  • [backport v1.9] [BUG] 禁用并重新启用后 csi-driver-lvm CrashLoop #11271
  • [BUG] LVM CSI driver DeleteSnapshot 在 nil SnapshotHandle 上 panic，导致 plugin CrashLoop 并阻塞所有 storage ops #11105
  • [BUG] [UI] Addon harvester-csi-driver-lvm 看起来未启用 #10717
  • [backport v1.9] [BUG] 当 mgmt interface 配置为 802.3ad/LACP mode 时，Harvester 安装因网络错误失败 #11969
  • [BUG] LVM CSI CreateVolume 无法从 pre-provisioned VolumeSnapshotContent restore/clone（影响 Velero CSI data-mover restore）#11339
  • [BUG] Orphan lvm-snapshot LVs 永远不会被垃圾回收 —— VolumeSnapshotContent 消失后 pool space 被静默占用 #11128
  • [backport v1.9] [BUG] 在 Rancher 中创建 Load Balancer 时，默认 IPAM setting 显示 DHCP，但实际使用 Pool #11489

其他

  • [DOC] 记录 VM snapshot restore 因 WaitForFirstConsumer 卡住的问题 #12176
  • [backport v1.9] [TASK] 更新 Go Base Images 以使用 Go 1.26 或 1.27 #12054
  • [TASK] 升级 Harvester OS Kernel 以修复 CVE-2026-99999 #11998
  • [backport v1.9] [TASK] 确保所有 base golang image 使用 bci #11509
  • [TASK] 弃用 rancher-vcluster addon #10650
  • [TASK] 更新 1.9 中 experimental 和 preview features 的成熟度 #10649

已知问题

本节仅包含发布日期之前已确认的问题。有关 v1.9.1 相关的所有问题，请参见 this page。

  • [BUG] 集群导入到外部 Rancher 后，Node promotion 永远无法完成 #11741

组件版本

Component Version
Longhorn v1.12.2
KubeVirt v1.8.4
CDI v1.65.0
Kube-OVN v1.16.2
Embedded Rancher v2.15.3
RKE2 v1.36.6+rke2r1
SL Micro 6.2

贡献者

感谢所有为此版本做出贡献的 contributors。

@a110605
@abonillabeeche
@albinsun
@amin10440
@asc5543
@asettle
@bk201
@brandboat
@datamattsson
@forbesguthrie
@ibrokethecloud
@ihcsim
@innobead
@irishgordo
@jillian-maroket
@jniedergang
@khushboo-rancher
@lanfon72
@m-ildefons
@noahgildersleeve
@pohanhuang
@rebeccazzzz
@rrajendran17
@starbops
@susesamu
@TachunLin
@vatsalparekh
@Vicente-Cheng
@w13915984028
@WebberHuang1118
@wheatdog
@Yu-Jack

原文发布地址: harvester/harvester v1.9.1