> 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/2025-nian-huo-geng-zao/4-13-release-notes.md).

# 4.13

{% hint style="info" %}
**系列信息**

* **初始发布**: 2024年11月 (4.13.0)
* **最新版本**: 4.13.4.2（2025年8月）
* **状态**: 受支持
* **生命周期终止**: 待定
  {% endhint %}

## 主要功能与主题

### 硬件虚拟化与资源管理

{% hint style="success" %}
**资源管理**

* 全面的硬件直通能力（USB/PCI/SRIOV）
* 实验性的 vGPU 热迁移支持
* 借助最新的 NVIDIA GRID 驱动增强 GPU 支持
* 提高资源上限（1024 个 CPU、256TB 磁盘）
* 高级 SRIOV 和设备管理
  {% endhint %}

### 存储与数据管理

{% hint style="success" %}
**存储增强**

* 改进的虚拟机导出功能
* 增强的云快照能力
* 高级 vSAN 管理功能
* 多路径和多通道支持
* 卷层级节流
* 改进的备份集成
* 能够模拟 USB 存储设备
  {% endhint %}

### 网络基础设施

{% hint style="info" %}
**网络改进**

* 增强的绑定能力
* 外部网络的脑裂检测
* 改进的高速网络利用率
* 高级网络容器功能
  {% endhint %}

### 系统管理

{% hint style="info" %}
**管理功能**

* 增强的双因素身份验证
* 通过并行更新改进更新流程
* 高级维护模式功能
* 增强的 VMware 集成
* 改进的租户管理
* 全面的 HA 改进
  {% endhint %}

## 4.13.4.2（2025年8月）

{% hint style="info" %}
**热修复版本**

无需重启（如果系统当前运行 4.13.x）。
{% endhint %}

#### 错误修复

* 修复了影响电子邮件身份验证方式的双因素身份验证问题

## 4.13.4.1（2025年8月）

{% hint style="info" %}
**热修复版本**

无需重启（如果系统当前运行 4.13.x）。这是我们即将推出的主要版本所需的更新，我们将切换到不同的版本控制系统。未来的更新将以年份后两位开始，后跟该版本开发工作开始时所在的季度。例如：26.0
{% endhint %}

#### 错误修复

* 修复了影响 TOTP 身份验证方式的双因素身份验证问题
* 为 26.0 版本发布做准备，增强了 UI 版本处理
* 各种系统稳定性改进

## 4.13.4（2025年3月）

### 功能与改进

#### 虚拟机管理

* 增强的虚拟机操作：
  * 实现了新的虚拟机控制台连接方式
  * 添加了支持基本算术运算的配方问题数学运算（`+`, `-`, `/`, `*`)
  * 示例： `${$math:VARIABLE,+,3}` 为 VARIABLE 加 3
  * 优化了虚拟机或租户的云快照浏览
* 改进的租户能力：
  * 在停止租户节点时添加了更友好的超时提示
  * 自动继承父数据库刷新间隔
  * 改进了租户节点电源循环行为
  * 增强了租户内的 NIC 统计跟踪
  * 修复了重置租户密码可能导致反复重置的问题

#### 硬件支持

* 新增对 NVIDIA GRID 驱动的支持：
  * 16.8, 16.9
  * 17.5
  * 18.0

#### 存储与基础设施

* 增强的 vSAN 操作：
  * 将层级变更检测从引用方式改为基于触发器
  * 改进了所有元层驱动器上的日志读取
  * 添加了事务快照清理
  * 重新设计了事务决策逻辑
  * 为 initdevice 添加了取消删除选项
  * 添加了取消层级删除的能力
  * 修复了单节点层级在高负载下扩容时的潜在问题
  * 修复了驱动器删除时未能正确禁用设备头的问题
* 优化了系统性能：
  * 改进了驱动器操作响应时间（立即执行）
  * 修改了驱动刷新期间的光纤通道处理
  * 增强了从 URL 上传媒体映像的处理
  * 优化了多个表视图以提升性能

#### 身份验证与安全

* 增强了 OIDC 应用功能：
  * 修复了 HTTP 头处理
  * 改进了令牌端点的 JSON 响应
  * 移除了强制 scope 要求
* 修复了站点同步在创建时可能未正确配置的问题

#### 系统管理

* 改进了界面元素：
  * 增强了节点终止模式警告
  * 标准化了维护模式警告
  * 新增了关于新格式化磁盘交换分区设置的提示
  * 修复了租户仪表盘设备创建
  * 更正了配方问题部分的弹出按钮
  * 修复了帮助内容未正确链接到相应文档的问题
