> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/release-notes/zh/2026/26-1-release-notes.md).

# 26.1

VergeOS 26.1 的发行说明：支持基于标签筛选的部分快照、面向第三方备份的 oVirt API 兼容性、N+2（RF3）vSAN 冗余，以及磁盘修复和同步性能提升。

{% hint style="info" %}
**发布信息**

* **发布日期**：2026年1月
* **最新版本**：26.1.8（2026年8月）
* **状态**：最新正式发布版
* **生命周期结束**：待定
  {% endhint %}

## 主要功能与主题

### 部分快照

{% hint style="success" %}
**基于标签的快照控制**

* 创建根据标签包含或排除资源的快照
* 支持虚拟机、租户和 NAS 服务
* 按带标签资源控制静默行为
* 对部分快照提供完整同步支持
  {% endhint %}

### 性能改进

{% hint style="info" %}
**存储与系统性能**

* 磁盘修复性能约提升 4 倍
* 重启后控制器遍历时间更快
* 通过跨目录文件线程处理提升同步性能
* 增强控制器节点上数据库的存储缓存利用
* 通过缓存 CPU 类型属性加快节点启动时间
  {% endhint %}

### oVirt API 兼容性

{% hint style="success" %}
**第三方备份集成**

* 用于第三方备份集成的原生 oVirt 兼容 API 端点
* 可通过兼容 oVirt 的工具为 VergeOS 环境启用备份支持
  {% endhint %}

### N+2 冗余（RF3）

{% hint style="success" %}
**增强数据保护**

* 新增对 N+2（RF3）vSAN 冗余的支持，也称为复制因子 3
* 在标准 N+1 配置之外提供额外容错能力
  {% endhint %}

## 26.1.8（2026年8月）

VergeOS 26.1.8 是一个维护版本，针对租户网络、高可用性、vGPU 和 VMware 集成提供了定向修复。亮点包括修复了在移除租户的 Layer 2 网络连接时出现的静默跨 VLAN 泄漏、退出维护模式时的 VM 迁移循环、在双路主机上无法填充的 vGPU 配置文件，以及带静态 IP 的 VMware 服务无法启动的问题。

### 错误修复

#### 网络

* 修复了在移除租户的 Layer 2 网络连接时出现的静默跨 VLAN 泄漏：在租户运行时删除一个连接会重新枚举其余连接，并将它们的主机侧接口移动到不同的桥上，导致流量可能走错 VLAN；现在其余连接会保持分配给它们的网络不变

#### 高可用性

* 修复了退出维护模式时的 VM 迁移循环：如果共享同一 HA 组的 VM 数量多于节点数，当某个节点退出维护时，某个 VM 可能会无限在来回迁移中卡住；现在维护结束后，VM 会直接返回其主节点

#### vGPU

* 修复了双路主机上的 vGPU 配置文件发现问题：当 NVIDIA GPU 安装在第二个 CPU 插槽上时（非零 PCI 域，例如 `0001`），vGPU 配置文件列表将始终无法填充；现在无论 PCI 域如何都会检测配置文件，因此任何插槽上的 vGPU 资源组都能按预期工作

#### VMware 服务

* 修复了带静态 IP 的 VMware 服务启动问题：一个新创建且未连接网络的服务，在其网卡被放到带静态 IPv4 配置的外部网络后，可能无法启动并持续循环

***

## 26.1.7（2026年7月）

VergeOS 26.1.7 是一个维护版本，重点提升稳定性、修复错误并增强易用性。亮点包括针对运行 26.1.6 系统的更新流程变更、显著提升的 vSAN 关闭可靠性、串口控制台稳定性修复，以及覆盖 VMware 集成、高级设置和快照管理的 UI/UX 增强。

### 更新流程

{% hint style="warning" %}
**从 26.1.6 升级**

从 26.1.6 升级时，node1 现在会最后更新。这可防止大型或繁忙系统在更新后重新连接到 node1 时运行事务验证（在 26.1.6 中引入）。
{% endhint %}

* 现在在安装任何更新包之前都会运行预检查。今后这将用于在更新前通知用户必须采取的任何操作，特别是在功能从弃用变为移除时。

### 新功能

#### 网络

* 新增手动配置的 PTP（Precision Time Protocol，精密时间协议）支持；UI 支持将在未来版本中提供

#### 虚拟机

* 现在可以在 VM 运行时擦除离线 VM 驱动器，而无需关闭 VM
* 现在可以在 VM 和租户食谱中使用 VergeOS 图标

#### 用户界面

* 浏览器标签页标题现在会优先显示 VM 或对象名称，这样在打开多个 VergeOS 标签页时更容易识别页面；此行为可在 系统 > 设置 中更改
* 移除了 SMART 警告阈值（待处理扇区、离线不可纠正扇区、重新映射扇区）的上限，允许管理员配置更高的值
* 为显示大数字的仪表板计数框添加了工具提示标题

### 错误修复

#### 存储（vSAN）

