发布日期: 2026-01-15
版本号: v1.11.0-rc2

此次Longhorn更新警告：严禁从任何RC/预览版或冲刺版进行升级或降级，因为此操作不受支持。本次版本主要亮点包括：支持通过多个健康副本加速副本重建、为Longhorn卷增加StorageClass拓扑支持、支持ReadWriteOncePod访问模式、为共享管理器Pod增加额外网络接口、新增节点磁盘健康监控以及基于磁盘空间消耗实现副本跨节点自动平衡。功能上新增了自动识别Linux发行版、Helm图表支持自定义管理器URL、增加卷最后备份指标、实时卷性能监控等多项特性，并对UI、部署策略、资源限制、错误日志和升级流程进行了大量改进，以提升稳定性与易用性。修复了大量问题，涉及v1和v2数据引擎、副本重建与自动平衡、灾难恢复卷状态、系统备份、节点重启后的恢复、UI交互以及安装部署等多个方面，显著提升了系统的可靠性。此外，还更新了相关文档、依赖项和基础镜像，并进行了代码重构。本次更新由众多社区成员共同参与完成。

更新内容 （中文）

切勿从任何RC/Preview/Sprint版本升级到此版本或从此版本升级，因为此操作不受支持。

本版本已修复的问题

亮点

  • [功能] 扩展从多个健康副本重建副本的速度 11331 - @derekbit @shuo-wu @roger-ryao @Copilot
  • [功能] 支持Longhorn卷的StorageClass allowedTopologies 12261 - @yangchiu @derekbit @hookak @Copilot
  • [功能] 新增ReadWriteOncePod访问模式支持 9727 - @shikanime @chriscchien
  • [功能] 在share manager pod上支持额外网络接口（不仅是存储网络） 10269 - @yangchiu @c3y1huang
  • [功能] 监控节点磁盘健康状况 12016 - @c3y1huang @roger-ryao
  • [功能] 基于节点磁盘空间使用情况自动跨节点平衡副本 10512 - @davidcheng0922 @chriscchien

功能

  • [功能] 从包管理器猜测Linux发行版 12153 - @yangchiu @NamrathShetty
  • [功能] 提供Helm chart设置以定义managerUrl 10583 - @lexfrei @yangchiu
  • [功能] 新增卷最后备份的指标 6049 - @c3y1huang @roger-ryao
  • [功能] 实时卷性能监控 368 - @derekbit @hookak
  • [UI][功能] 监控节点磁盘健康状况 12263 - @houhoucoop @roger-ryao
  • [功能] 在helm chart的value.yaml中自定义UI k8s服务的annotation/label 11754 - @yangchiu @lucasl0st
  • [功能] 使longhornctl在内核版本为6或更新时加载ublk_drv模块 11803 - @chriscchien @bachmanity1
  • [缺陷] 在快速故障转移模式下为longhorn-share-manager继承命名空间 12244 - @yangchiu @semenas
  • [功能] 启用CSI pod反亲和性预设更新 12100 - @yangchiu @yulken
  • [功能] [依赖] aws-sdk-go v1.55.7 于2025-07-31结束生命周期 — 计划迁移到v2？ 12098 - @mantissahz @roger-ryao
  • [功能] 将卷操作菜单按钮行为从悬停更改为点击 11408 - @yangchiu @houhoucoop
  • [功能] 为csi-attacher/csi-provisioner/csi-resizer/csi-snapshotter设置"硬性"podAntiAffinity 11617 - @yangchiu @yulken
  • [功能] 节点存储调度指标 11949 - @yangchiu @AoRuiAC

改进

  • [改进] 泛化离线重建设置以同时支持两种数据引擎 12484 - @mantissahz
  • [改进] 改进磁盘错误日志记录以保留来自newDiskServiceClients()的错误 12446 - @yangchiu @davidcheng0922
  • [改进] 将longhorn-manager的时区传播到instance-manager和CSI pod 12448 - @hookak @roger-ryao
  • [UI][功能] 扩展从多个健康副本重建副本的速度 12461 - @houhoucoop @roger-ryao
  • [改进] 为longhorn-manager和CSI部署配置滚动更新策略 12240 - @hookak @chriscchien
  • [改进] 改进lonbghorn-manager中rebuildNewReplica()的日志消息 12426 - @derekbit @chriscchien
  • [改进] instance manager尝试创建pod时的误导性消息 11759 - @mantissahz @chriscchien
  • [改进] 为提高调试过程和用户体验，最好将错误记录在instancemanager.status.conditions中 6732 - @mantissahz @chriscchien
  • [改进] 新增设置以禁用节点磁盘健康监控 12300 - @derekbit @roger-ryao @Copilot
  • [改进] 迁移期间存在不可用副本时避免重复重启引擎 11397 - @yangchiu @shuo-wu
  • [改进] [脚本] 来自PR #12177的脚本小调整 12187 - @rauldsl @yangchiu
  • [改进] 生成K8s代码前检查工具链版本 12164 - @derekbit @roger-ryao
  • [改进] 创建卷UI改进，根据v1或v2选择自动过滤数据源 11846 - @yangchiu @houhoucoop
  • [改进] 禁用v1卷删除时的快照哈希 10294 - @davidcheng0922 @chriscchien
  • [改进] 公开SPDK UBLK参数 11039 - @PhanLe1010 @roger-ryao
  • [改进] 创建磁盘前检查块设备是否未在使用中 12078 - @chriscchien @bachmanity1
  • [UI][改进] 感知单个卷何时触发离线副本重建 11247 - @houhoucoop @roger-ryao
  • [改进] 确保longhorn-manager和instance-manager之间的同步升级 12309 - @hookak @chriscchien
  • [改进] 为longhorn manager/instance-manager添加资源限制配置 12225 - @hookak @chriscchien
  • [改进] 为节点磁盘已满时的卷扩展添加验证Webhook 12134 - @yangchiu @davidcheng0922
  • [UI][改进] 公开SPDK UBLK参数 12166 - @houhoucoop @roger-ryao
  • [改进] 修复由于VolumeAttachment Webhook阻塞导致的V2卷CSI克隆缓慢问题 12328 - @PhanLe1010 @roger-ryao
  • [改进] 在指标中使用基于标签的状态而非数值 10723 - @hookak @roger-ryao
  • [改进] 为CSI组件添加资源限制配置 12224 - @yangchiu @hookak @Copilot
  • [改进] 感知单个卷何时触发离线副本重建 11246 - @yangchiu @mantissahz
  • [改进] 为快照操作引入并发作业限制 11635 - @yangchiu @davidcheng0922
  • [改进] 在helm chart的UI服务中添加loadBalancerClass值 12273 - @ehpc @chriscchien
  • [改进] 为S3地址池添加DNS轮询负载均衡 12296 - @yangchiu
  • [UI][改进] 不应在UI上隐藏已删除的快照 11620 - @yangchiu @houhoucoop
  • [改进] Helm chart支持多个TLS FQDN 12127 - @yangchiu @hrabalvojta
  • [改进] 从mirrored-longhornio-longhorn-engine镜像中移除可执行文件 11254 - @derekbit @chriscchien
  • [改进] [文档] 澄清非健康和分离卷的副本自动平衡行为 12002 - @roger-ryao @sushant-suse
  • [改进] CRD枚举值 9718 - @roger-ryao @nzhan126
  • [文档] 故障排除KB文章修复错别字 12199 - @jmeza-xyz
  • [改进] 移除backupstore相关设置 11026 - @nzhan126
  • [改进] 拒绝对块卷执行Trim操作 12048 - @yangchiu @derekbit
  • [改进] 将github.com/pkg/errors替换为github.com/cockroachdb/errors 11413 - @derekbit @chriscchien
  • [UI][改进] UI显示背景镜像虚拟大小 11674 - @chriscchien @houhoucoop
  • [改进] 简化unsub和stream方法中的锁定 12057 - @derekbit @NamrathShetty
  • [UI][改进] 为无法调度的磁盘显示错误消息 11449 - @yangchiu @houhoucoop
  • [改进] auto-delete-pod-when-volume-detached-unexpectedly应仅关注kubernetes内置工作负载 12120 - @derekbit @chriscchien @sushant-suse
  • [改进] CSIStorageCapacity对象必须显示可调度（可分配）容量 12014 - @chriscchien @bachmanity1
  • [改进] 改进节点发布卷期间挂载失败的错误日志记录 10205 - @COLDTURNIP @roger-ryao
  • [改进] 改进Helm Chart defaultSettings处理，支持自动引号和多类型 12019 - @derekbit @chriscchien
  • [改进] 卷spec.backingImage和spec.encrypted不应允许对v1和v2数据引擎进行更新 11615 - @yulken @roger-ryao