* 修复了以下问题：
  * 为站点自动创建修复服务器
  * IPSec 第一/第二阶段删除措辞
  * NAS 中的 CIFS 共享刷新
  * NAS 域成员共享挂载

### 系统更新

#### 安装改进

* 增强的 vSAN 设备管理：
  * 添加设备时日志暂停 15 分钟
  * 将 add-vsan-device 的超时时间增加到 15 分钟
  * 扩容期间立即添加驱动器
  * 修复了格式化启动盘时进度条的显示
  * 当尝试安装超出许可限制的节点时显示正确的错误
  * 修复了重启对话框的显示问题
  * 新增对指定默认 vSAN 配置文件的支持
  * 改进了 MTU 变更处理（如果之前链路已联通，则最多等待 10 秒）

#### 核心系统增强

* 升级到内核 6.6.79
* 增强了系统配置：
  * 为大网络增加了 ARP 缓存
  * 添加了 NVMe 控制器多路径绕过方案
  * 改进了启动流程（快 5 秒）
  * 为无人值守的裸机/虚拟化安装添加了 cloud-init 钩子
  * 在分区设备时更改了复制方式以绕过缓存
  * 修复了浏览器安全策略问题
  * 新增单节点系统重启后自动开启虚拟机电源
  * 添加了额外的测试和服务脚本
  * 增强了诊断能力

#### 错误修复

* 修复了以下各种问题：
  * vSAN 哈希映射重建
  * 元驱动器空间不足时可能出现的死锁
  * 影响稳定性的竞态条件
  * 带修复选项的完整性检查功能

## 4.13.3（2025年1月）

### 功能与改进

#### 虚拟机管理

* 增强的虚拟机配置能力：
  * 新增可通过高级选项指定虚拟机 smbios 数据（例如 smbios.type1.serial=XXXYYY）
  * 新增对高级 CPU 参数的支持（例如 cpu.split-lock-detect=off）
  * 新增对 machine、smp 和 rtc 参数的虚拟机高级选项支持
  * 修复了 CD-ROM“优化为”设置的遵循问题
  * 为虚拟机粘贴映射配置新增 UTF-8 支持
  * 改进了 ctrl-alt-del 后虚拟机控制台焦点
  * 修复了嵌套虚拟化中最佳 CPU 标志检测的问题
  * 修复了编辑虚拟机可能重置粘贴键映射或 RTC 设置的问题
* 增强了 cloud-init 处理：
  * 改进了虚拟机停止时的文件清理
  * 新增安装用 cloud-init 支持

#### 身份验证与安全

* 增强的双因素身份验证：
  * 为 2FA 失败代码尝试添加了审计日志
  * 改进了 TOTP 代码验证（允许 15 秒时间偏移容差）
* 改进了身份验证源管理：
  * 修复了使用身份验证源时的组成员更新
  * 在删除身份验证源时为组添加自动清理
  * 新增自动调试模式超时（1 小时）
  * 增强了 OIDC 应用的组管理支持

#### 系统管理

* 增强的维护模式：
  * 改进了关机期间对租户保留节点的处理
  * 新增无冗余的强制维护模式选项
  * 修复了租户节点保留相关的维护模式问题
* 改进的租户管理：
  * 为租户部署操作添加了队列系统
  * 增强了租户节点统计跟踪
  * 改进了租户节点临时目录的清理
  * 为租户新增系统密码要求强制检查
  * 修复了租户中虚拟 IP 所有权显示

#### 存储与基础设施

* 增强的 vSAN 功能：
  * 改进了诊断中的完整性检查监控
  * 增强了 vSAN 关机日志
  * 改进了网络不稳定期间的连接处理
* 上传改进：
  * 为 URL 上传新增系统范围的首选层级继承
  * 提高了上传传输速率的准确性

#### VMware 集成

* 增强的备份功能：
  * 为未按 4k 对齐磁盘的差异备份添加了修复
  * 改进了端口组查找的错误处理
  * 增强了磁盘大小显示精度（3 位小数）
  * 改进了导入选项的一致性

### 系统更新

* 核心系统改进：
  * 升级到内核 6.6.66
  * 将 QEMU 升级到 9.0.4
  * 通过 GSO 增强了 WireGuard TCP 性能
  * 添加了省电型 CPU 频率调节器
  * 改进了核心网络 DNS 和网关配置
  * 将文档链接更新为 docs.verge.io