* 修复了关机期间的一个关键时序场景：在带专用控制器节点的系统上，如果在 tier 0 遍历仍在运行时重启 node1，vSAN 可能会在遍历完成前停止，从而导致 node2 在带数据库 I/O 错误的情况下无法接管为 UI 控制器
* 通过改进超时处理重构了 vSAN 关闭流程
* 修复了一个潜在竞争条件：在高强度写入活动期间实时减少节点通道时可能导致 vSAN 崩溃
* 改进了强制节点断开操作期间的超时处理
* 更改了快照文件在 vSAN 上的保存方式，以避免不必要的层级变更

#### 串口控制台

* 修复了 VM 串口控制台模拟器的重新连接问题，该问题可能导致控制台在 64 次连接/断开循环后锁死
* 修复了基于 xterm 的串口控制台初始宽度

#### 用户界面

* 租户名称变更现在会立即显示在登录屏幕上，无需重启
* 修复了 VMware“New Restore Job”表单，其中 Default Resource 下拉框被显示为删除线且不可选择，导致用户无法提交恢复任务
* 为清晰起见，将内部和外部网络表单上的 Interface Network 下拉框从“-- Default --”重命名为“-- None --”
* 为高级设置字段添加了数字验证——SMART 阈值和其他基于数字的设置现在会拒绝非整数和非数字值
* 修复了 UI 操作的自动禁用问题，该问题错误地影响了不受多选或单选限制的操作
* 修复了在 VM 或租户节点上编辑 USB 机器设备时，列表中可能显示错误资源组的问题

#### 虚拟机

* 改进了 oVirt/RHV 导入一致性：VM 属性（操作系统类型、CPU 核心数、内存、磁盘驱动接口）现在会在恢复期间正确设置，驱动器/NIC 接口会不区分大小写地检查，并能正确识别 Windows VM 操作系统类型；新增对导入带有未连接 NIC 的 VM 以及更多 OVF 文件变体的支持
* 修复了从租户发起的 Ovirt 备份任务无法列出租户 VM 的问题
* 当 VM 从食谱中分离后，其食谱元数据现在会被正确清理

#### 快照与站点

* 修复了将现有系统快照设置为不可变时，会错误地将解锁期设置为距当前日期一周的问题
* 修复了在远端站点修改远程快照到期时间后不会持久化的问题——到期时间会在下次刷新时恢复
* 为减少审计日志噪音，现在隐藏系统快照到期审计日志条目

#### 身份验证与邮件

* 修复了即使 SMTP 被禁用，系统仍允许尝试发送邮件（通过测试或任务）的问题
* 增加了防止删除 admin 用户账户的额外保护

#### 网络

* 修复了通过 UEFI 启动 PXE 节点的问题

#### NAS

* NAS 卷现在会忽略驱动器上的序列号属性，以避免混淆和可能的序列号重复，这些问题可能导致卷在客户机中丢失其驱动器引用

#### 硬件与告警

* 修复了在某些硬件上将 DIMM 与 ECC 错误匹配的问题
* 当告警类型发生变化时，之前的告警现在会被正确降低，并提升新的告警
* 系统启动时现在会清理重复告警

#### 安装程序

* 修复了安装计算节点时不会提示在较小磁盘上安装启动分区的问题

#### 性能与稳定性

* 修复了 Web 服务器中的一个潜在稳定性问题
* SMTP 刷新现在一次只能进行一个，以防止冲突
* 修改资源组但未更改任何设置时，不再触发“需要重新加载驱动程序”事件
* 重命名带公共链接的文件时，现在会将公共链接更新为新文件名

***

## 26.1.6（2026年5月）

VergeOS 26.1.6 是一个维护版本，为整个平台带来了定向错误修复和稳定性改进。重点领域包括集群环境中的 NTP 配置、vSAN 竞争条件修复、引导加载程序改进（GRUB/PXE）、更新安装可靠性以及多项 UI 修正。

### 错误修复

#### 安全

* 增加了防止意外删除 admin 用户的保护，即使使用 CLI 访问也是如此
* 从知名身份验证源中移除了调试日志

#### 身份验证与授权

* 作为除 `admin` 之外的管理员用户删除系统快照时，现在会返回正确的错误消息

#### 用户界面

* 为保持一致性，修复了 NAS 卷快照“恢复到新建”面包屑导航中的大小写
* 修复了在查看分配给租户的 USB 设备时资源组显示错误的问题——现在当主机上存在多个 USB 资源组时，详情视图会正确显示源组
* 编辑 SR-IOV NIC 资源组名称时，不再错误地提示重新加载驱动程序
* 修复了 xterm（串口）控制台的初始宽度，以便首次连接时正常显示
* 在实现实时迁移支持之前，VM 的模拟 NVMe 驱动器会暂时从 UI 中隐藏

#### 网络

* 修复了集群环境中的 NTP 配置：第 2 个及之后的节点现在会正确与节点 1 同步，而不是与外部 NTP 服务器同步
* NTP 池地址（例如 `0.pool.time.org`）现在会正确写入 `ntp.conf` ，并使用 `pool` 指令而不是 `server`
* 移除了 `time.nist.gov` ，从默认 NTP 服务器列表中移除（不再推荐）

#### 存储（vSAN）

