发布日期: 2026-07-01
版本号: v1.11.3

Longhorn v1.11.3版本引入了多项改进和错误修复，旨在提升系统质量、弹性、稳定性和安全性。该版本包含几个关键稳定性修复：解决了iscsid重启后卷操作可能卡住或失败的问题；修复了副本重建过程中实例管理器的空指针引用崩溃；解决了迁移引擎在目标节点就绪转换期间可能被意外删除的问题；以及修复了可能导致周期性修剪作业失败的死锁。安装和升级此版本需要确保集群运行在Kubernetes v1.34或更高版本，因为CSI外部供应器已升级至v6.3.0。该版本还包含其他多项功能改进和错误修复。

更新内容 （中文）

Longhorn v1.11.3 发布说明

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

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

关于 Longhorn 发布的术语和背景，请参阅 发布版本。

重要修复

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

iscsid 重启后 V1 卷不可操作的修复

解决了因 iscsid 重启导致卷操作可能卡住或失败（包括 PVC 扩容失败）的问题。

更多详情，请参阅 #13411、#13413 和 #13383。

副本重建稳定性修复

修复了 longhorn-instance-manager 在副本重建期间发生的空指针解引用 panic，提升了故障条件下的重建稳定性。

更多详情，请参阅 #13129。

迁移引擎就绪状态转换修复

解决了当目标节点仍在转换为就绪状态时，迁移引擎可能被意外删除的问题，该问题可能中断迁移工作流。

更多详情，请参阅 #13133。

循环修剪作业死锁修复

解决了可能导致循环修剪作业失败的死锁问题。

更多详情，请参阅 #13424。

安装

[!IMPORTANT] 由于 CSI 外部供应器升级到 v6.3.0，在安装 Longhorn v1.11.3 之前，请确保您的集群运行的是 Kubernetes v1.34 或更高版本。

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

升级

[!IMPORTANT] 由于 CSI 外部供应器升级到 v6.3.0，在从 Longhorn v1.10.x 或 v1.11.0 升级到 v1.11.3 之前，请确保您的集群运行的是 Kubernetes v1.34 或更高版本。

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

发布后已知问题

有关此版本发布后发现的问题信息，请参阅 Release-Known-Issues。

本次发布中解决的问题

改进

  • [BACKPORT][v1.11.3][IMPROVEMENT] 长期运行时 longhorn-manager pods 在 webhook TLS Secret 上存在竞争条件 13116 - @yangchiu @hookak
  • [BACKPORT][v1.11.3][IMPROVEMENT] 添加指标以收集关于 LONGHORN_DISTRO 的信息 13283 - @derekbit @chriscchien

缺陷

  • [BACKPORT][v1.11.3][BUG] 卷扩容卡住 13411 - @shuo-wu @roger-ryao
  • [BACKPORT][v1.11.3][BUG] iscsid 重启后 pvc resize 失败 13413 - @yangchiu @shuo-wu
  • [BACKPORT][v1.11.3][BUG] 扩展卷失败 13383 - @chriscchien
  • [BACKPORT][v1.11.3][BUG] 如果目标节点仍在就绪状态转换中，迁移引擎可能被意外删除 13133 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.11.3][BUG] 系统备份 RecurringJob 保留策略错误地删除了最新的 CR——按 Status.CreatedAt 排序（Error/racing CRs 为零） 13211 - @roger-ryao
  • [BACKPORT][v1.11.3][BUG] 将备份上传到 S3 存储（NetApp 设备）时失败 13296 - @mantissahz
  • [BACKPORT][v1.11.3][BUG] chart/values.yaml 中缺少 spdk interrupt mode 值 13270 - @yangchiu
  • [BACKPORT][v1.11.3][BUG] instance-manager 在副本重建期间发生空指针解引用 panic 13129 - @derekbit @shuo-wu @roger-ryao
  • [BACKPORT][v1.11.3][BUG] 测试加密卷升级：旧引擎 RWO 卷扩容至 2 GiB 后显示 1008 MiB，而非预期的 2032 MiB 13200 - @derekbit @mantissahz @roger-ryao
  • [BACKPORT][v1.11.3][BUG] support bundle 状态轮询和 webhook 就绪检查中存在 HTTP 响应体泄漏 13124 - @derekbit @roger-ryao
  • [BACKPORT][v1.11.3][BUG] global.cattle.systemDefaultRegistry 在 108.2.1+up1.10.2 中未作为镜像仓库前缀应用 13099 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.11.3][BUG] [longhorn-engine/dataserver] 健壮地处理 io.ReadFull 返回的 EOF 13080 - @yangchiu
  • [BACKPORT][v1.11.3][BUG] 指标 longhorn_rest_client_rate_limiter_latency_seconds_bucket 的 PrometheusTimeseriesCardinality 13088 - @derekbit
  • [BACKPORT][v1.11.3][BUG] 循环修剪作业因死锁失败 13424 - @c3y1huang @roger-ryao

稳定性

  • [BACKPORT][v1.11.3][BUG] longhorn-manager 在备份删除期间 BackupController.setInprogressDeletionMap 中发生 panic 13247 - @roger-ryao

