Ventoy 全局控制插件

本插件用来配置一些Ventoy的全局设置。比如默认显示模式等。

  • Json 配置

推荐使用 VentoyPlugson 工具进行配置,无需手动创建、编辑json文件。请参考 VentoyPlugson
关于 ventoy.json 的位置以及相关说明,请首先参考 插件入口 (*必读)
在镜像分区 /ventoy/ventoy.json 中定义了一个 control 数组来描述本插件,数组中的每个成员都是有一个字符串类型的键值对。
注意你不需要对这里列出来的每一项都做配置,可以只对其中的一项或几项做特殊配置,其他的会使用默认值.

{
    "control": [
        { "VTOY_MENU_LANGUAGE": "zh_CN" },
        { "VTOY_DEFAULT_MENU_MODE": "0" },
        { "VTOY_TREE_VIEW_MENU_STYLE": "0" },
        { "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" },
        { "VTOY_SORT_CASE_SENSITIVE": "0" },
        { "VTOY_MAX_SEARCH_LEVEL": "max" },
        { "VTOY_DEFAULT_SEARCH_ROOT": "/ISO" },        
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "/ISO/debian_netinstall.iso" },
        { "VTOY_FILE_FLT_EFI": "1" },
        { "VTOY_DEFAULT_KBD_LAYOUT": "QWERTY_USA" },
        { "VTOY_WIN11_BYPASS_CHECK": "1" },
        { "VTOY_WIN11_BYPASS_NRO": "1" },
        { "VTOY_LINUX_REMOUNT": "0" },
        { "VTOY_SECONDARY_BOOT_MENU": "1" },
        { "VTOY_SECONDARY_TIMEOUT": "20" }
    ]
}

关键字 类型 描述
VTOY_MENU_LANGUAGE STRING 启动菜单语言,可以设置为 "en_US", "zh_CN" 等。默认是 "en_US"。
具体支持哪些语言,以实际为准,可以在启动后的 Ventoy 界面上按 L 快捷键列出当前支持的语言列表。
VTOY_DEFAULT_MENU_MODE STRING 默认显示模式,"0":列表模式    "1":TreeView 模式。 默认值 “0” 列表模式。
VTOY_TREE_VIEW_MENU_STYLE STRING TreeView模式下的菜单风格,"0":显示DIR和文件大小    "1":不显示DIR和文件大小
默认是 "0"
VTOY_FILT_DOT_UNDERSCORE_FILE STRING 过滤以 ._ 开头的文件。当使用苹果系统时,有时拷贝文件会产生一些 ._ 开头的文件,可以通过此选项过滤掉。
"0": 不过滤     "1":过滤
VTOY_SORT_CASE_SENSITIVE STRING 在菜单排序时是否大小写敏感。默认是 "0" (大小写不敏感)
"0":大小写不敏感    "1":大小写敏感
VTOY_MAX_SEARCH_LEVEL STRING 最大搜索子目录的层数,取值为:max 0 1 2 3 ...    默认值为:max
默认Ventoy会递归搜索磁盘上的所有目录和子目录,不管目录结构有多深都会搜索到底。你可以通过这个参数来控制搜索时的路径深度。

max : 最大层数,也就是搜索所有子目录的意思。这也是 Ventoy 的默认值。
0 : 搜索0层子目录,只列出根目录下的文件,不去搜索任何一个子目录。
1 : 搜索1层子目录,除了根目录下的文件以外,再搜索根目录下的1级子目录。但是不再搜索1级子目录下的子目录(2级子目录)。
2 : 搜索2层子目录,除了根目录下的文件以外,再搜索根目录下的1级子目录以及1级子目录下的子目录(2级子目录)。
3 : 搜索3层子目录,......
...