* 更改了快照元数据文件在 vSAN 上的保存方式，以防止意外的层级变更
* vSAN 节点添加/删除操作现在在事务之外运行，并设置更长超时，从而在横向扩展时提高可靠性
* 修复了一个问题：vSAN 同步完成时可能触发不需要的事务快照
* 修复了 `RefreshTierMap` 中的竞争条件，启动期间映射可能被部分初始化
* 修复了在写入过程中发生拓扑更改时的竞争条件

#### 虚拟机

* 修复了自定义脚本无法正常执行的问题
* 修复了在 2 节点集群中、未进入维护模式时关闭节点 2 可能会意外禁用“VM 无响应”检测的问题
* 当服务器在维护模式之外停止时，VM 现在会尝试优雅关闭

#### API 与集成

* 重命名媒体镜像时，现在会自动更新所有相关公共链接，使其在重命名后继续可用

#### 性能与稳定性

* 修复了下载更新时会保持数据库事务打开、从而可能阻塞其他操作的问题
* 系统启动时现在会清理重复告警
* SMTP 刷新现在是串行执行的（一次一个），以防止竞争条件
* 为 SMTP 表添加了正确的告警依赖关系——SMTP 告警现在只会在刷新期间生成
* 修复了创建新租户时的时序问题：appserver 会在目录刷新完成前重启
* 修复了 appserver 中连接生命周期的 refcount 和 busycount 问题
* 修复了 appserver 在错误期间的连接处理竞争条件
* 为节点驱动器循环日志添加了正确的错误代码

#### 引导与固件

* 修复了 GRUB 补丁——系统现在正确使用 GRUB，而不只是 syslinux
* 改进了 N+2 消息，以清楚指示需要重启哪些节点

#### 安装程序

* 所有预安装检查现在会在安装任何包之前完成，从而防止部分安装
* 在安装更新前添加了预检查，会在未来版本中随着弃用功能被移除时通知用户所需操作
* 修复了按下 `CTRL-C` 在 Replace Drive 表单上会错误地继续执行，就像选择了“No”一样
* 早期引导阶段 vSAN 挂载中断现在会进入 shell，而不会显示 panic 警告
* 在设置外部网络默认网关时添加了验证，以确保网关位于子网掩码范围内
* 修复了 PXE 启动安装即使已成功完成却错误报告失败的问题

***

## 26.1.5（2026年5月）

VergeOS 26.1.5 是一个维护版本，重点在于稳定性、安全加固和改进租户隔离。亮点包括对标签、类别和成员的增强审计日志、扩展的 NVIDIA GRID 驱动支持、VLAN 验证和 VM 克隆的关键修复、适用于所有操作系统的通用预打补丁 OVMF vars 文件以支持安全启动，以及对 PERC H975i 和 Intel E610 控制器的新硬件支持。

### 新功能

#### 硬件支持

* 新增对 Broadcom PERC H975i RAID 控制器的支持
* 新增对 Intel E610 网络控制器的支持

#### NVIDIA GRID vGPU

* 新增对 NVIDIA GRID 驱动版本 20.1、19.5 和 16.14 的支持（在此前已支持的 20.0 之外）

#### 安全启动与 OVMF

* 通用预打补丁 OVMF vars 文件（`OVMF_VARS_4M.ms.2023.fd`）现在可通过单个文件支持 Windows、Debian、Ubuntu、Red Hat 及其他操作系统
* 预打补丁 OVMF vars 文件现在已包含在覆盖层中，可在安装期间立即使用
* 为 Windows VM 添加了 2023 Microsoft Cross-Root Certificate Authority 安全启动 EFI 磁盘补丁

#### 审计日志

* 为标签、类别和成员分配的更改添加了全面的审计日志
* 任务现在会跟踪实际创建者，以便准确归属审计轨迹

### 错误修复

#### 安全与访问控制

* 租户更新设置现在对租户用户隐藏（租户不再能访问系统更新配置或查看分支信息）
* “忘记密码”查询现在不区分大小写（与登录行为一致）

#### 虚拟机

* 修复了 VLAN ID 4095 在配置时被接受但导致接口创建失败的问题（现在会被正确拒绝为无效）
* 在控制器暂时不可用时，为 VM 添加了额外错误处理，提升短暂中断期间的韧性
* VM 和驱动器克隆操作现在会正确保留源驱动器序列号
* 修复了在粘贴文本或执行 Ctrl+Alt+Delete 后 VM 控制台键盘焦点丢失的问题
* 修复了 VM 停止时重启标志未被正确清除的问题

#### 告警与诊断

* 修复了用于提升和降低告警的 syslog 集成
* 修复了 vSAN 和 appserver 告警生成与报告中的问题
* 修复了告警上的 resolve 按钮，使其能正确清除已确认告警
* 修复了未能正常运行的 vSAN 诊断功能
* 修复了 VM 开机事件未被正确记录到审计日志中的问题

#### 用户界面

* 修复了租户仪表板标签成员分配问题，并移除了调试控制台日志
* 确认弹窗现在始终将正向/确认操作放在右侧，符合标准 UI 约定
* 澄清了当 vSAN 意外退出时节点横幅上误导性的“vSAN Exit”按钮标签
* 移除了设置中删除许可证部分的一个错误链接

