发布日期: 2026-01-28
版本号: v1.10.2

Longhorn v1.10.2 版本主要为提升系统质量、稳定性与安全性进行了多项改进和修复。重要变更包括：紧急热修复要求将 backing-image-manager:v1.10.2 镜像替换为 backing-image-manager:v1.10.2-hotfix-1 以解决启用HTTP代理时可能导致的后台镜像上传失败问题；修复了包括节点排空后RWX卷不可用、加密卷无法在线扩容、克隆卷无法挂载、块模式卷迁移卡住、副本自动平衡受阻、引擎升级时副本堆积、潜在客户端连接泄漏以及副本调度忽略反亲和性设置在内的多个关键稳定性问题。此外，安装和升级前请确保集群运行 Kubernetes v1.25 或更高版本。该版本由多位贡献者协作完成。

更新内容 （中文）

Longhorn v1.10.2 发布说明

Longhorn 1.10.2 引入了多项改进和错误修复，旨在提升系统质量、弹性、稳定性和安全性。

我们欢迎反馈和贡献，以帮助持续改进 Longhorn。

关于 Longhorn 版本的术语和上下文，请参阅 发布版本。

[!WARNING]

热修复

backing-image-manager:v1.10.2 镜像受到以下问题影响：

为缓解此问题，请将 backing-image-manager:v1.10.2 替换为热修复镜像 backing-image-manager:v1.10.2-hotfix-1。

按照以下步骤应用更新：

  1. 更新 backing-image-manager 镜像

    • 在相应文件中将镜像标签从 v1.10.2 更改为 v1.10.2-hotfix-1：
      • 对于 Helm：更新 values.yaml
      • 对于清单文件：直接更新部署清单。

  2. 继续升级

    • 使用您的标准 Helm 升级命令应用更改，或重新应用更新后的清单。

重要修复

此版本包含多个关键稳定性修复。

节点排空后 RWX 卷不可用

修复了一个竞态条件，该条件可能导致ReadWriteMany (RWX) 卷在节点排空后仍处于附加中状态，导致工作负载不可用。

更多详情，请参阅 Issue #12231。

加密卷无法在线扩展

修复了一个问题，该问题导致在线扩展加密卷时，新大小未传播到 dm-crypt 设备。

更多详情，请参阅 Issue #12368。

克隆卷无法附加到工作负载

修复了一个错误，该错误可能导致克隆卷无法达到健康状态，从而阻止其附加到工作负载。

更多详情，请参阅 Issue #12208。

块模式卷迁移卡住

修复了块模式卷迁移中的一个回归问题，其中新创建的副本可能错误地继承源副本的 lastFailedAt 时间戳，导致重复删除并阻碍迁移完成。

更多详情，请参阅 Issue #12312。

副本自动平衡磁盘压力阈值停滞

修复了一个问题，该问题可能导致在磁盘上存在已停止卷时，磁盘压力下的副本自动平衡被阻止。

更多详情，请参阅 Issue #12334。

引擎升级期间副本累积

修复了一个错误，该错误可能导致临时副本在引擎升级期间累积。高 etcd 延迟可能导致新副本验证失败，进而在多个协调周期中累积。

更多详情，请参阅 Issue #12115。

潜在的客户端连接和上下文泄漏

修复了实例管理器客户端和后备镜像管理器客户端中潜在的上下文泄漏，提高了稳定性并防止资源耗尽。

更多详情，请参阅 Issue #12200 和 Issue #12195。

忽略副本节点级别软反亲和性

修复了副本调度循环中的一个错误，该错误可能导致副本被调度到已托管副本的节点上，即使禁用了副本节点级别软反亲和性。

更多详情，请参阅 Issue #12251。

安装

[!IMPORTANT] 安装 Longhorn v1.10.2 前，请确保您的集群运行 Kubernetes v1.25 或更高版本。

您可以使用多种工具安装 Longhorn，包括 Rancher、Kubectl 和 Helm。有关安装方法和要求的更多信息，请参阅 Longhorn 文档中的 快速安装。

升级

[!IMPORTANT] 从 Longhorn v1.9.x 升级到 v1.10.2 前，请确保您的集群运行 Kubernetes v1.25 或更高版本。

Longhorn 仅允许从受支持的版本升级。有关升级路径和过程的更多信息，请参阅 Longhorn 文档中的 升级。

