在 Devin 中试用 DeepWiki 处理私有仓库
DeepWiki

ventoy/Ventoy

菜单

安装工具

相关源文件

此页面文档介绍了用于将 Ventoy 安装到 U 盘的工具。Ventoy 为 Windows 和 Linux 平台提供了安装工具，允许用户创建可以托管多个 ISO 文件而无需重新格式化的可启动 U 盘。有关安装后启动过程的信息，请参阅 启动过程。

安装工具概述

Ventoy 提供多种为不同操作系统和架构优化的安装工具

平台工具名称描述
WindowsVentoy2Disk.exe带图形界面的 32 位 Windows 安装程序
WindowsVentoy2Disk_X64.exe带图形界面的 64 位 Windows 安装程序
WindowsVentoy2Disk_ARM.exe带图形界面的 32 位 ARM Windows 安装程序
WindowsVentoy2Disk_ARM64.exe带图形界面的 64 位 ARM Windows 安装程序
LinuxVentoy2Disk.shLinux 发行版的命令行安装程序

这些工具共享通用的核心功能，但打包方式不同，以适应特定平台的需要。

来源: INSTALL/Ventoy2Disk.exe, INSTALL/Ventoy2Disk_X64.exe, INSTALL/Ventoy2Disk_ARM.exe, INSTALL/Ventoy2Disk_ARM64.exe, INSTALL/tool/VentoyWorker.sh

安装工具架构

Ventoy 安装工具采用模块化架构，在保持平台特定实现的同时，跨平台共享通用组件。

安装工具组件

来源: Ventoy2Disk/Ventoy2Disk/Ventoy2Disk.h, Ventoy2Disk/Ventoy2Disk/PhyDrive.c, Ventoy2Disk/Ventoy2Disk/WinDialog.c, INSTALL/tool/VentoyWorker.sh, INSTALL/tool/ventoy_lib.sh

安装流程

所有平台的安装过程遵循相似的工作流程

来源: INSTALL/tool/VentoyWorker.sh:175-372, INSTALL/tool/VentoyWorker.sh:539-575

Windows 安装工具

Windows 安装工具提供了一个图形用户界面，用于将 Ventoy 安装到 U 盘。它有多种架构变体，以支持不同的 Windows 环境。

关键组件

  1. 物理驱动器处理程序 (PhyDrive.c): 处理物理驱动器操作，例如

    • 查找并列出可用驱动器
    • 获取驱动器属性
    • 读写物理驱动器
    • 将驱动器盘符映射到物理设备

  2. GUI 对话框处理程序 (WinDialog.c): 管理用户界面，包括

    • 主安装对话框
    • 进度报告
    • 语言选择
    • 分区样式选择
    • 安全启动选项

Windows 工具使用

Windows 安装程序的 GUI 提供了一个简单的界面

  1. 从下拉列表中选择一个目标 U 盘
  2. 选择安装选项（MBR/GPT，安全启动支持）
  3. 点击“安装”或“更新”按钮
  4. 监控进度并等待完成

来源: Ventoy2Disk/Ventoy2Disk/PhyDrive.c, Ventoy2Disk/Ventoy2Disk/WinDialog.c

Linux 安装工具

Linux 安装工具基于命令行，由多个 shell 脚本协同工作来安装 Ventoy。

关键组件

  1. Ventoy2Disk.sh: 主入口脚本，用于解析参数并调用 VentoyWorker.sh

  2. VentoyWorker.sh: 实现实际的安装逻辑

  3. ventoy_lib.sh: 提供安装脚本使用的通用库函数

Linux 工具命令选项