* 安装增强：
  * 新增安装后自动关闭节点的选项
  * 改进了网络自动检测
  * 增强了驱动器选择流程
  * 在启动/关机期间添加了更详细的控制台输出
  * 修复了高级安装程序网络配置问题

### 错误修复

* 修复了以下各种问题：
  * 驱动器格式化期间的 NAS 配方状态
  * 云快照时间冲突
  * SSL 证书通用名称解析
  * 虚拟交换机端口配置
  * VMware 备份和导入流程
  * 迁移期间的网络连接维护
  * vGPU 配置文件放置 ID
  * 配方字段类型显示

## 4.13.2（2024年12月）

### 功能与改进

#### 虚拟机管理

* 增强的虚拟机配方功能：
  * 在访客代理连接时自动解除配方关联
  * 改进了意外重启期间的部署连续性
* 新增 API 支持：
  * 机器电源状态的 PUT 支持
  * 通过 API 创建 cloud-init 文件
* 修复了带控制台密码的虚拟机的已弃用 QEMU 日志
* 改进了自动启动能力：
  * 当资源可用时，为网络、虚拟机、租户节点和 VMware 服务添加电源开启标记

#### VMware 集成

* 修复了 VMware 文件下载：
  * 改进了 vmx、nvram 和 vmxf 文件/资源的处理

#### 系统管理

* 增强的维护模式：
  * 新增对单一故障节点维护的支持（驱动器故障场景）
* 改进的 UI/UX：
  * 修复了节点驱动器温度仪表盘显示
  * 增强了 vSAN 仪表盘遍历进度显示
  * 更改了完整遍历进度的可见性
  * 通过默认文本排序改进了表单下拉菜单
  * 修复了长历史图表在 0 字节时的显示问题
  * 修复了在线机器的 VNET 列表关机弹窗
* 修改了后端包安装流程

#### 存储与 vSAN

* 增强的 vSAN 功能：
  * 在启动期间改进了控制器投票，以更好地进行脑裂检测
  * 修复了空闲状态下仪表盘遍历进度的显示
* 修复了需要重启的外部网络绑定接口处理

### 操作系统与安装

#### 系统基础设施

* 增强的存储支持：
  * 新增 NVMe 多路径支持
  * 修复了光纤通道设备列表
  * 改进了使用 FC 卡的启动分区刷写
* 系统改进：
  * 将 grub 启动标题改为“VergeOS”
  * 在关机期间加速启动分区刷写
  * 修复了 vSAN 同步期间可能出现的内存问题

#### 系统管理

* 增强的框架处理：
  * 改进了从 node2 到 node1 的控制器移交
  * 修复了节点连接阶段罕见的死锁
* 改进了物理访问：
  * 修复了登录问题
  * 移除了误报错误日志

## 4.13.1（2024年11月）

### 虚拟机管理

#### UI 改进

* 修复了虚拟机仪表盘刷新时核心复选框的持久化
* 增强了统计图上的核心复选框行为
* 改进了基于集群的虚拟机迁移节点过滤
* 增强了 vGPU 配置文件按名称排序
* 更新了硬重置/重启操作的审计日志

#### 功能

* 为需要 ISO 的 Marketplace 配方虚拟机添加了下载完成检查
* 增强了 ISO 管理：
  * 修复了虚拟机离线时已挂载 ISO 的重命名
  * 改进了媒体处理

### 系统管理

#### 资源管理

* 增强的资源组功能：
  * 为机器设备添加了资源组指定
  * 修复了带已挂载设备的资源组删除
  * 改进了设备管理
* 添加了 vGPU 配置文件显示改进：
  * 添加了帧率信息
  * 添加了 VRAM 详情
* 在启动时实现了自动节点资源清理

#### 系统工具

* 增强的系统诊断：
  * 实现了 256K 分块上传
  * 提升了性能和可靠性
* 改进了计划任务：
  * 移除了旧的 2019 默认日期
  * 增强了计划功能

#### VMware 集成

* 增强的备份作业管理：
  * 在列表视图中添加了暂停/继续/停止控制
  * 添加了备份模式显示
  * 移除了容器服务启动时的内核警告

### 存储与基础设施

#### VSAN 改进

* 修复了关键场景：
  * 解决了同层数据移动触发 trans snap 的问题
  * 修复了存在 FC 卡时的驱动器列表
  * 增强了大修复数量（>500 次修复）的完整性检查

#### 系统服务

* 增强了应用服务器功能：
  * 新增通过 URL 支持代理源 IP
  * 改进了文件缓存设置（从私有到公共）
  * 新增通用代理源 IP 支持