缺陷

  • [缺陷] 启用快照完整性后v2卷重建性能未提高 12416 - @davidcheng0922
  • [缺陷] 自动平衡功能可能导致卷陷入副本删除-重建循环 11730 - @shuo-wu @roger-ryao
  • [缺陷] 潜在的Instance Manager客户端上下文泄漏 12198 - @derekbit @chriscchien
  • [缺陷] 如果卷附加节点在恢复期间重启，v2 DR卷可能变为故障状态且无法从备份恢复 12412 - @c3y1huang @chriscchien
  • [缺陷] 系统备份可能无法创建或删除 12472 - @yangchiu @mantissahz
  • [缺陷] v1.11.x升级测试可能失败，因为在测试用例期间节点的默认磁盘被移除且无法重新添加 12469 - @COLDTURNIP @yangchiu
  • [缺陷] 源卷扩展后v2 DR卷在增量恢复期间变为故障状态 12465 - @yangchiu @davidcheng0922
  • [缺陷] SnapshotBack代理请求可能发送到错误的instance-manager pod 12475 - @derekbit @chriscchien
  • [缺陷] 当值为0时，rebuildConcurrentSyncLimit字段从volume.spec中省略 12471 - @derekbit @houhoucoop @roger-ryao
  • [缺陷] 并发向同一节点添加多个磁盘可能偶尔失败 11971 - @davidcheng0922 @roger-ryao
  • [缺陷] 节点CR中未知的OS状态在升级期间未正确移除 12450 - @COLDTURNIP @roger-ryao
  • [缺陷] Longhorn charts未考虑时区 11965 - @hookak @roger-ryao
  • [缺陷] Pod无法使用已激活的DR卷，出现UNEXPECTED INCONSISTENCY; RUN fsck MANUALLY错误 12444 - @yangchiu
  • [缺陷] v2卷未按预期重用失败的副本进行重建 12413 - @yangchiu @shuo-wu
  • [缺陷] 如果节点在重建期间重启，v2卷会完成离线重建但带有一个额外的失败副本 12407 - @yangchiu @mantissahz
  • [缺陷] 测试用例test_rebuild_failure_with_intensive_data失败，因为副本进程崩溃后无法重建副本 12436 - @yangchiu @shuo-wu
  • [缺陷] 从v1.10.1升级到master-head或v1.11.0-rc1后，副本模式变为空且无法触发副本重建 12431 - @yangchiu @derekbit
  • [缺陷] 节点重启后v2卷陷入Attaching/Detaching循环 12406 - @yangchiu @c3y1huang
  • [缺陷] 由于回滚快照失败，test_basic.py::test_expansion_basic在v2数据引擎上不稳定 12235 - @davidcheng0922 @chriscchien
  • [缺陷] Longhorn节点在节点重启后可能无法恢复 12422 - @COLDTURNIP @yangchiu
  • [缺陷] 通过Longhorn UI创建v2卷时缺少Frontend默认值 12152 - @houhoucoop @roger-ryao
  • [缺陷] Longhorn UI中设置值未转换为字符串 12192 - @chriscchien @houhoucoop
  • [缺陷] 磁盘健康信息短暂显示 12415 - @c3y1huang @roger-ryao
  • [缺陷] 加密的v2卷在卷扩展后陷入Attaching/Detaching循环 12359 - @yangchiu @davidcheng0922
  • [缺陷] 节点重启后意外创建孤立副本，阻止在该节点上调度新副本，并阻止v2卷恢复到健康状态 11333 - @yangchiu @c3y1huang
  • [缺陷] 疏散节点后RWX卷不可用 12226 - @yangchiu @mantissahz
  • [缺陷] 无效内存地址或空指针解引用 11939 - @bachmanity1 @roger-ryao
  • [缺陷] share-manager内存使用过多 11938 - @derekbit @chriscchien
  • [缺陷] 加密卷无法在线扩展 12366 - @yangchiu @chriscchien
  • [缺陷] 背景镜像下载在网络断开后卡住 11622 - @COLDTURNIP @chriscchien
  • [缺陷] 无法删除v2卷卷头快照的父级 9064 - @yulken @chriscchien
  • [缺陷] 卷控制器所有者更改导致：卷分离时检测到多个引擎的缺陷 1755 - @PhanLe1010 @chriscchien
  • [缺陷] CSI节点发布卷期间挂载错误未正确处理 12006 - @COLDTURNIP @yangchiu
  • [缺陷] test_rebuild_after_replica_file_crash在master-head上失败 12389 - @derekbit @chriscchien
  • [缺陷] 由于最近的提交，test_backing_image_auto_resync不稳定 12387 - @derekbit @chriscchien
  • [缺陷] longhorn-manager中泛滥的消息Failed to resolve sysfs path for \"/sys/class/block/root\" ... 12344 - @c3y1huang @roger-ryao
  • [缺陷] 集群重启后v2卷可能无法自动挽救 11336 - @yangchiu @c3y1huang
  • [缺陷] 自动生成的背景镜像pod名称被kubelet投诉 12356 - @COLDTURNIP @yangchiu
  • [缺陷] test_restore_inc_with_offline_expansion在v2数据引擎上失败 12313 - @davidcheng0922 @chriscchien
  • [缺陷] 块磁盘在v2回归测试test_rebuild_with_restoration中可能变为无法调度 11446 - @shuo-wu @chriscchien
  • [缺陷] v2卷工作负载FailedMount，消息为Staging target path /var/lib/kubelet/plugins/kubernetes.io/csi/driver.longhorn.io/xxx/globalmount is no longer valid 10476 - @yangchiu @shuo-wu
  • [缺陷] [v1.10.0-rc1] 带副本删除的增量恢复后v2 DR卷卡在不健康状态（test_rebuild_with_inc_restoration） 11684 - @c3y1huang @chriscchien
  • [缺陷] test_data_locality_strict_local_node_affinity在master-head上失败 12343 - @derekbit @chriscchien
  • [缺陷] tests.test_cloning.test_cloning_basic在master-head上失败 12341 - @derekbit @chriscchien @Copilot
  • [缺陷] 节点重启后v2卷可能无限期卡在Detaching状态 11332 - @yangchiu @c3y1huang
  • [缺陷] 克隆的卷无法附加到工作负载 12206 - @yangchiu @PhanLe1010
  • [缺陷] 块模式卷迁移卡住 12311 - @COLDTURNIP @yangchiu @shuo-wu
  • [缺陷] 副本自动平衡磁盘压力阈值在卷停止时停滞 10837 - @c3y1huang @chriscchien
  • [缺陷] 短名称模式是强制性的，但镜像名longhornio/longhorn-manager:v1.10.0返回歧义列表 12268 - @yangchiu @Wqrld
  • [缺陷] 无效内存地址或空指针解引用（再次） 12233 - @chriscchien @bachmanity1
  • [缺陷] 如果备份在恢复期间被删除，恢复的v2卷卡在RestoreInProgress状态 11828 - @yangchiu @c3y1huang
  • [缺陷] spdk_tgt因SIGSEGV崩溃 11698 - @c3y1huang
  • [缺陷] 当自动平衡设置为best-effort时，Longhorn忽略Replica Node Level Soft Anti-Affinity 11189 - @c3y1huang @chriscchien
  • [缺陷] SPDK NVMe同步调用 11096 -
  • [缺陷] 引擎升级期间副本累积 12111 - @c3y1huang @chriscchien
  • [缺陷] questions.yaml中的某些默认设置放置不正确 12219 - @derekbit @roger-ryao
  • [缺陷] Chart未处理带尾随冒号的defaultSettings.taintToleration 12162 - @derekbit @chriscchien
  • [缺陷] 使用OIDC认证时Web UI中请求头或Cookie过大 12077 - @chriscchien @houhoucoop
  • [缺陷] 修复SPDK v25.05 CVE问题 11969 - @derekbit @roger-ryao
  • [缺陷] 潜在的BackingImageManagerClient连接和上下文泄漏 12194 - @derekbit @chriscchien
  • [缺陷] Instance manager pod awsIAMRoleArn注解消失 9923 - @yangchiu @mantissahz
  • [缺陷] Longhorn卸载后节点块类型磁盘无法解绑 9127 - @yangchiu @davidcheng0922
  • [缺陷] 从1.9.2升级到1.10.0后longhorn-manager启动失败 11864 - @derekbit @roger-ryao
  • [缺陷][UI] 创建卷/背景镜像时，更改数据引擎将重置副本数 11775 - @yangchiu @houhoucoop
  • [缺陷] 备份目标指标损坏 12073 - @mantissahz @roger-ryao
  • [缺陷] panic: runtime error: invalid memory address or nil pointer dereference [signal SIGSEGV: segmentation violation code=0x1 at longhorn-engine/pkg/controller/control.go:218 +0x2de 12081 - @liyimeng @roger-ryao
  • [缺陷] 由于剩余的backuptarget无法完成卸载 11934 - @mantissahz @roger-ryao
  • [缺陷] v2数据引擎中未找到NVME磁盘（无法找到BDF的设备） 11903 - @derekbit @roger-ryao
  • [缺陷] 周期性作业执行期间出现NPE错误 11925 - @yangchiu @shuo-wu
  • [缺陷] talos节点上v2卷创建失败 11910 - @c3y1huang @chriscchien
  • [缺陷] 如果从附加节点删除引擎镜像，DR卷卡在unknown状态 11995 - @yangchiu @shuo-wu
  • [缺陷] 如果其中一个节点上未部署引擎镜像，卷卡在attaching状态 11994 - @yangchiu @shuo-wu
  • [缺陷] 在v2 DR卷增量恢复期间重启附加节点，恢复未完成且激活无效 11778 - @yangchiu @c3y1huang
  • [缺陷] 标记disable-v2-data-engine=true后无法分离v2卷 11799 - @yangchiu @mantissahz
  • [缺陷] test_system_backup_and_restore测试用例在master-head上失败 11933 - @derekbit @chriscchien
  • [缺陷] 脚本中的Shebang重构可能导致兼容性问题 11815 - @NamrathShetty @chriscchien
  • [缺陷] longhorn-spdk-engine CI抱怨单元测试成功哈希系统创建的快照 11822 - @yangchiu @shuo-wu
  • [缺陷] RWX卷导致进程不可中断睡眠 11907 - @COLDTURNIP @chriscchien
  • [缺陷] 重新启用v2数据引擎后无法通过BDF重新添加块类型磁盘 11860 - @yangchiu @davidcheng0922
  • [缺陷] V2卷卡在卷附件（V2中断模式） 11816 - @c3y1huang
  • [缺陷] 使用v2数据引擎时instance-manager中的Goroutine泄漏 11959 - @PhanLe1010 @chriscchien
  • [缺陷] 如果缺少dataEngine参数，csi-provisioner静默创建CSIStorageCapacity失败 11906 - @yangchiu @bachmanity1
  • [缺陷][v1.8.x] 由于副本停止，v2卷在附加时卡住 10486 - @chriscchien
  • [缺陷] longhorn-engine的UI出现panic 11867 - @derekbit @chriscchien @Copilot
  • [缺陷] v2卷工作负载卡在ContainerCreating或Unknown状态，出现FailedMount错误 10111 - @yangchiu @shuo-wu
  • [缺陷] 如果活动副本数大于volume.spec.numberOfReplicas，卷无法升级 11825 - @yangchiu @derekbit
  • [缺陷] 在仅启用IPv4的v1.10.0版本节点上UI部署失败 11869 - @yangchiu @c3y1huang
  • [缺陷] 当前节点缺少引擎镜像时v2 DR卷无法自动重新附加 11772 - @chriscchien
  • [缺陷] 在附加节点标记disable-v2-data-engine并删除instance manager后v2卷行为不一致 11578 - @yangchiu

可扩展性

  • [文档] 在最佳实践部分添加卷大小指南 12203 - @mantissahz @sushant-suse

其他

  • [任务] 修复v2数据引擎不稳定回归测试用例test_recurring_job.py::test_recurring_job_snapshot_cleanup 12464 - @derekbit @chriscchien
  • [文档] 审查和更新Longhorn UI的Ingress Controller示例 12252 - @yangchiu @sushant-suse
  • [文档] 为RWX卷分离失败添加KB文章 12238 - @sushant-suse
  • [文档] 错误的longhornctl子命令 12423 - @chriscchien @roger-ryao
  • [任务] 将nvme和libnvme更新到v2.16和v1.16.1 12391 - @derekbit @chriscchien
  • [文档] 磁盘聚合选项 12378 - @davidcheng0922 @roger-ryao
  • [任务] 弃用V2背景镜像功能 12237 - @derekbit @chriscchien
  • 功能(chart)：为Longhorn UI添加Gateway API HTTPRoute支持 12299 - @lexfrei @chriscchien
  • [文档] V2数据引擎：删除volume-head后的快照与v1行为不一致 12355 - @chriscchien @sushant-suse
  • [任务] 将基础镜像bci-base:16.0回退到bci-base:15.7 12354 - @derekbit @chriscchien
  • [文档] 澄清系统升级后附加RWX卷的share-manager镜像更新行为 12363 - @derekbit @chriscchien
  • [文档] 澄清实时引擎升级后旧instance manager pod的预期行为 12361 - @derekbit @chriscchien
  • [任务] 将Longhorn v1.11.0 SPDK更新到v25.09 11975 - @derekbit @chriscchien
  • [任务] 将Longhorn组件registry.suse.com/bci/bci-base升级到16.0 12145 - @derekbit @chriscchien
  • [文档] 添加KB文章：通过磁盘隔离处理持续性副本故障 12242 - @derekbit @roger-ryao
  • [文档] 记录如何永久启用大页内存 12167 - @roger-ryao @sushant-suse
  • [文档] 更新现有术语并添加新术语 12302 - @sushant-suse
  • [文档] 添加从孤立副本目录恢复数据的KB 9972 - @yangchiu @sushant-suse
  • [文档] [UI][改进] 不应在UI上隐藏已删除的快照 #11620 12214 - @chriscchien @sushant-suse
  • [文档] 在Longhorn官方文档中添加企业页面 12110 - @sushant-suse
  • [文档] 更新Talos Linux与Longhorn的支持 12108 - @roger-ryao @egrosdou01
  • [文档] [功能] 新增ReadWriteOncePod访问模式支持 12228 - @chriscchien
  • [文档] 背景镜像管理器磁盘UUID冲突问题的变通KB文档 12114 - @COLDTURNIP @roger-ryao
  • [任务] 从备份目标清单示例中移除测试凭证 11076 - @davidcheng0922 @roger-ryao
  • [文档] 在官方文档中记录可迁移RWX卷 11277 - @derekbit @chriscchien @sushant-suse
  • [文档][UI][改进] 为无法调度的磁盘显示错误消息 #11449 12151 - @yangchiu @sushant-suse
  • [任务] 创建GitHub Action以更新longhorn/dev-versions中的版本 12062 - @derekbit
  • [文档] 更新NFSv4客户端安装文档以验证实际使用的NFS版本 11944 - @derekbit @chriscchien
  • [重构] UI组件的SAST检查 11540 - @sminux @chriscchien
  • [文档] 更新Longhorn README文件 10891 - @divya-mohan0209
  • [缺陷] 块磁盘删除失败且无错误消息 11952 - @davidcheng0922 @roger-ryao
  • [重构] 移除冗余赋值 11705 - @jvanz
  • [任务] 从instance manager CR中移除已弃用的instances字段和实例类型 5844 - @derekbit @chriscchien
  • [文档] 根据文档版本更新部署链接 11847 - @yulken
  • [问题] 如何通过CR回滚创建的快照 11320 -

贡献者

  • @AoRuiAC
  • @COLDTURNIP
  • @Copilot
  • @NamrathShetty
  • @PhanLe1010
  • @Wqrld
  • @bachmanity1
  • @c3y1huang
  • @chriscchien
  • @davidcheng0922
  • @derekbit
  • @divya-mohan0209
  • @egrosdou01
  • @ehpc
  • @hookak
  • @houhoucoop
  • @hrabalvojta
  • @innobead
  • @jmeza-xyz
  • @jvanz
  • @lexfrei
  • @liyimeng
  • @lucasl0st
  • @mantissahz
  • @nzhan126
  • @rauldsl
  • @roger-ryao
  • @semenas
  • @shikanime
  • @shuo-wu
  • @sminux
  • @sushant-suse
  • @yangchiu
  • @yulken

更新内容 （原始）

DON’T UPGRADE from/to any RC/Preview/Sprint releases because the operation is not supported.

Resolved Issues in this release

Highlight

  • [FEATURE] Scale replica rebuilding speed form multiple healthy replicas 11331 - @derekbit @shuo-wu @roger-ryao @Copilot
  • [FEATURE] Support StorageClass allowedTopologies for Longhorn volumes 12261 - @yangchiu @derekbit @hookak @Copilot
  • [FEATURE] Add support for ReadWriteOncePod access mode 9727 - @shikanime @chriscchien
  • [FEATURE] Support extra network interface (not only storage network) on the share manager pod 10269 - @yangchiu @c3y1huang
  • [FEATURE] Monitor Node Disk Health 12016 - @c3y1huang @roger-ryao
  • [FEATURE] Replica Auto Balance Across Nodes based on Node Disk Space Consumption 10512 - @davidcheng0922 @chriscchien

Feature

  • [FEATURE] Guess Linux distro from the package manager 12153 - @yangchiu @NamrathShetty
  • [FEATURE] Provide a helm chart setting to define the managerUrl 10583 - @lexfrei @yangchiu
  • [FEATURE] Add metric for last backup of a volume 6049 - @c3y1huang @roger-ryao
  • [FEATURE] Real-time volume performance monitoring 368 - @derekbit @hookak
  • [UI][FEATURE] Monitor Node Disk Health 12263 - @houhoucoop @roger-ryao
  • [FEATURE] custom annotation/label of UI’s k8s service on value.yaml of helm chart 11754 - @yangchiu @lucasl0st
  • [FEATURE] Make longhornctl load ublk_drv module when kernel version is 6 or newer 11803 - @chriscchien @bachmanity1
  • [BUG] Inherit namespace for longhorn-share-manager in FastFailover mode 12244 - @yangchiu @semenas
  • [FEATURE] Enable CSI pod anti-affinity preset update 12100 - @yangchiu @yulken
  • [FEATURE] [Dependency] aws-sdk-go v1.55.7 is EOL as of 2025-07-31 — plan to migrate to v2? 12098 - @mantissahz @roger-ryao
  • [FEATURE] Change volume operation menu button behaviour from hover to click. 11408 - @yangchiu @houhoucoop
  • [FEATURE] “hard” podAntiAffinity for csi-attacher/csi-provisioner/csi-resizer/csi-snapshotter 11617 - @yangchiu @yulken
  • [FEATURE] node storage scheduled metrics 11949 - @yangchiu @AoRuiAC

Improvement

  • [IMPROVEMENT] generalize the offline rebuilding setting for both data engines. 12484 - @mantissahz
  • [IMPROVEMENT] Improve disk error logging to retain errors from newDiskServiceClients() 12446 - @yangchiu @davidcheng0922
  • [IMPROVEMENT] Propagate longhorn-manager’s timezone to instance-manager and CSI pods 12448 - @hookak @roger-ryao
  • [UI][FEATURE] Scale replica rebuilding speed form multiple healthy replicas 12461 - @houhoucoop @roger-ryao
  • [IMPROVEMENT] Configure rolling update strategy for longhorn-manager and CSI deployments 12240 - @hookak @chriscchien
  • [IMPROVEMENT] Improve log messages for rebuildNewReplica() in lonbghorn-manager 12426 - @derekbit @chriscchien
  • [IMPROVEMENT] misleading message when instance manager tries to create the pod 11759 - @mantissahz @chriscchien
  • [IMPROVEMENT] To improve the debugging process and UX, it would be nice that the error is recorded in the instancemanager.status.conditions. 6732 - @mantissahz @chriscchien
  • [IMPROVEMENT] Add setting to disable node disk health monitoring 12300 - @derekbit @roger-ryao @Copilot
  • [IMPROVEMENT] Avoid repeat engine restart when there are replica unavailable during migration 11397 - @yangchiu @shuo-wu
  • [IMPROVEMENT] [Script] Minor script adjustments from PR #12177 12187 - @rauldsl @yangchiu
  • [IMPROVEMENT] Check toolchain versions before generate k8s codes 12164 - @derekbit @roger-ryao
  • [IMPROVEMENT] Create Volume UI improvement, Automatically Filter Data Source Based on v1 or v2 Selection 11846 - @yangchiu @houhoucoop
  • [IMPROVEMENT] Disable the snapshot of v1 volume hashing while it is being deleted 10294 - @davidcheng0922 @chriscchien
  • [IMPROVEMENT] Expose SPDK UBLK Parameters 11039 - @PhanLe1010 @roger-ryao
  • [IMPROVEMENT] Check that block device is not in use before creating disk 12078 - @chriscchien @bachmanity1
  • [UI][IMPROVEMENT] Awareness of when an offline replica rebuilding is triggered for an individual volume 11247 - @houhoucoop @roger-ryao
  • [IMPROVEMENT] Ensure synchronized upgrades between longhorn-manager and instance-manager 12309 - @hookak @chriscchien
  • [IMPROVEMENT] Add Resource Limits Configuration for Longhorn manager/instance-manager 12225 - @hookak @chriscchien
  • [IMPROVEMENT] Add Validation Webhook to Volume Expansion When Node Disk Is Full 12134 - @yangchiu @davidcheng0922
  • [UI][IMPROVEMENT] Expose SPDK UBLK Parameters 12166 - @houhoucoop @roger-ryao
  • [IMPROVEMENT] Fix V2 Volume CSI Clone Slowness Caused by VolumeAttachment Webhook Blocking 12328 - @PhanLe1010 @roger-ryao
  • [IMPROVEMENT] Use label-based state in metrics instead of numeric values 10723 - @hookak @roger-ryao
  • [IMPROVEMENT] Add Resource Limits Configuration for CSI Components 12224 - @yangchiu @hookak @Copilot
  • [IMPROVEMENT] Awareness of when an offline replica rebuilding is triggered for an individual volume 11246 - @yangchiu @mantissahz
  • [IMPROVEMENT] Introduce Concurrent Job Limit for Snapshot Operations 11635 - @yangchiu @davidcheng0922
  • [IMPROVEMENT] Add loadBalancerClass value inside a helm chart for ui service 12273 - @ehpc @chriscchien
  • [IMPROVEMENT] Add DNS round-robin load balancing to the pool of S3 addresses 12296 - @yangchiu
  • [UI][IMPROVEMENT] Should Not Hide the Deleted Snapshots on UI 11620 - @yangchiu @houhoucoop
  • [IMPROVMENT] Helm chart Multiple TLS FQDNs 12127 - @yangchiu @hrabalvojta
  • [IMPROVEMENT] Removing executables from mirrored-longhornio-longhorn-engine image 11254 - @derekbit @chriscchien
  • [IMPROVEMENT] [DOC] Clarify replica auto-balance behavior for unhealthy and detached volumes 12002 - @roger-ryao @sushant-suse
  • [IMPROVEMENT] CRD enum values 9718 - @roger-ryao @nzhan126
  • [DOC] Troubleshooting KB Articles Fix Typos 12199 - @jmeza-xyz
  • [IMPROVEMENT] Remove backupstore releated settings 11026 - @nzhan126
  • [IMPROVEMENT] Reject Trim Operation on Block Volume 12048 - @yangchiu @derekbit
  • [IMPROVEMENT] Replace github.com/pkg/errors with github.com/cockroachdb/errors 11413 - @derekbit @chriscchien
  • [UI][IMPROVEMENT] UI shows the backing image virtual size 11674 - @chriscchien @houhoucoop
  • [IMPROVEMENT] Simplify locking in unsub and stream methods 12057 - @derekbit @NamrathShetty
  • [UI][IMPROVEMENT] Show Error Message for Unschedulable Disks 11449 - @yangchiu @houhoucoop
  • [IMPROVEMENT] The auto-delete-pod-when-volume-detached-unexpectedly should only focus on the kuberentes builtin workload. 12120 - @derekbit @chriscchien @sushant-suse
  • [IMPROVEMENT] CSIStorageCapacity objects must show schedulable (allocatable) capacity 12014 - @chriscchien @bachmanity1
  • [IMPROVEMENT] improve error logging for failed mounting during node publish volume 12025 - @COLDTURNIP @roger-ryao
  • [IMPROVEMENT] Improve Helm Chart defaultSettings handling with automatic quoting and multi-type support 12019 - @derekbit @chriscchien
  • [IMPROVEMENT] volume spec.backingImage and spec.encrypted shouldn’t allow to update for both v1 and v2 data engines 11615 - @yulken @roger-ryao

Bug

  • [BUG] v2 volume rebuild performance doesn’t improve after enabling snapshot integrity 12416 - @davidcheng0922
  • [BUG] Auto balance feature may lead to volumes falling into a replica deletion-recreation loop 11730 - @shuo-wu @roger-ryao
  • [BUG] Potential Instance Manager Client Context Leak 12198 - @derekbit @chriscchien
  • [BUG] v2 DR volume could become faulted and fail to restore from backups if volume attached node is rebooted during restoration 12412 - @c3y1huang @chriscchien
  • [BUG] System backup may fail to be created or deleted 12472 - @yangchiu @mantissahz
  • [BUG] v1.11.x upgrade test may fail because the default disk of a node is removed during a test case and cannot be re-added 12469 - @COLDTURNIP @yangchiu
  • [BUG] v2 DR volume becomes faulted during incremental restoration after source volume expansion 12465 - @yangchiu @davidcheng0922
  • [BUG] SnapshotBack proxy request might be sent to incorrect instance-manager pod 12475 - @derekbit @chriscchien
  • [BUG] rebuildConcurrentSyncLimit field is omitted from volume.spec when value is 0 12471 - @derekbit @houhoucoop @roger-ryao
  • [BUG] Adding multiple disks to the same node concurrently may occasionally fail 11971 - @davidcheng0922 @roger-ryao
  • [BUG] unknown OS condition in node CR is not properly removed during upgrade 12450 - @COLDTURNIP @roger-ryao
  • [BUG] Longhorn charts does not take care timezone 11965 - @hookak @roger-ryao
  • [BUG] Pod failed to use an activated DR volume, got UNEXPECTED INCONSISTENCY; RUN fsck MANUALLY error 12444 - @yangchiu
  • [BUG] v2 volumes do not reuse failed replicas for rebuilding as expected 12413 - @yangchiu @shuo-wu
  • [BUG] v2 volumes complete offline rebuilding with an extra failed replica if a node is rebooted during the rebuild 12407 - @yangchiu @mantissahz
  • [BUG] Test case test_rebuild_failure_with_intensive_data is failing because replicas cannot be rebuilt after replica process crashed 12436 - @yangchiu @shuo-wu
  • [BUG] Replica mode becomes empty and replica rebuilding cannot be triggered after upgrading from v1.10.1 to master-head or v1.11.0-rc1 12431 - @yangchiu @derekbit
  • [BUG] v2 volumes get stuck in Attaching/Detaching loop after node reboots 12406 - @yangchiu @c3y1huang
  • [BUG] test_basic.py::test_expansion_basic is flaky on v2 data engine due to revert snapshot fail 12235 - @davidcheng0922 @chriscchien
  • [BUG] Longhorn nodes may fail to recover after node reboots 12422 - @COLDTURNIP @yangchiu
  • [BUG] Missing Frontend default value when creating v2 volumes via Longhorn UI 12152 - @houhoucoop @roger-ryao
  • [BUG] setting values are not converted to strings in Longhorn UI 12192 - @chriscchien @houhoucoop
  • [BUG] disk health information appears briefly 12415 - @c3y1huang @roger-ryao
  • [BUG] encrypted v2 volume gets stuck in Attaching/Detaching loop after volume expansion 12359 - @yangchiu @davidcheng0922
  • [BUG] Unexpected orphaned replica is created after node reboot, preventing new replica from being scheduled on that node, and blocking v2 volume from recovering to healthy state 11333 - @yangchiu @c3y1huang
  • [BUG] RWX volume becomes unavailable after drain node 12226 - @yangchiu @mantissahz
  • [BUG] invalid memory address or nil pointer dereference 11939 - @bachmanity1 @roger-ryao
  • [BUG] share-manager excessive memory usage 11938 - @derekbit @chriscchien
  • [BUG] Encrypted Volume Cannot Be Expanded Online 12366 - @yangchiu @chriscchien
  • [BUG] Backing image download gets stuck after network disconnection 11622 - @COLDTURNIP @chriscchien
  • [BUG] Can not delete the parent of volume head snapshot of a v2 volume 9064 - @yulken @chriscchien
  • [BUG] changing of the volume controller owner caused: BUG: multiple engines detected when volume is detached 1755 - @PhanLe1010 @chriscchien
  • [BUG] mounting error is not properly hanedled during CSI node publish volume 12006 - @COLDTURNIP @yangchiu
  • [BUG] test_rebuild_after_replica_file_crash failed on master-head 12389 - @derekbit @chriscchien
  • [BUG] test_backing_image_auto_resync is flaky due to recent commit 12387 - @derekbit @chriscchien
  • [BUG] Flooding messages Failed to resolve sysfs path for \"/sys/class/block/root\ ... in longhorn-manager 12344 - @c3y1huang @roger-ryao
  • [BUG] v2 volumes could fail to auto salvage after cluster restart 11336 - @yangchiu @c3y1huang
  • [BUG] The auo generated backing image pod name is complained by kubelet 12356 - @COLDTURNIP @yangchiu
  • [BUG] test_restore_inc_with_offline_expansion fails on v2 data engine 12313 - @davidcheng0922 @chriscchien
  • [BUG] Block disks have a chance become Unschedulable in v2 regression test in test_rebuild_with_restoration 11446 - @shuo-wu @chriscchien
  • [BUG] v2 volume workload FailedMount with message Staging target path /var/lib/kubelet/plugins/kubernetes.io/csi/driver.longhorn.io/xxx/globalmount is no longer valid 10476 - @yangchiu @shuo-wu
  • [BUG] [v1.10.0-rc1] v2 DR volume stuck Unhealthy after incremental restore with replica deletion(test_rebuild_with_inc_restoration) 11684 - @c3y1huang @chriscchien
  • [BUG] test_data_locality_strict_local_node_affinity fails at master-head 12343 - @derekbit @chriscchien
  • [BUG] tests.test_cloning.test_cloning_basic fails at msater-head 12341 - @derekbit @chriscchien @Copilot
  • [BUG] v2 volume could get stuck in Detaching indefinitely after node reboot 11332 - @yangchiu @c3y1huang
  • [Bug] A cloned volume cannot be attached to a workload 12206 - @yangchiu @PhanLe1010
  • [BUG] Block Mode Volume Migration Stuck 12311 - @COLDTURNIP @yangchiu @shuo-wu
  • [BUG] Replica auto balance disk pressure threshold stalled with stopped volumes 10837 - @c3y1huang @chriscchien
  • [BUG] short name mode is enforcing, but image name longhornio/longhorn-manager:v1.10. │ │ 0 returns ambiguous list 12268 - @yangchiu @Wqrld
  • [BUG] invalid memory address or nil pointer dereference (again) 12233 - @chriscchien @bachmanity1
  • [BUG] Restored v2 volume gets stuck in RestoreInProgress state if backup is deleted during restoration 11828 - @yangchiu @c3y1huang
  • [BUG] spdk_tgt is crashed due to SIGSEGV 11698 - @c3y1huang
  • [BUG] Longhorn ignores Replica Node Level Soft Anti-Affinity when auto balance is set to best-effort 11189 - @c3y1huang @chriscchien
  • [BUG] SPDK NVMe synchronous calls 11096 -
  • [BUG] Replicas accumulate during engine upgrade 12111 - @c3y1huang @chriscchien
  • [BUG] Some default settings in questions.yaml are placed incorrectly. 12219 - @derekbit @roger-ryao
  • [BUG] Chart does not handle defaultSettings.taintToleration with a trailing colon 12162 - @derekbit @chriscchien
  • [BUG] Request Header Or Cookie Too Large in Web UI with OIDC auth 12077 - @chriscchien @houhoucoop
  • [BUG] Fix SPDK v25.05 CVE issue 11969 - @derekbit @roger-ryao
  • [BUG] Potential BackingImageManagerClient Connection and Context Leak 12194 - @derekbit @chriscchien
  • [BUG] Instance manager pod awsIAMRoleArn annotation disappearing 9923 - @yangchiu @mantissahz
  • [BUG] Node block-type disk is unable to unbind after Longhorn uninstall 9127 - @yangchiu @davidcheng0922
  • [BUG] longhorn-manager fails to start after upgrading from 1.9.2 to 1.10.0 11864 - @derekbit @roger-ryao
  • [BUG][UI] When creating volume/backing image, change Data Engine will reset Number of Replicas 11775 - @yangchiu @houhoucoop
  • [BUG] Backup target metric is broken 12073 - @mantissahz @roger-ryao
  • [BUG] panic: runtime error: invalid memory address or nil pointer dereference [signal SIGSEGV: segmentation violation code=0x1 at longhorn-engine/pkg/controller/control.go:218 +0x2de 12081 - @liyimeng @roger-ryao
  • [BUG] Unable to complete uninstallation due to the remaining backuptarget 11934 - @mantissahz @roger-ryao
  • [BUG] NVME disk not found in v2 data engine (failed to find device for BDF) 11903 - @derekbit @roger-ryao
  • [BUG] NPE error during recurring job execution 11925 - @yangchiu @shuo-wu
  • [BUG] v2 volume creation failed on talos nodes 11910 - @c3y1huang @chriscchien
  • [BUG] DR volume gets stuck in unknown state if engine image is deleted from the attached node 11995 - @yangchiu @shuo-wu
  • [BUG] Volume gets stuck in attaching state if engine image image is not deployed on one of nodes 11994 - @yangchiu @shuo-wu
  • [BUG] Rebooting the volume attached node during a v2 DR volume incremental restoration, the restoration is left incomplete and the activation has no effect 11778 - @yangchiu @c3y1huang
  • [BUG] Unable to detach a v2 volume after labeling disable-v2-data-engine=true 11799 - @yangchiu @mantissahz
  • [BUG] test_system_backup_and_restore test case failed on master-head 11933 - @derekbit @chriscchien
  • [BUG] Shebang refactor in scripts may cause compatibility issues 11815 - @NamrathShetty @chriscchien
  • [BUG] longhorn-spdk-engine CIs complain that the unit tests successfully hash system created snapshots 11822 - @yangchiu @shuo-wu
  • [BUG] RWX volume causes process uninterruptable sleep 11907 - @COLDTURNIP @chriscchien
  • [BUG] Unable to re-add block-type disks by BDF after re-enable v2 data engine 11860 - @yangchiu @davidcheng0922
  • [BUG] V2 volume stuck in volume attachment (V2 interrupt mode) 11816 - @c3y1huang
  • [BUG] Goroutine leak in instance-manager when using v2 data engine 11959 - @PhanLe1010 @chriscchien
  • [BUG] csi-provisioner silently fails to create CSIStorageCapacity if dataEngine parameter is missing 11906 - @yangchiu @bachmanity1
  • [BUG][v1.8.x] v2 volume stuck at attaching due to stopped replica 10486 - @chriscchien
  • [BUG] longhorn-engine’s UI panics 11867 - @derekbit @chriscchien @Copilot
  • [BUG] v2 volume workload gets stuck in ContainerCreating or Unknown state with FailedMount error 10111 - @yangchiu @shuo-wu
  • [BUG] Volume is unable to upgrade if the number of active replicas is larger than volumme.spec.numberOfReplicas 11825 - @yangchiu @derekbit
  • [BUG] UI fails to deploy when only IPv4 is enabled on nodes with v1.10.0 version 11869 - @yangchiu @c3y1huang
  • [BUG] v2 DR volume fails to auto-reattach when engine image missing on current node 11772 - @chriscchien
  • [BUG] inconsistent behavior of v2 volume after labeling disable-v2-data-engine to the volume attached node and deleting the instance manager 11578 - @yangchiu

Scalability

  • [DOC] Add volume sizing guidance in best practice section 12203 - @mantissahz @sushant-suse

Misc

  • [TASK] Fix flaky regression test case test_recurring_job.py::test_recurring_job_snapshot_cleanup for v2 data engine 12464 - @derekbit @chriscchien
  • [DOC] Review and Update Ingress Controller Examples for Longhorn UI 12252 - @yangchiu @sushant-suse
  • [DOC] Add KB article for the failure of RWX volume detachment 12238 - @sushant-suse
  • [DOC] Incorrect longhornctl subcommand 12423 - @chriscchien @roger-ryao
  • [TASK] Update nvme and libnvme to v2.16 and v1.16.1 12391 - @derekbit @chriscchien
  • [DOC] Disk Aggregation Options 12378 - @davidcheng0922 @roger-ryao
  • [TASK] Deprecate V2 Backing Image Feature 12237 - @derekbit @chriscchien
  • feat(chart): Add Gateway API HTTPRoute support for Longhorn UI 12299 - @lexfrei @chriscchien
  • [DOC] V2 data engine: delete snapshot after volume-head behaves inconsistently vs v1 12355 - @chriscchien @sushant-suse
  • [TASK] Revert Base Image bci-base:16.0 to bci-base:15.7 12354 - @derekbit @chriscchien
  • [DOC] Clarify share-manager image update behavior after system upgrade with attached RWX volumes 12363 - @derekbit @chriscchien
  • [DOC] Clarify expected behavior of old instance manager pods after live engine upgrade 12361 - @derekbit @chriscchien
  • [TASK] Update Longhorn v1.11.0 SPDK to v25.09 11975 - @derekbit @chriscchien
  • [TASK] Bump Longhorn Component registry.suse.com/bci/bci-base to 16.0 12145 - @derekbit @chriscchien
  • [DOC] Add KB Article: Handling Persistent Replica Failures via Disk Isolation 12242 - @derekbit @roger-ryao
  • [DOC] Document how to permanently enable hugepages 12167 - @roger-ryao @sushant-suse
  • [DOC] Update existing terminologies and add new terminologies 12302 - @sushant-suse
  • [DOC] Add a KB for restoring data from an orphan replica directory 9972 - @yangchiu @sushant-suse
  • [DOC] [UI][IMPROVEMENT] Should Not Hide the Deleted Snapshots on UI #11620 12214 - @chriscchien @sushant-suse
  • [DOC] Add Enterprise Page in Longhorn Official Document 12110 - @sushant-suse
  • [DOC] Update Talos Linux Support with Longhorn 12108 - @roger-ryao @egrosdou01
  • [DOC] [FEATURE] Add support for ReadWriteOncePod access mode 12228 - @chriscchien
  • [DOC] Workaround KB doc for backing image manager disk UUID collision issue 12114 - @COLDTURNIP @roger-ryao
  • [TASK] Remove testing credentials from backup target manifest examples 11076 - @davidcheng0922 @roger-ryao
  • [DOC] Document the Migratable RWX Volume in the Official Document 11277 - @derekbit @chriscchien @sushant-suse
  • [DOC][UI][IMPROVEMENT] Show Error Message for Unschedulable Disks #11449 12151 - @yangchiu @sushant-suse
  • [TASK] Create a GitHub Action to Update Versions in longhorn/dev-versions 12062 - @derekbit
  • [DOC] Update NFSv4 client installation docs to verify actual NFS version in use 11944 - @derekbit @chriscchien
  • [REFACTOR] SAST checks for UI component 11540 - @sminux @chriscchien
  • [DOC] Update Longhorn README file 10891 - @divya-mohan0209
  • [BUG] Block disk deletion fails without error message 11952 - @davidcheng0922 @roger-ryao
  • [REFACTOR] Remove redudant assingment 11705 - @jvanz
  • [TASK] Remove deprecated instances field and instance type from instance manager CR 5844 - @derekbit @chriscchien
  • [DOC] Update deployment links according to the document version 11847 - @yulken
  • [QUESTION] How to revert created Snapshots via CRs 11320 -

Contributors

  • @AoRuiAC
  • @COLDTURNIP
  • @Copilot
  • @NamrathShetty
  • @PhanLe1010
  • @Wqrld
  • @bachmanity1
  • @c3y1huang
  • @chriscchien
  • @davidcheng0922
  • @derekbit
  • @divya-mohan0209
  • @egrosdou01
  • @ehpc
  • @hookak
  • @houhoucoop
  • @hrabalvojta
  • @innobead
  • @jmeza-xyz
  • @jvanz
  • @lexfrei
  • @liyimeng
  • @lucasl0st
  • @mantissahz
  • @nzhan126
  • @rauldsl
  • @roger-ryao
  • @semenas
  • @shikanime
  • @shuo-wu
  • @sminux
  • @sushant-suse
  • @yangchiu
  • @yulken

下载链接