### OS 与安装程序

#### 安装程序改进

* 更新了通用 vars 脚本并进行了改进
* 从安装中移除了一个过时的脚本和二进制文件

***

## 26.1.4（2026年4月）

VergeOS 26.1.4 是一个维护版本，重点改进稳定性、安全性和易用性。亮点包括完全重构的串口控制台并支持实时迁移、API 密钥 IP 允许/拒绝列表执行的关键修复、改进的升级路径可靠性，以及尊重严格租户密码策略的增强密码生成。此版本还修复了在 26.1.3.1 中发现的 oVirt API 问题。

### 错误修复

#### 安全

* **API 密钥 IP 允许/拒绝列表执行** — IP 允许列表现在会正确限制仅允许列表中的地址访问，而 IP 拒绝列表会正确阻止指定地址（此前未生效）
* **API 密钥 IP 范围冲突检测** — 在允许和拒绝列表中创建带有重叠 CIDR 范围的 API 密钥现在会显示验证错误；错误消息中显示的 CIDR 条目的 IP 范围现在是准确的
* **已阻止 `0.0.0.0/0` 在 IP 允许/拒绝列表中** — 使用 `0.0.0.0/0` 不再被允许（此前会产生相反或意外效果）
* **TOTP 绕过防护** — 通过 API 创建且启用了 TOTP 的用户现在无法在不提供 TOTP 代码的情况下登录
* **账户锁定执行** — 更改失败登录锁定设置现在会立即生效
* **登录洪泛防护** — 同时大量登录尝试不再会导致系统无响应
* **最后登录 IP 跟踪** — “最后登录 IP”字段现在在通过 API 调用进行身份验证时会正确显示
* 为系统中存储的身份验证源凭据添加了额外混淆
* PAM 身份验证期间创建的临时登录凭据现在会被正确清理
* 增加了对可能导致系统问题的深层嵌套 JSON 负载的防护

#### 身份验证与 SSO

* **`verge.io` 身份验证驱动已移除** — 该驱动存在一个严重错误，会导致身份验证因“Invalid state”错误而失败，在有可用的正式修复前已被移除。请改用 `openid-well-known` 驱动。
* 身份验证源现在支持多个重定向 URI，允许通过多个域名访问的系统正确完成认证
* 身份验证源现在可以通过代理服务器工作
* OAuth 流现在支持在成功身份验证后重定向到自定义链接
* 在登录用户名字段输入 Unicode 字符不再会导致浏览器挂起
* 提交“忘记用户名”表单不再生成虚假的“登录失败”审计日志条目
* TOTP 设置弹窗上的 Enter/Return 现在可正常工作

#### 虚拟机

* 修复了从食谱为租户进行配置时，在租户具有严格密码规则时可能使租户处于无响应状态的问题
* 修复了 VergeOS 市场食谱在最近的限流更改后出现“preferred tier no such file or directory”错误的问题
* 修复了迁移 VM 时的默认节点选择
* 客户机发起的重启现在会被正确记录为重启，而不是报告为硬重置
* VM 的 NVMe 驱动器现在可在 UI 中使用
* NVIDIA vGPU 改进：修复了与旧版 mdev 设备相关的问题，为 vGPU 驱动文件添加了正确排序，增加了用于许可的客户端配置令牌支持，并且现在会检测并清理重复 PCI 设备
* 修复了在同一节点上向同一 SR-IOV 资源组添加多个 NIC 的问题
* 新增对使用 VergeOS 生成的 OVF 文件时导入 cloud-init 文件的支持
* VM 和租户食谱图标现在接受数字字符，并且 `bi-` 前缀在设置图标时是可选的
* 食谱问题和 cloud-init 文件中不存在的变量现在会渲染为空字符串，而不是在输出中保留变量占位符
* 修改租户食谱问题不再导致空白页面
* 现在只需单击一次即可从 VM 仪表板启动 VM
* 剪贴板粘贴不再默认将文本设为隐藏

#### 串口控制台

* **串口控制台全面重构** — 用 `vncterm` 替换为自定义串口控制台，支持 framebuffer、多路同时连接和实时迁移。串口控制台现在会自动重新连接，而不是显示弹窗。
* 在 VM 实时迁移期间，串口内容保持一致
* 新的串口控制台与旧版本 VergeOS 向后兼容
* VM 串口控制台现在默认使用 80x24（大多数操作系统的标准），并提供缩放切换
* 将默认控制台类型改为 `isa-serial` 以获得更好的旧操作系统兼容性

#### 用户界面