注意,如果 VTOY_DEFAULT_SEARCH_ROOT 参数也同时设置了的话,则就以 VTOY_DEFAULT_SEARCH_ROOT 指定的目录作为根目录开始计算。
VTOY_DEFAULT_SEARCH_ROOT STRING 指定搜索ISO文件的根目录。默认Ventoy会搜索U盘上的所有目录和子目录,当你U盘上有海量的文件时,这个过程会很慢。这种情况下你可以把ISO文件单独放在某个目录下,然后通过这个变量来指定搜索路径,此时Ventoy就只会搜索该目录及其子目录。
VTOY_MENU_TIMEOUT STRING 菜单倒计时(秒)。默认不设置,设置之后,比如设置为10,则在倒计时10秒之后,会自动选择启动第1个镜像文件。在倒计时的过程中按任意键会停止倒计时,等待用户操作。
VTOY_DEFAULT_IMAGE STRING 正常情况下默认选中的是第1个镜像文件。通过这个选项可以设置默认选中的镜像文件,一般和 VTOY_MENU_TIMEOUT 一起使用。
可以设置为 WIM/VHD/IMG 等支持的文件,必须是以 / 开始的全路径,ListView模式和TreeView模式都支持。
注意,当同时设置了 VTOY_DEFAULT_SEARCH_ROOT 以后,VTOY_DEFAULT_IMAGE 对应的文件必须位于 VTOY_DEFAULT_SEARCH_ROOT 对应的目录下,否则不会生效。
除此之外,还可以设置为一些特殊值,参考本页特殊 VTOY_DEFAULT_IMAGE 值
VTOY_VHD_NO_WARNING STRING "0": 启动Windows VHD(x)时,如果U盘分区不是NTFS格式,则显示告警信息 "1": 不显示告警信息
默认是 "0",即显示告警信息
VTOY_DEFAULT_KBD_LAYOUT STRING 默认键盘布局,默认是 QWERTY_USA 支持的键盘布局有:
QWERTY_USA AZERTY CZECH_QWERTY CZECH_QWERTZ DANISH DVORAK_USA FRENCH GERMAN ITALIANO JAPAN_106 LATIN_USA PORTU_BRAZIL QWERTY_UK QWERTZ QWERTZ_HUN QWERTZ_SLOV_CROAT SPANISH SWEDISH TURKISH_Q VIETNAMESE
VTOY_FILE_FLT_ISO STRING "0": 不过滤 .iso 文件    "1": 过滤掉 .iso 文件。默认值是 "0",即不过滤。
VTOY_FILE_FLT_WIM STRING "0": 不过滤 .wim 文件    "1": 过滤掉 .wim 文件。默认值是 "0",即不过滤。
VTOY_FILE_FLT_EFI STRING "0": 不过滤 .efi 文件    "1": 过滤掉 .efi 文件。默认值是 "0",即不过滤。
VTOY_FILE_FLT_IMG STRING "0": 不过滤 .img 文件    "1": 过滤掉 .img 文件。默认值是 "0",即不过滤。
VTOY_FILE_FLT_VHD STRING "0": 不过滤 .vhd(x) 文件    "1": 过滤掉 .vhd(x) 文件。默认值是 "0",即不过滤。
VTOY_FILE_FLT_VTOY STRING "0": 不过滤 .vtoy 文件    "1": 过滤掉 .vtoy 文件。默认值是 "0",即不过滤。
VTOY_WIN11_BYPASS_CHECK STRING "0": 不绕过Windows 11安装时的硬件检查。    "1": 绕过Windows 11安装时的硬件检查。默认值是 "1",绕过。
当设置为1时,Ventoy会创建以下几个注册表项用来绕过 Windows 11 安装时的硬件检查。只对标准Windows 11 ISO文件有效,其他无效。
HKEY_LOCAL_MACHINE\SYSTEM\Setup\LabConfig\BypassRAMCheck
HKEY_LOCAL_MACHINE\SYSTEM\Setup\LabConfig\BypassTPMCheck
HKEY_LOCAL_MACHINE\SYSTEM\Setup\LabConfig\BypassSecureBootCheck
HKEY_LOCAL_MACHINE\SYSTEM\Setup\LabConfig\BypassCPUCheck
VTOY_WIN11_BYPASS_NRO STRING "0": 不绕过Windows 11安装时的在线账户需求。    "1": 绕过Windows 11安装时的在线账户需求。默认值是 "1",绕过。
当设置为1时,Ventoy会创建以下注册表项用来绕过 Windows 11 安装时的线账户需求。只对标准Windows 11 ISO文件有效,其他无效。
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\OOBE\BypassNRO
注意:安装时必须临时禁用网络或者拔掉网线才会有本地账户的提示。
VTOY_LINUX_REMOUNT STRING "0": Linux启动后不需要继续访问ISO文件所在的分区。   "1": Linux启动后需要继续访问ISO文件所在的分区。默认值是 "0"。
该选项只对 Linux 系统镜像有效。
默认情况下,受Linux内核相关功能的限制,对于Linux系统,在启动后无法继续访问ISO文件所在的分区。在mount的时候会提示 device busy。
如果这里选择 1,则 Ventoy 会尝试通过一些特殊的手段绕过内核的这个限制,但是这个功能是实验性质的,没有经过大规模和长时间的验证。
VTOY_SECONDARY_BOOT_MENU STRING "0": 不显示二级启动菜单 "1": 显示二级启动菜单。 默认值是 "1"
VTOY_SHOW_PASSWORD_ASTERISK STRING "0": 输入密码时不显示星号 "1": 输入密码时显示星号。 默认值是 "1"
VTOY_SECONDARY_TIMEOUT STRING 二级菜单倒计时(秒)。只有当 VTOY_SECONDARY_BOOT_MENU 设置为1时才有效。
默认不设置,设置之后,比如设置为10,则在倒计时10秒之后,会自动选择第一项,即:Boot in normal mode
在倒计时的过程中按任意键会停止倒计时,等待用户操作。
  • 特殊 VTOY_DEFAULT_IMAGE

你可以使用一些的特殊的 VTOY_DEFAULT_IMAGE 值来实现一些特殊功能。例如:
VTOY_EXIT: Ventoy 在超时之后会自动退出
Fn>xx>xx: Ventoy 自动执行 Fn 热键内的子菜单,比如 F4>Search and boot Windows

{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "VTOY_EXIT" }
    ]
}

{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F5>Power>Halt" }
    ]
}
{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F4>Search and boot Windows" }
    ]
}
{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F4>Boot the 1st local disk" }
    ]
}
{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F5>Check plugin json configuration (ventoy.json)>Check theme plugin configuration" }
    ]
}
  • 多模式选项

支持。可以分别针对 x86 Legacy BIOS、IA32 UEFI、x86_64 UEFI 和 ARM64 UEFI 模式做不同的设置。详细说明请参考 多模式选项