* 更新了 Samba 配置：
  * 优化了 ACL 处理
  * 在未加入 AD 时移除了自动启用 DFS

### 操作系统与安装

* 升级到内核 6.6.60
* 修复了各种稳定性问题
* 增强了服务配置
* 将系统端点更新为 vergeos.com
* 移除了不必要的调试日志

## 4.13.0（2024年11月）

### 主要功能与主题

#### 硬件与资源管理

* 新增资源直通能力：
  * 支持将 USB、PCI 和 SRIOV 网卡直通到虚拟机和租户节点
  * 用于系统资源可视化的新仪表盘
  * 为 mlx5 添加了 SRIOV eswitch 支持
* 实现了实验性的 vGPU 热迁移（集群设置）
* 新增对 NVIDIA GRID 版本的支持：
  * 16.6, 16.7, 16.8
  * 17.2, 17.3, 17.4
* 移除了 16.6 之前的 NVIDIA GRID 驱动支持（内核不兼容）

#### 虚拟机增强

* 增强了能力：
  * 虚拟磁盘的最大文件大小现为 256TB
  * 将每个租户节点的最大 CPU 数增加到 1024
  * 所有使用 9.0 或更新版本的机器类型都会自动包含 USB 控制器
* 添加了 SMBIOS 改进：
  * 提供给虚拟机的产品厂商和序列号
* 增强的虚拟机管理：
  * 新增优雅重启选项（配合 guest agent 最可靠）
  * 将 Reset 更改为“硬重置”，并将 Reboot 更改为“重新启动”
  * 用于驱动器接口的可热插拔虚拟 USB 控制器
  * 优化虚拟机磁盘静默处理
  * QEMU 9.0 的新机器类型

#### 网络与基础设施

* 增强的绑定功能：
  * 支持将多个核心物理接口接入 VLAN
  * 更改默认绑定设置以防止配置错误
  * 支持带标签 VLAN 的绑定核心物理网卡
  * 新增安装后将物理网络更改为绑定网络的能力
* 改进的网络管理：
  * 为具有静态 IP 的外部网络添加脑裂检测
  * 在新系统部署创建的外部网络中添加了“允许 Ping”规则（即访问 UI 的网络）。此规则默认禁用。
  * 支持在启用代理的网络中使用 IP 别名

#### 存储与备份

* 增强的虚拟机导出功能：
  * 将最大卷虚拟机导出数量从 20 提高到 100
  * 新增 NFSv4 和扩展属性支持
  * 新增对备份厂商的读写支持
  * 更快的虚拟机导入（无需磁盘复制/转换）
  * API 支持名称覆盖和虚拟机列表
* 改进的云快照能力：
  * 最大值从 1000 提高到 2048
  * 现在包含来自 sys 目录的节点和层级目录
  * 新增 vSAN 配置复制
  * 支持在租户/虚拟机恢复中多选

### 功能改进

#### VMware 集成

* 增强的备份功能：
  * 移除预导入列表 50 台虚拟机限制
  * 修复了对内存小于 256M 的虚拟机的处理
  * 新增无完整刷新的备份任务设置
  * 修复了 VMware Backup Service 的 CPU 使用率报告
* 改进的虚拟机导入：
  * 支持接口覆盖（磁盘和网卡）
  * 可忽略光驱的选项

#### 身份验证与安全

* 增强的双因素认证：
  * 在启用前增加验证要求
  * 在用户仪表板、列表和资料中添加类型
  * 修复 OpenSSL Cipher URL
* 修复了以下问题：
  * 管理员权限管理
  * 无效认证源图标处理
  * 使用长用户名进行 OIDC 登录

#### 系统与集群管理

* 增强的更新流程：
  * 新增设置：
    * 热重启：更新期间更快地重启节点（绕过 BIOS/EFI）
    * 多集群更新：跨集群同时更新
  * 流程改进：
    * 如果用户手动重启服务器，更新将暂停
    * 状态/日志仅在成功进入维护模式后更新
    * 移除了多余的存储冗余要求
    * 支持并行更新（node1 之后每个集群一个节点）
    * 控制器故障切换期间增强的状态日志记录
* 改进的维护模式：
  * 支持多个节点同时进入（遵守 vSAN 冗余）
  * API 支持强制维护模式
  * 维护期间增强的虚拟机迁移：
    * 对于 >40Gbps 网络为 4 台虚拟机
    * 对于 >10Gbps 网络为 2 台虚拟机
    * 可通过高级设置配置

#### 存储与 vSAN