发布后已知问题

有关此版本发布后发现的问题信息，请参阅 发布已知问题。

已解决的问题

功能

  • [BACKPORT][v1.10.2][FEATURE] 在快速故障转移模式下为 longhorn-share-manager 继承命名空间 12245 - @yangchiu
  • [BACKPORT][v1.10.2][FEATURE] [依赖] aws-sdk-go v1.55.7 将于 2025-07-31 停止支持 — 计划迁移到 v2？ 12181 - @mantissahz @roger-ryao

改进

  • [BACKPORT][v1.10.2][IMPROVEMENT] 修复由 VolumeAttachment Webhook 阻塞导致的 V2 卷 CSI 克隆缓慢问题 12329 - @PhanLe1010 @roger-ryao

错误

  • [BACKPORT][v1.10.2][BUG] 没有硬盘或固态硬盘的节点上的 instance-manager 通过 TXT 查询 _grpc_config.localhost 向集群 DNS 服务器发送大量请求 12536 - @COLDTURNIP @chriscchien
  • [BACKPORT] 副本重建、克隆和恢复失败，流量被发送到 HTTP 代理 12518 - @yangchiu @derekbit
  • [BACKPORT][v1.10.2][BUG] 减少卷的副本数后，健康副本可能被意外删除 12512 - @yangchiu @shuo-wu
  • [BACKPORT][v1.10.2][BUG] 启用数据本地性的卷在减少副本数后无法移除现有的正在运行的副本 12509 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] 系统备份可能无法创建或删除 12479 - @yangchiu @mantissahz
  • [BACKPORT][v1.10.2][BUG] questions.yaml 中的一些默认设置位置不正确 12222 - @derekbit @roger-ryao
  • [BACKPORT][v1.10.2][BUG] 自动平衡功能可能导致卷陷入副本删除-重建循环 12482 - @shuo-wu @roger-ryao
  • [BACKPORT][v1.10.2][BUG] 单副本卷在副本节点重启后可能陷入附加/分离循环 12494 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.10.2][BUG] 潜在的实例管理器客户端上下文泄漏 12200 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] SnapshotBack 代理请求可能被发送到错误的实例管理器 Pod 12476 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] 节点 CR 中未知的操作系统状态在升级期间未被正确移除 12451 - @COLDTURNIP @roger-ryao
  • [BACKPORT][v1.10.2][BUG] 节点排空后 RWX 卷变得不可用 12231 - @yangchiu @mantissahz
  • [BACKPORT][v1.10.2][BUG] 在 CSI 节点发布卷期间挂载错误未得到正确处理 12382 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.10.2][BUG] 加密卷无法在线扩展 12368 - @yangchiu @mantissahz
  • [BACKPORT][v1.10.2][BUG] 自动生成的后备镜像 Pod 名称被 kubelet 报错 12357 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.10.2][BUG] tests.test_cloning.test_cloning_basic 在 master-head 上失败 12342 - @c3y1huang
  • [BACKPORT][v1.10.2][Bug] 克隆卷无法附加到工作负载 12208 - @yangchiu @PhanLe1010
  • [BACKPORT][v1.10.2][BUG] 块模式卷迁移卡住 12312 - @COLDTURNIP @yangchiu @shuo-wu
  • [BACKPORT][v1.10.2][BUG] 副本自动平衡磁盘压力阈值因已停止的卷而停滞 12334 - @c3y1huang @chriscchien
  • [BACKPORT][v1.10.2][BUG] 短名称模式被强制执行，但镜像名称 longhornio/longhorn-manager:v1.10. │ │ 0 返回了歧义列表 12270 - @yangchiu
  • [BACKPORT][v1.10.2][BUG] 引擎升级期间副本累积 12115 - @c3y1huang @chriscchien
  • [BACKPORT][v1.10.2][BUG] 潜在的后备镜像管理器客户端连接和上下文泄漏 12195 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] Longhorn 在自动平衡设置为 best-effort 时忽略了 副本节点级别软反亲和性 12251 - @c3y1huang @chriscchien
  • [BACKPORT][v1.10.2][BUG] 无效内存地址或空指针引用（再次出现） 12234 - @chriscchien @bachmanity1
  • [BACKPORT][v1.10.2][BUG] 在 Web UI 中使用 OIDC 认证时请求头或 Cookie 过大 12213 - @chriscchien @houhoucoop