* 修复了节点远程控制台中无效的电源、客户机信息和剪贴板选项；控制台现在在初始加载时可正常调整大小
* 修复了 vSAN Tiers 仪表板上总磁盘空间显示错误的问题
* 修复了 VM 导出卷浏览器中的多个问题：仅有一个项目的卷浏览、“重命名”弹窗没有输入字段，以及选择“New VM Import Job”后 UI 挂起
* 修复了 VM 仪表板中的多个问题
* 修复了新卷 VM 导入任务的错误显示
* 修复了任务仪表板中计划触发器和执行按钮样式的显示问题
* 修复了告警暂缓间隔、列表视图中的暂缓以及确认循环问题；告警历史表已精简
* 为权限页面添加了正确排序
* 为资源组上的机器设备列表添加了租户名称
* 修复了节点仪表板上双重“需要重启”提醒；并在 RAM 使用量计算中加入了超额预留 RAM
* 当未启用 2FA 时，两因素认证类型会对用户仪表板隐藏
* 删除组现在会完全移除所有残留内容，从而允许创建同名新组
* 使用无效字符创建组不再会在系统中留下残余数据
* 删除对象不再会在 UI 中创建 404 错误
* 在 DNS 区域记录表中添加了订单 ID 显示；修复了修改 DNS 区域记录页面上的面包屑导航
* 修复了网络仪表板 DHCP 部分的对齐问题；修复了 Bind 和启用代理网络的 IP 别名显示
* 修复了资源页面上的面包屑导航，以及 Node USB/vGPU 设备和 NVIDIA PCI 设备列表页上的用户发起筛选

#### 网络

* 修复了在物理网络处于 trunk VLAN 时，HP blade chassis 系统上 fabric 信息不显示在 UI 中的问题
* 修复了代理 FQDN 匹配，使得 `test.example.com` 不再错误地匹配 `a-test.example.com`；并添加了匹配整个子域的选项
* 修复了从 vnet 仪表板删除代理后在 vnet 上留下过期代理配置的问题（代理选项消失，但编辑视图仍显示代理已启用且配置被清空）
* 修复了创建新的静态 IP 时可能随机将所有权分配给租户的问题；现在可以从内部网络将虚拟 IP 分配给租户
* 在配置网络时添加了网络冲突检测；快速安装现在会在启动核心网络之前监控网络链路
* 修复了重启时发生的网络问题
* HA 代理现在会在配置 IP 别名后加载

#### 存储（vSAN）

* 当 vSAN 意外退出时，更长的延迟可确保其他节点在主机重启前收到确认
* 修复了出站同步错误期间的潜在时序问题
* 修复了驱动器不足时的设备映射分配
* 修复了系统只有 2 个驱动器但配置为 N+2 时 vSAN 崩溃的问题
* 重启后，vSAN 问题现在会在 UI 中正确显示
* 在 CLI 登录菜单中添加了 vSAN 和 Fabric 状态选项

#### NAS

* 修复了缺失的 `gcs2` NAS 更新中的二进制文件，该问题会导致 NAS 服务 VM 在开机后不断输出“Error running command guest-info: -8”

#### 调度与任务

* 修复了多个调度器错误，包括按时段筛选、未来开始日期对齐、夏令时处理以及按分钟调度和时间范围筛选的问题
* 修复了迁移后失败的出站同步刷新任务
* 修复了任务调度 UI 中的错误消息，为任务调度列表添加了摘要字段，并修复了时间的横幅摘要显示
* 修复了“Next Run Times”，以正确显示午间和午夜调度的本地时间
* Webhook 现在会更新 `last_attempt` 时间戳；移除了头部上的必需标记

#### oVirt 与 Veeam 集成

* **oVirt 引擎 ID 唯一性** — 修复了租户系统 ID 继承问题，该问题会导致整个环境中出现重复的 oVirt 引擎 ID，从而阻止 Veeam 将租户作为额外的受管服务器添加
* 修复了升级后引入的 oVirt 登录回归问题，该问题阻止 Veeam 连接到 oVirt KVM Manager
* 修复了尝试 Veeam 备份时报告“找不到可用工作进程”的错误
* 带标签的 Veeam 备份任务现在可正常工作
* 在将虚拟机还原到其原始位置时，Veeam 现在允许名称中包含在 VergeOS 中有效的字符
* 为更新后的 SDK 更新了 VMware Python 脚本；新增了一个用于检索 VMware 标签的脚本
* 移除了要求为 VMware 服务填写“网络”字段的限制

#### 密码管理

* 生成的密码现在会正确遵守严格的租户密码要求；当策略不允许时，密码生成不再包含符号
* 移除了节点凭据的密码复杂度验证

#### 系统稳定性

* **升级可靠性** — 为节点登录添加了向后兼容性，用于乱序升级；较旧的控制器现在可以登录已更新的节点，反之亦然，从而防止迁移卡住
* 添加了保护页，可立即捕获栈溢出，即使栈溢出时也会触发崩溃处理
* 改进了对栈崩溃和格式错误 JSON 的检测与日志记录
* 会话超时不再影响内部系统通信
* 修复了关闭或重启 node1 会导致 UI 约一分钟不可用的问题
* 改进了系统还原后的开机顺序并加快了网络恢复；放慢了启动时对无响应机器的检测，以减少误报
* 将日志轮转改得更频繁，以防止失控的日志记录器填满根分区
* 修复了代理处理中的内存泄漏
* 修复了在错误洪泛期间 Web 连接可能卡住的问题

#### 安装程序