* 增强的 vSAN 管理：
  * 改进的集群层级仪表板，包含完整的节点列表
  * 通过 vSAN Diagnostics 新增手动添加磁盘
  * 在诊断中新增 Get Tier Status
  * 更好地跟踪 vSAN 连通性
  * 扩容期间磁盘设置为初始化中
  * 将 IO 默认超时时间从 30 秒更改为 7 秒
  * 为光纤通道和 DAS 存储实现多路径（主动/被动）
  * 实现节点间多通道通信
  * 新增用于租户使用控制的卷层级限速
* 存储改进：
  * 移除了虚拟机磁盘层级更改必须离线的要求
  * 修复了卷同步删除问题
  * 增强备份集群中的快照管理

#### 租户管理

* 增强的租户功能：
  * 支持所有介质镜像类型（不仅限于 ISO）
  * 在仪表板中添加机器设备数量
  * 克隆时自动禁用站点和同步
  * 修复了克隆租户中的证书可见性
  * 更好地处理租户默认路由
  * 改进了克隆期间设备离线状态
* 新增 HA 组改进：
  * 为同机放置偏好新增“+”前缀功能
  * 增强的虚拟机放置优化

#### 网络与连接

* 改进的网络操作：
  * 虚拟交换机端口连接延迟到迁移完成后
  * 增强的 WireGuard 对等端创建
  * 更好地显示 IP 地址归属
  * 改进的绑定网络配置
* 在 Route/Translate 的网络规则中重新加入“我的 DMZ”
* 修复了物理接口的 Layer2 类型更改问题

### 系统管理

#### 配置与管理

* SMTP 改进：
  * 更改 NTP 重启行为
  * 在新安装中移除默认发件人地址
  * 为缺失的发件人地址添加警告
  * 增强的邮件文件处理
* UI/UX 更新：
  * 将“刷新 PCI 设备”更改为“刷新设备”
  * 添加首选层级空间检查通知
  * 增强许可证管理和市场交互
  * 改进 CIFS/NFS 的共享状态可见性

#### 文件管理与上传

* 增强的文件上传能力：
  * 通过 API 新增对 xz/gz 格式的实时解压
  * 改进上传状态监控
  * 增强的公开链接处理
* 新增 ISO 生成功能：
  * 通过 API 支持 zip 文件和其他 ISO
  * 为 vGPU 设置自动创建 guest driver ISO

### 操作系统与安装

#### 安装过程

* 增强的网络配置：
  * 改进核心网络网卡扫描以检测冲突
  * 更好的 MTU 问题检测和提示信息
  * 移除物理交换机配置提示
  * 增强的自动网络检测
  * 支持没有物理核心网络的单节点
* 新增系统分类提示（POC/试用/家庭实验室或生产）
* 改进的磁盘管理：
  * 更好的多路径磁盘处理
  * 增强的 vSAN 设备选择
  * 剩余磁盘引导分区刷写选项
  * 扩容/节点替换期间改进的磁盘格式化

#### 系统基础设施

* 内核和核心更新：
  * 升级到内核 6.6.56
  * 将基础 QEMU 升级到 9.0.3
  * 为 frr 添加 RPKI 包
  * 增强 TCP 和网络缓冲区设置
* 硬件支持：
  * 添加 Xilinx 和 USB 网络驱动
  * 为某些 Broadcom 网卡禁用硬件卸载
  * 添加了有问题的 NVMe 磁盘处理代码
  * 增强 mlx5 驱动支持
  * 新增通过 IOMMU 放宽 RMRR 的能力

#### 启动与系统管理

* 增强的启动过程：
  * 新增使用 kexec 的快速重启
  * 改进 EFI 处理
  * PCI 插槽更改后更好地检测绑定网卡
  * 未关联网卡时更快启动
* 安全改进：
  * 新增禁用 SSH 密码选项
  * 增强的物理访问登录跟踪
  * 改进登录暴力破解处理
  * 更好的多 SSH 会话管理

### 错误修复

* 修复了以下各种问题：
  * 云快照恢复场景
  * 虚拟机重置后的 guest agent 功能
  * 卷导出共享 FSID 稳定性
  * 租户快照时序场景
  * 租户配方中的数据库问题处理
  * 节点 CPU 使用率报告
  * IPSec Phase1 预共享密钥可见性
  * 站点同步统计显示
  * 虚拟机导出静默处理
  * 通过 API 更新引导分区
  * NTP 闰秒处理
  * Syslog 正则过滤器重新加载


---

# 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/2025-nian-huo-geng-zao/4-13-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.