贡献者

  • @COLDTURNIP
  • @PhanLe1010
  • @bachmanity1
  • @c3y1huang
  • @chriscchien
  • @derekbit
  • @forbesguthrie
  • @houhoucoop
  • @innobead
  • @mantissahz
  • @rebeccazzzz
  • @roger-ryao
  • @shuo-wu
  • @sushant-suse
  • @yangchiu

更新内容 （原始）

Longhorn v1.10.2 Release Notes

Longhorn 1.10.2 introduces several improvements and bug fixes that are intended to improve system quality, resilience, stability and security.

We welcome feedback and contributions to help continuously improve Longhorn.

For terminology and context on Longhorn releases, see Releases.

[!WARNING]

HotFix

The backing-image-manager:v1.10.2 image is affected by

To mitigate the issues, replace backing-image-manager:v1.10.2 with the hotfixed image backing-image-manager:v1.10.2-hotfix-1.

Follow these steps to apply the update:

  1. Update the backing-image-manager image

    • Change the image tag from v1.10.2 to v1.10.2-hotfix-1 in the appropriate file:
      • For Helm: Update values.yaml
      • For manifests: Update the deployment manifest directly.

  2. Proceed with the upgrade

  • Apply the changes using your standard Helm upgrade command or reapply the updated manifest.

Important Fixes

This release includes several critical stability fixes.

RWX Volume Unavailable After Node Drain

Fixed a race condition where ReadWriteMany (RWX) volumes could remain in the attaching state after node drains, causing workloads to become unavailable.

For more details, see Issue #12231.

Encrypted Volume Cannot Be Expanded Online

Fixed an issue where online expansion of encrypted volumes did not propagate the new size to the dm-crypt device.

For more details, see Issue #12368.

Cloned Volume Cannot Be Attached to Workload

Fixed a bug where cloned volumes could fail to reach a healthy state, preventing attachment to workloads.

For more details, see Issue #12208.

Block Mode Volume Migration Stuck

Fixed a regression in block-mode volume migrations where newly created replicas could incorrectly inherit the lastFailedAt timestamp from source replicas, causing repeated deletion and blocking migration completion.

For more details, see Issue #12312.

Replica Auto Balance Disk Pressure Threshold Stalled

Fixed an issue where replica auto-balance under disk pressure could be blocked if stopped volumes were present on the disk.

For more details, see Issue #12334.

Replicas Accumulate During Engine Upgrade

Fixed a bug where temporary replicas could accumulate during engine upgrade. High etcd latency could cause new replicas to fail verification, leading to accumulation over multiple reconciliation cycles.

For more details, see Issue #12115.

Potential Client Connection and Context Leak

Fixed potential context leaks in the instance manager client and backing image manager client, improving stability and preventing resource exhaustion.

For more details, see Issue #12200 and Issue #12195.

Replica Node Level Soft Anti-Affinity Ignored

Fixed a bug of replica scheduling loop where replicas could be scheduled onto nodes that already host a replica, even when Replica Node-Level Soft Anti-Affinity was disabled.

For more details, see Issue #12251.

Installation

[!IMPORTANT] Ensure that your cluster is running Kubernetes v1.25 or later before installing Longhorn v1.10.2.

You can install Longhorn using a variety of tools, including Rancher, Kubectl, and Helm. For more information about installation methods and requirements, see Quick Installation in the Longhorn documentation.

Upgrade

[!IMPORTANT] Ensure that your cluster is running Kubernetes v1.25 or later before upgrading from Longhorn v1.9.x to v1.10.2.

Longhorn only allows upgrades from supported versions. For more information about upgrade paths and procedures, see Upgrade in the Longhorn documentation.

Post-Release Known Issues

For information about issues identified after this release, see Release-Known-Issues.

Resolved Issues

Feature

  • [BACKPORT][v1.10.2][FEATURE] Inherit namespace for longhorn-share-manager in FastFailover mode 12245 - @yangchiu
  • [BACKPORT][v1.10.2][FEATURE] [Dependency] aws-sdk-go v1.55.7 is EOL as of 2025-07-31 — plan to migrate to v2? 12181 - @mantissahz @roger-ryao