Usage: Ventoy2Disk.sh CMD [ OPTION ] /dev/sdX
  CMD:
   -i  install Ventoy to sdX (fails if disk already installed with Ventoy)
   -I  force install Ventoy to sdX (no matter if installed or not)
   -u  update Ventoy in sdX
   -l  list Ventoy information in sdX

  OPTION: (optional)
   -r SIZE_MB  preserve some space at the bottom of the disk (only for install)
   -s/-S       enable/disable secure boot support (default is enabled)
   -g          use GPT partition style, default is MBR (only for install)
   -L          Label of the 1st exfat partition (default is Ventoy)
   -n          try non-destructive installation (only for install)

来源: INSTALL/tool/VentoyWorker.sh:5-21, INSTALL/tool/ventoy_lib.sh, INSTALL/tool/VentoyWorker.sh:373-538

磁盘分区结构

Ventoy 在安装过程中会在目标 U 盘上创建特定的分区结构

分区布局如下

  1. 分区 1 (主存储):

    • 文件系统：ExFAT (默认)
    • 用途：存储 ISO 文件和用户数据
    • 大小：大部分驱动器空间

  2. 分区 2 (Ventoy 核心):

    • 固定大小为 32MB
    • 包含 Ventoy 核心组件
    • 如果启用了安全启动，则支持安全启动

来源: INSTALL/tool/ventoy_lib.sh:3-7, INSTALL/tool/VentoyWorker.sh:301-331

安装模式

Ventoy 安装工具支持三种主要操作模式

1. 安装模式

将 Ventoy 安装到新驱动器。此模式

  • 创建新的分区结构
  • 安装引导加载程序和核心组件
  • 设置用于 ISO 存储的文件系统
  • 可能具有破坏性（擦除现有数据）

2. 更新模式

更新现有的 Ventoy 安装。此模式

  • 保留第一个分区（ISO 文件）中的数据
  • 仅更新引导加载程序和核心组件
  • 维护用户配置设置
  • 对用户数据无破坏性

3. 列出模式

显示有关现有 Ventoy 安装的信息

  • Ventoy 版本
  • 分区样式（MBR/GPT）
  • 安全启动支持状态

来源: INSTALL/tool/VentoyWorker.sh:113-135, INSTALL/tool/VentoyWorker.sh:539-575

无损安装

Ventoy 1.0.15+ 在 Linux 上增加了对无损安装的支持，使用了 -n 选项。此模式

  1. 尝试安装 Ventoy 而不重新格式化整个驱动器
  2. 保留驱动器上现有数据
  3. 必要时缩小现有分区
  4. 支持不同的文件系统（NTFS、EXT2/3/4）

此功能对于将 Ventoy 添加到已包含数据的驱动器特别有用。

来源: INSTALL/tool/VentoyWorker.sh:373-538

安全启动支持

Windows 和 Linux 工具都支持启用或禁用安全启动

  • Windows 工具：GUI 中的选项
  • Linux 工具：-s (启用) 或 -S (禁用) 标志

当安全启动启用时，会安装额外的证书和 EFI 文件，以确保与 UEFI 安全启动环境的兼容性。

来源: INSTALL/tool/VentoyWorker.sh:363-367, INSTALL/tool/VentoyWorker.sh:522-524

安装文件

安装过程中写入的核心文件包括

  1. boot.img：写入 MBR（磁盘的前 446 字节）
  2. core.img.xz：包含 GRUB 核心映像
  3. ventoy.disk.img.xz：包含分区 2 的 Ventoy 核心组件

EFI 目录中包含用于 EFI 启动的额外文件。

来源: INSTALL/tool/VentoyWorker.sh:333-347, INSTALL/tool/VentoyWorker.sh:496-509

安装验证

两个工具在安装前都会执行验证检查

  1. 确保选定的目标是物理驱动器，而不是分区
  2. 检查挂载的分区和交换空间使用情况
  3. 验证驱动器空间是否充足
  4. 检查 4K 原生扇区设备（不支持）
  5. 确认用户已了解数据丢失风险

来源: INSTALL/tool/VentoyWorker.sh:80-172, Ventoy2Disk/Ventoy2Disk/PhyDrive.c:137-169