* 修复了快速安装和绑定配置期间的网络加载问题
* 修复了安装程序始终安装 `ovirt-engine` 无论配置如何
* 当尝试添加的节点数量超过许可证允许时，改进了错误消息
* 如果 SMTP 发件人地址为空，安装期间现在会禁用 SMTP

#### API

* API 密钥登录现在会在审计日志中包含 IP 地址信息
* 唯一性约束错误现在返回 HTTP 409，而不是 422
* 改进了无效 API 调用的审计日志措辞；在审计事件中添加了令牌信息

### 其他

* 将 QEMU 更新到 10.0.9
* 新增了对 20.0 版本的 NVIDIA GRID vGPU 支持
* 使用离线许可证时，自定义 UI 品牌现在会被正确启用
* 修复了移除 powered-by 设置后没有恢复为默认值的问题
* 修复了在删除所有快照配置周期后，快照过期后记录的错误
* 修复了 SMTP 报告和 SMTP 设置告警触发器中的小问题；修复了使用“发送测试邮件”模态框时的错误
* 修复了服务器设置 `boot/install-settings` rsyslog 配置
* 节点现在会在特定设置更改时刷新启动分区；修复了更新启动分区和 LED 定位命令
* 设置超额提交现在会正确将在线机器标记为需要重启
* 修复了身份验证源客户端密钥字段被意外清空的问题
* 清理了标题，改为使用 VergeOS 或通用命名

***

## 26.1.3.1（2026 年 3 月）

### 错误修复

#### 虚拟机

* 修复了虚拟机开机回归问题
* 修复了首次切换隐藏文本时虚拟机控制台粘贴的问题
* 虚拟机仪表板修复与重构
* 新增了对修改虚拟机配方实例的检查

#### VMware 服务

* 修复了在节点没有时启动 VMware 服务容器的问题 `/dev/dri`

#### 用户界面

* 修复了无类型列表中的设备列表刷新，添加了租户列，并改进了父级显示
* 修复了由于面包屑导航问题导致仪表板删除操作产生 404 错误

#### 系统管理

* 基于验证重构了系统组的创建和删除，并为残留组增加了自动清理
* 将 swappiness 从 0 改为 1，以改善内存超额提交行为

### 操作系统与性能

#### 核心系统

* 修复了在写入缓冲区已满时导致某些下载失败的 SSL 错误
* 修复了在 N+2 系统上使用 2 块驱动器时的 vSAN 稳定性问题

### 已知问题

#### oVirt API

{% hint style="warning" %}
**26.1.3.1 中的 oVirt API 问题**

以下问题会影响此版本中的 oVirt 兼容备份集成。全部已在 **26.1.4**.
{% endhint %}

* **身份验证不会重用令牌** — oVirt API 会在每个请求中登录（大约每分钟一次），从而生成过多的审计日志条目并触及每用户 100 个会话的限制
* **租户备份连接问题** — 租户与根租户之间共享的 GUID（例如集群 ID）可能会导致备份供应商错误识别租户基础架构，从而引发连接和识别错误
* **错误的 HTTP 错误代码** — 某些 API 错误未按照 oVirt 规范返回（HTTP 状态码和错误格式不正确）
* **上传/下载活动不可见** — 文件上传和下载不会在 oVirt 仪表板上显示活动

#### 弃用硬件

* **NVIDIA Tesla P40** — Tesla P40 GPU 在此版本中无法正常工作。当前使用 Tesla P40 卡的现有部署应计划迁移到受支持的 GPU 型号。

***

## 26.1.3（2026 年 3 月）

### 新功能

#### 告警与监控

* 在主页仪表板中添加了告警
* 告警现在会显示友好的解决名称
* 新增了确认告警的能力（如果无法确认，则可稍后提醒）
* 更新服务器现在可以触发告警

#### 安全与 SSL/TLS

* 通过禁用旧协议（SSLv2/SSLv3）并强制使用 TLS 1.2+，改进了 SSL/TLS 安全性
* 新增了可配置的 SSL 版本控制
* 自动创建的证书现在可以删除

#### vGPU 与硬件

* 新增了对 NVIDIA vGPU 配置文件的支持（包括 RTX 8000、RTX PRO 6000 Blackwell 和异构配置文件）
* 为较新的 NVIDIA 卡新增了 MIG vGPU 支持

#### 系统快照

* 新增了从系统快照中恢复文件和 VMware 服务的能力
* 远程快照现在可以设为不可变
* 为系统快照添加了更多审计日志记录

### 错误修复

#### 租户与站点管理

* 修复了租户仪表板上的存储和节点按钮问题
* 修复了集群状态以忽略离线集群
* 租户仪表板现在在创建新 IP 地址后会重定向到正确页面
* 修复了提供方快照过期未在租户中更新的问题
* 当根租户中的快照过期设置更改时，减少了日志噪音

#### VMware 服务

* 修复了在选择“默认”集群时的虚拟机放置问题
* 修复了带有静默处理的虚拟机克隆可能遗留一个会阻止未来克隆的快照的问题

#### 安全与身份验证