Improvement

  • [BACKPORT][v1.10.2][IMPROVEMENT] Fix V2 Volume CSI Clone Slowness Caused by VolumeAttachment Webhook Blocking 12329 - @PhanLe1010 @roger-ryao

Bug

  • [BACKPORT][v1.10.2][BUG] instance-manager on nodes that don’t have hard or solid state disk DDOSing cluster DNS server with TXT query _grpc_config.localhost 12536 - @COLDTURNIP @chriscchien
  • [BACKPORT] Replica rebuild, clone and restore fail, traffic being sent to HTTP proxy 12518 - @yangchiu @derekbit
  • [BACKPORT][v1.10.2][BUG] Healthy replica could be deleted unexpectedly after reducing volume’s number of replicas 12512 - @yangchiu @shuo-wu
  • [BACKPORT][v1.10.2][BUG] Data locality enabled volume fails to remove an existing running replica after numberOfReplicas reduced 12509 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] System backup may fail to be created or deleted 12479 - @yangchiu @mantissahz
  • [BACKPORT][v1.10.2][BUG] Some default settings in questions.yaml are placed incorrectly. 12222 - @derekbit @roger-ryao
  • [BACKPORT][v1.10.2][BUG] Auto balance feature may lead to volumes falling into a replica deletion-recreation loop 12482 - @shuo-wu @roger-ryao
  • [BACKPORT][v1.10.2][BUG] Single replica volume could get stuck in attaching/detaching loop after the replica node rebooted 12494 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.10.2][BUG] Potential Instance Manager Client Context Leak 12200 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] SnapshotBack proxy request might be sent to incorrect instance-manager pod 12476 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] unknown OS condition in node CR is not properly removed during upgrade 12451 - @COLDTURNIP @roger-ryao
  • [BACKPORT][v1.10.2][BUG] RWX volume becomes unavailable after drain node 12231 - @yangchiu @mantissahz
  • [BACKPORT][v1.10.2][BUG] mounting error is not properly hanedled during CSI node publish volume 12382 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.10.2][BUG] Encrypted Volume Cannot Be Expanded Online 12368 - @yangchiu @mantissahz
  • [BACKPORT][v1.10.2][BUG] The auo generated backing image pod name is complained by kubelet 12357 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.10.2][BUG] tests.test_cloning.test_cloning_basic fails at msater-head 12342 - @c3y1huang
  • [BACKPORT][v1.10.2][Bug] A cloned volume cannot be attached to a workload 12208 - @yangchiu @PhanLe1010
  • [BACKPORT][v1.10.2][BUG] Block Mode Volume Migration Stuck 12312 - @COLDTURNIP @yangchiu @shuo-wu
  • [BACKPORT][v1.10.2][BUG] Replica auto balance disk pressure threshold stalled with stopped volumes 12334 - @c3y1huang @chriscchien
  • [BACKPORT][v1.10.2][BUG] short name mode is enforcing, but image name longhornio/longhorn-manager:v1.10. │ │ 0 returns ambiguous list 12270 - @yangchiu
  • [BACKPORT][v1.10.2][BUG] Replicas accumulate during engine upgrade 12115 - @c3y1huang @chriscchien
  • [BACKPORT][v1.10.2][BUG] Potential BackingImageManagerClient Connection and Context Leak 12195 - @derekbit @chriscchien
  • [BACKPORT][v1.10.2][BUG] Longhorn ignores Replica Node Level Soft Anti-Affinity when auto balance is set to best-effort 12251 - @c3y1huang @chriscchien
  • [BACKPORT][v1.10.2][BUG] invalid memory address or nil pointer dereference (again) 12234 - @chriscchien @bachmanity1
  • [BACKPORT][v1.10.2][BUG] Request Header Or Cookie Too Large in Web UI with OIDC auth 12213 - @chriscchien @houhoucoop

Contributors

  • @COLDTURNIP
  • @PhanLe1010
  • @bachmanity1
  • @c3y1huang
  • @chriscchien
  • @derekbit
  • @forbesguthrie
  • @houhoucoop
  • @innobead
  • @mantissahz
  • @rebeccazzzz
  • @roger-ryao
  • @shuo-wu
  • @sushant-suse
  • @yangchiu

下载链接