杂项

  • [BACKPORT][v1.11.3][TASK] 在升级响应器请求中添加发行版信息 13278 - @davidcheng0922 @roger-ryao

贡献者

  • @COLDTURNIP
  • @chriscchien
  • @davidcheng0922
  • @derekbit
  • @hookak
  • @innobead
  • @mantissahz
  • @roger-ryao
  • @shuo-wu
  • @yangchiu
  • @c3y1huang
  • @rebeccazzzz
  • @forbesguthrie
  • @asettle

更新内容 （原始）

Longhorn v1.11.3 Release Notes

Longhorn 1.11.3 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.

Important Fixes

This release includes several critical stability fixes.

V1 volumes not operable fix after iscsid restart

Resolved the issue caused by the iscsid restart where volume operations could become stuck or fail, including PVC resize failures.

For more details, see #13411, #13413, and #13383.

Replica rebuild stability fix

Fixed a nil pointer dereference panic in longhorn-instance-manager during replica rebuild, improving rebuild stability under failure conditions.

For more details, see #13129.

Migration engine readiness transition fix

Resolved an issue where the migration engine could be unexpectedly deleted while the target node was still transitioning to ready, which could interrupt migration workflows.

For more details, see #13133.

Recurring trim job deadlock fix

Resolved a deadlock that could cause recurring trim jobs to fail.

For more details, see #13424.

Installation

[!IMPORTANT] Due to the upgrade of the CSI external provisioner to v6.3.0, ensure that your cluster is running Kubernetes v1.34 or later before installing Longhorn v1.11.3.

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] Due to the upgrade of the CSI external provisioner to v6.3.0, ensure that your cluster is running Kubernetes v1.34 or later before upgrading from Longhorn v1.10.x or v1.11.0 to v1.11.3.

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 in this release

Improvement

  • [BACKPORT][v1.11.3][IMPROVEMENT] longhorn-manager pods race on webhook TLS Secret at scale 13116 - @yangchiu @hookak
  • [BACKPORT][v1.11.3][IMPROVEMENT] Add metrics to collect information about LONGHORN_DISTRO 13283 - @derekbit @chriscchien

Bug

  • [BACKPORT][v1.11.3][BUG] volume expansion stuck 13411 - @shuo-wu @roger-ryao
  • [BACKPORT][v1.11.3][BUG] pvc resize fails after iscsid restart 13413 - @yangchiu @shuo-wu
  • [BACKPORT][v1.11.3][BUG] expanding the volume fails 13383 - @chriscchien
  • [BACKPORT][v1.11.3][BUG] Migration Engine Can Be Unexpectedly Deleted If the Target Node Is Still in Readiness Transition 13133 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.11.3][BUG] System Backup RecurringJob retention prunes newest CR — sorts by Status.CreatedAt (zero for Error/racing CRs) 13211 - @roger-ryao
  • [BACKPORT][v1.11.3][BUG] when uploading backup to S3 storage (NetApp appliance) it fails 13296 - @mantissahz
  • [BACKPORT][v1.11.3][BUG] spdk interrupt mode value is missing in chart/values.yaml 13270 - @yangchiu
  • [BACKPORT][v1.11.3][BUG] nil pointer dereference panic in instance-manager during replica rebuild. 13129 - @derekbit @shuo-wu @roger-ryao
  • [BACKPORT][v1.11.3][BUG] Test Encrypted Volume Upgrade: Old-engine RWO volume shows 1008 MiB after expansion to 2 GiB instead of expected 2032 MiB 13200 - @derekbit @mantissahz @roger-ryao
  • [BACKPORT][v1.11.3][BUG] HTTP response body leaks in support bundle status polling and webhook readiness checks 13124 - @derekbit @roger-ryao
  • [BACKPORT][v1.11.3][BUG] global.cattle.systemDefaultRegistry is not applied as the image registry prefix in 108.2.1+up1.10.2 13099 - @COLDTURNIP @yangchiu
  • [BACKPORT][v1.11.3][BUG] [longhorn-engine/dataserver] Handling EOF returned by io.ReadFull robustly 13080 - @yangchiu
  • [BACKPORT][v1.11.3][BUG] PrometheusTimeseriesCardinality for metric longhorn_rest_client_rate_limiter_latency_seconds_bucket 13088 - @derekbit
  • [BACKPORT][v1.11.3][BUG] Recurring trim job fails with deadlock 13424 - @c3y1huang @roger-ryao

Stability

  • [BACKPORT][v1.11.3][BUG] longhorn-manager panic in BackupController.setInprogressDeletionMap during backup deletion 13247 - @roger-ryao

Misc

  • [BACKPORT][v1.11.3][TASK] Add distro information to upgrade responder requests 13278 - @davidcheng0922 @roger-ryao

Contributors

  • @COLDTURNIP
  • @chriscchien
  • @davidcheng0922
  • @derekbit
  • @hookak
  • @innobead
  • @mantissahz
  • @roger-ryao
  • @shuo-wu
  • @yangchiu
  • @c3y1huang
  • @rebeccazzzz
  • @forbesguthrie
  • @asettle

下载链接