* 修复了需要更改密码时的 2FA 设置
* 修复了 2FA 设置期间的密码验证
* 物理访问用户现在需要名称以字母开头（不能以数字开头）
* 修复了启用物理访问时编辑用户的问题
* 修复了编辑证书时证书链的显示
* 修复了编辑授权源私钥的问题
* 修复了混合域和大写域的证书域匹配

#### 存储与卷

* 修复了卷备注的编辑
* 当驱动器更换为不支持相同指标的型号时，修复了 SMART 指标

#### UI 改进

* 修复了多个区域中的面包屑导航（日志、NAS、配方、快照、设备列表）
* 为原本缺少的列表视图添加了启用/禁用选项
* 修复了远程统计信息显示
* 修复了仪表板上的各种按钮问题
* 修复了当用户拥有混合归属虚拟机时的删除错误
* 将 Appserver Exit 告警重新表述为包含时间戳

#### 网络

* 修复了阻止创建新 IPSec 隧道的错误
* 更改 WireGuard 监听端口时添加了备注
* 阻止将远程过期时间设置为早于当前设置的日期

#### 虚拟机配方

* 保留了光盘上的原始 ISO 名称
* 修复了在 UI 中显示的错误

#### SR-IOV

* 修复了 SR-IOV，以便在禁用时正确清理虚拟功能

#### 安装与更新

* 修复了在第 3 个控制器上的 N+2 安装
* 在 node 1 上安装更新和重启时添加了延迟

***

## 26.1.2（2026 年 2 月）

### 新功能

#### oVirt API 兼容性

* 为第三方备份集成实现了兼容 oVirt 的 API 端点

#### 存储与 vSAN

* 新增对 N+2（RF3）vSAN 冗余的支持，也称为复制因子 3

### 错误修复

#### 快照与还原

* 修复了当两个快照配置周期被安排在同一时间时只会运行一个的问题
* 修复了带有“任意日期”选项的每周快照频率错误地每天拍摄快照的问题
* 修复了从主机还原租户快照时只允许一次尝试的问题
* 修复了还原租户快照时出现“待还原不存在”错误的问题
* 修复了覆盖待处理的租户快照还原时出现的错误消息
* 为快照配置文件和配置文件周期删除添加了审计日志

#### 虚拟机与导出

* 修复了导出的虚拟机未包含标签的问题
* 修复了虚拟机事件过滤类别显示“Value”而不是正确标签（快照、操作系统家族、控制台类型）的问题

#### 租户与主题

* 修复了克隆的租户将主题访问设置恢复为默认值，而不是继承源租户设置的问题
* 修复了无论主题访问权限如何，所有主题都会暴露给租户的问题
* 修复了租户每个目录只保留一个市场配方的问题

#### 用户界面

* 修复了标签按字母排序时将大写标签与小写标签分开排序的问题
* 修复了创建新站点时的语法问题（缺少撇号）
* 修复了 NAS 服务编辑界面中缺少名称字段的问题
* 修复了从站点历史记录页面点击浏览器返回按钮时出现空白页面的问题
* 修复了“重启并应用更新”模态框会卡住直到重启开始的问题
* 修复了下载菜单链接看似激活但对可选更新不起作用的问题

#### 站点与历史记录

* 查看站点历史记录时修复了“需要 ID 和 Section”错误

#### 身份验证与用户

* 修复了身份验证源编辑表单默认显示客户端密钥的问题
* 修复了“忘记密码”链接生成无效令牌的问题

#### 系统管理

* 修复了从租户中移除系统帮助 URL 会导致 404 错误的问题
* 修复了编辑集群会重置每台机器的 RAM 数量的问题

***

## 26.1.1（2026 年 1 月）

### 新功能

#### 部分快照

* 新增了使用标签进行包含或排除过滤的部分快照支持
* 支持虚拟机、租户和 NAS 服务
* 控制哪些资源会在部分快照期间被静默处理
* 部分快照设置现在会显示在编辑视图中
* 多个标签现在会在快照列表视图中正确显示

#### 站点同步与备份

* 新增了对部分快照的同步支持
* 增强了同步审计日志，包含状态、进度和失败详情
* 在出站同步日志中添加了 synclist

#### 任务自动化

* 新增了用于自动同步创建和配置的任务支持辅助工具
* 在同步仪表板中添加了任务执行和配置文件周期链接
* 自动同步的新任务创建确认辅助工具
* 多个任务 UI 增强

### 功能变更与改进

#### 虚拟机

* VM 导出现在支持 ybvm 文件中的标签
* 新增了 OVF 导出输出支持
* 虚拟机快照驱动器现在会从源驱动器继承生成的 UUID
* 为显卡设备添加了高级选项（例如， `vga.virtio.X`, `vga.std.X`, `vga.vmware.X`)
* “自动”现在是迁移弹窗中的默认选择（虚拟机、服务容器、租户节点、VMware 容器）

#### 用户界面

* 为用户创建和登录表单添加了密码可见性切换
* 将毫秒显示改为更友好的格式（集群层级、vnet 仪表板、虚拟机粘贴配置）
* 在标签选择器中添加了成员链接
* 增强了从卷/虚拟机查看系统快照时的面包屑导航
* 将剩余的“Media Images”引用重命名为“文件”
* 在禁用计算时清理了集群仪表板显示

#### 存储与 vSAN

* 新增了通过高级系统设置指定 vDisk 厂商的能力（会继承到租户）
* 当状态为工作中时，集群层级现在即使在 0% 也会显示进度

#### 网络与同步

* 移除了远程仓库的密码确认要求
* 新增了为 webhook 指定 HTTP 方法并追加到 URL 的能力

#### NAS

* 新 NAS 服务默认禁用防病毒

#### GPU 支持

* 新增了 NVIDIA GRID vGPU 驱动 19.4、18.6 和 16.13

### 操作系统与性能

#### 核心系统

* 将 QEMU 更新到 10.0.7
* 为以下内容新增了 bash 补全： `jvcmd`
* 通过缓存最佳 CPU 类型属性，加快了节点启动时间

#### vSAN 性能

* 当数百台虚拟机运行在同一租户中时，性能得到提升
* 改进了控制器节点上数据库的存储缓存使用
* 磁盘修复性能提升约 4 倍（并行修复，默认 4 个线程）
* 改进了重启后初始控制器遍历时间
* 通过跨目录文件线程处理提升同步性能
* 当缓存内存受限时，为完整遍历实现了预读

### 错误修复

#### 快照与还原

* 修复了不可变快照未能正确同步到备份站点的问题
* 修复了从快照还原时 NAS 服务虚拟机未保留标签的问题
* 修复了从部分快照还原 NAS 服务虚拟机的问题
* 修复了手动同步的系统快照在目标端使用了错误前缀的问题
* 修复了“永不过期”选项会让日历选择器在表单上保持可见的问题

#### 站点同步

* 修复了离线站点卡片在没有品牌徽标时显示为在线的问题
* 修复了出站同步仪表板上的启用/禁用对话框和工具提示问题
* 修复了左侧导航菜单选项（删除、禁用、启用）在出站同步中不起作用的问题
* 为暂停/禁用/错误同步添加了统计日志记录
* 修复了入站同步期间备份站点上出现的刷新错误

#### 身份验证与用户

* 修复了在使用 TOTP 2FA 且要求更改密码时的密码更改循环
* 修复了在启用 2FA 时密码确认不匹配仍被接受的问题
* 修复了需要更改密码时的 2FA 邮件

#### 虚拟机

* 修复了虚拟机服务克隆未复制导出设置和数据的问题
* 修复了按 Enter 键时“新建虚拟机”页面会继续选择而不是搜索的问题
* 修复了未为集群名称设置 cloud-init 变量的问题
* 修复了在 Cloudflare 不可用时下载虚拟机配方的问题

#### 存储与 vSAN

* 修复了向计算节点添加存储会导致前 2 个驱动器分配不正确的问题
* 修复了在升级到 26 版之前删除过的层级被重新创建时的 vSAN 崩溃问题
* 修复了 SMBIOS 厂商和磁盘厂商未传递给租户的问题
* 修复了影响 Storware 备份集成的前一个回归问题

#### 用户界面

* 修复了多个仪表板上的产品帮助链接损坏或不正确的问题
* 修复了虚拟机 NIC 的“添加 IP 地址”面包屑导航
* 修复了从节点 NIC 进入 LLDP 邻居的链接
* 修复了集群层级仪表板未显示所有节点的问题
* 修复了 NIC 资产字段备注中的错误措辞（提到了驱动器而不是 NIC）
* 修复了从系统快照同时恢复大量对象的问题

#### 证书

* 修复了新系统创建重复证书的问题
* 清理了重复的 verge-api 自签名证书
* 修复了包含 IP 地址的证书
* 升级到 26.1 时自动清理重复证书

#### 安装

* 修复了在第二个控制器节点上安装加密 vSAN 的问题
* 除非使用高级安装程序，否则移除了 EFI 问题
* 修复了安装程序允许将 vSAN 加密密钥磁盘覆盖为仅启动盘的问题

#### 其他修复

* 修复了指向“\*”表行类型的字段的 Swagger 文档
* 修复了表单上的 SMTP 小部件电子邮件字段
* 修复了更新完成时将“idle”状态记录两次的问题
* 修复了 AI Workspace 文件上传显示 0% 后消失的问题
* 修复了常规文件上传刷新后仍停留在 0% 的问题

***

## 升级说明

{% hint style="warning" %}
**重要升级信息**

* **需要重启**：是 - 所有节点都需要重启
* **证书清理**：重复证书会在升级期间自动清理
* **NAS 防病毒**：新 NAS 服务默认禁用防病毒；现有服务保持不变
* **部分快照**：新功能要求在创建部分快照之前先标记资源
  {% endhint %}

{% hint style="info" %}
**升级后操作**

* 如果需要基于标签的备份，请检查并配置部分快照配置文件
* 升级后验证同步配置
  {% endhint %}

## 已知问题

{% hint style="info" %}
**当前限制**

* 部分快照不能用于完整系统还原；仅用于单个资源恢复或同步
  {% endhint %}

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/release-notes/zh/2026/26-1-release-notes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
