Ventoy进阶：ventoy.json配置速查手册（附生产级组合配置）修订版

Ventoy进阶：ventoy.json配置速查手册（附生产级组合配置）

image

前言Ventoy的基础玩法很简单：装到 U盘、拷 ISO、启动。但当你需要定制启动菜单、配置无人值守安装、或者换一套好看的主题时，就绕不开 ventoy.json这个配置文件。

网上关于 ventoy.json的资料散落在**文档、论坛帖子和零星博客里，缺少一份分类清晰、即查即用的中文参考。这篇按插件类型分组整理了常用配置，每一节先解释这个插件解决什么问题，再给出配置格式和示例，末尾有一份整合好的组合配置可以直接用。

基础规则在正式开始之前，先明确几个避坑要点。ventoy.json如果放错位置或者格式不对，Ventoy直接忽略不报错，排查起来很费时间。

项目 规则
文件位置 U盘数据分区 /ventoy/ventoy.json
编码格式 UTF-8，无 BOM
最外层结构 {}对象，不能是数组
大小写 目录名 ventoy、文件名 ventoy.json必须全小写
语法检查 启动菜单按 F5 →选择 Check ventoy.json

最重要的坑：不要把文件放进32MB的 VTOYEFI分区，要放在存 ISO的大分区。两个分区在 Windows资源管理器里容易搞混，认准容量大的那个。

如果你不习惯手写 JSON，可以用 VentoyPlugson.exe（Ventoy内置的图形化配置工具，浏览器操作）来生成基础配置。但有些高级选项 VentoyPlugson没覆盖，最终还是得手动编辑。所以直接掌握 ventoy.json的写法，自由度最高。

一、全局控制插件 control这个插件控制 Ventoy的全局行为——菜单语言、显示方式、搜索范围、倒计时等等。所有配置项放在 "control": [...]数组中，每个配置项一个 {}对象。

菜单语言与显示模式U盘里塞了十几个 ISO之后，默认的列表菜单会变得很长，翻找费劲。

语言设置：

{ "VTOY_MENU_LANGUAGE": "zh_CN" }

显示模式有两种选择：

{ "VTOY_DEFAULT_MENU_MODE": "0" }
  • "0"：列表模式，所有 ISO平铺显示，适合镜像数量少的情况- "1"：树形模式，按目录层级折叠显示，镜像多了之后管理起来清晰很多开启了树形模式后，可以进一步控制显示风格：
{ "VTOY_TREE_VIEW_MENU_STYLE": "0" }
  • "0"：目录名前带 [DIR]前缀和文件大小，信息更全- "1"：简洁模式，不显示前缀，视觉更干净这个看个人偏好，两种模式可以在 VentoyPlugson里预览效果再决定。

搜索范围控制如果你的 U盘同时当普通存储使用，里面可能有几百个文件。Ventoy默认全盘扫描所有 ISO，文件一多启动菜单加载就会变慢。限制搜索范围是最直接的优化手段。

{ "VTOY_DEFAULT_SEARCH_ROOT": "/ISO" }

设置之后 Ventoy只搜索指定目录及其子目录。把所有镜像统一放在 /ISO/下，既能加速启动，也好管理。

配合搜索深度控制：

{ "VTOY_MAX_SEARCH_LEVEL": "2" }
  • "0"：只搜根目录- "1"：搜到一级子目录- "max"：搜所有层级（默认值）

菜单倒计时 +默认镜像给多台相同配置的机器批量装系统时，每次启动都要手动选镜像很烦。设一个默认启动项配合倒计时，插上 U盘开机后自动进入安装流程。

{ "VTOY_MENU_TIMEOUT": "10" },
{ "VTOY_DEFAULT_IMAGE": "/ISO/win11.iso" }

倒计时过程中按任意键可以中断，切回手动选择。这个功能配合后面的自动安装插件，能做到插盘开机→自动进安装程序→无人值守装完，全程不用碰键盘。

其他常用控制项macOS往 U盘复制文件时会自动生成以 ._开头的隐藏元数据文件，Ventoy会把这些也当成可启动项列出来，菜单里多一堆无用的条目。加上这个过滤掉：

{ "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" }

Windows11有 TPM2.0、Secure Boot和内存的硬性要求，很多旧机器卡在检测上。Ventoy可以一行配置绕过：

{ "VTOY_WIN11_BYPASS_CHECK": "1" },
{ "VTOY_WIN11_BYPASS_NRO": "1" }
  • VTOY_WIN11_BYPASS_CHECK：跳过 TPM2.0、Secure Boot、4GB内存限制- VTOY_WIN11_BYPASS_NRO：跳过联网创建微软账户的步骤两个都加上，旧电脑装 Win11的障碍基本扫清。

二、主题插件 theme默认的蓝底白字启动菜单虽然能用，但视觉上确实单调。Ventoy基于 GRUB2，兼容所有 GRUB2主题，Gnome-look.org上有大量现成的。换一套主题只需要指定主题文件路径和分辨率。

基础主题配置：

"theme": {
  "file": "/ventoy/theme/dedsec/theme.txt",
  "gfxmode": "1920x1080"
}
  • file：主题主文件的绝对路径- gfxmode：分辨率，需要和屏幕匹配。1080p屏幕用4K主题会显示不全，反过来字体偏小如果你在不同分辨率的机器上使用同一个 U盘，可以准备多套主题让 Ventoy自动适配：
"theme": {
  "file": [
    "/ventoy/theme/1080p/theme.txt",
    "/ventoy/theme/4k/theme.txt"
  ],
  "resolution_fit": "1"
}

开启 resolution_fit后，Ventoy检测当前屏幕分辨率，自动选择最匹配的主题。一套1080p主题、一套4K主题，走到哪都不怕显示异常。

三、菜单别名插件 menu_aliasISO文件名通常是一长串字母数字组合，比如 ubuntu-24.04.1-desktop-amd64.iso，在启动菜单里既占空间又不好辨认。别名插件能把这些文件名替换成简洁的中文标签，菜单整洁很多。

"menu_alias": [
  { "image": "/ISO/ubuntu-24.04.1-desktop-amd64.iso", "alias": "Ubuntu24.04 LTS" },
  { "image": "/ISO/Win11_24H2_Chinese_Simplified_x64.iso", "alias": "Windows1124H2" },
  { "image": "/ISO/WePE_64_V2.3.iso", "alias": "微PE工具箱2.3" }
]

image是镜像在 U盘上的完整路径，alias是显示在菜单里的名字。支持中文，不限长度（但太长菜单上会被截断，控制在15个字以内比较合适）。

四、自动安装插件 auto_install手动装系统要经历"选择语言→选择键盘→接受许可→分区→创建账户……"一连串点击。如果一次装多台机器，重复操作很枯燥。这个插件让你提前准备一份应答文件，启动后自动走完所有步骤。

Windows无人值守需要一个 autounattend.xml文件。可以用在线工具（比如 windowsafg.com）按向导生成，不需要自己从头写 XML。生成后放到 U盘里，配置绑定关系：

"auto_install": [
  {
    "image": "/ISO/Win11_24H2.iso",
    "template": "/ventoy/script/win11_autounattend.xml"
  }
]

Linux Kickstart同理，CentOS/RHEL系用 .cfg应答文件：

"auto_install": [
  {
    "image": "/ISO/CentOS-7-x86_64-DVD.iso",
    "template": "/ventoy/script/centos7_ks.cfg"
  }
]

可以给不同的镜像绑定不同的应答文件。比如 Win11用一份自动分区的 xml，Win10用另一份保留数据分区的 xml，互不干扰。

注意：自动分区应答文件涉及磁盘操作，建议先在虚拟机里跑一遍确认逻辑正确，再拿到真机上用。

五、启动配置替换插件 conf_replace有些场景下不想修改原版 ISO，但需要调整启动参数——比如给 Linux内核加 nomodeset参数解决显卡兼容问题。这个插件允许你在不重新打包 ISO的情况下，用 U盘上的自定义文件替换启动阶段的配置。

"conf_replace": [
  {
    "iso": "/ISO/ubuntu-22.04.iso",
    "org": "/boot/grub/grub.cfg",
    "new": "/ventoy/ubuntu_grub_custom.cfg"
  }
]
  • org：ISO内原始配置文件路径- new：U盘上替换文件的路径如果你的环境需要区分 BIOS/Legacy和 UEFI两种启动模式，可以分别指定：
"conf_replace_legacy": [ ... ],
"conf_replace_uefi": [ ... ]

这个插件对 Linux维护场景特别有用。比如某台机器的显卡需要特定内核参数才能进桌面，不用每次手动编辑，提前写好替换文件一劳永逸。

六、密码保护插件 password如果你的 U盘里放着公司的批量部署镜像或者一些敏感工具，加上密码可以防止无关人员随意启动。

全局密码最简单，进入 Ventoy菜单就需要输入：

"password": {
  "global": "mySecurePwd"
}

也可以按镜像分别设置不同密码，比如 PE工具设一个密码、Windows安装镜像设另一个：

"password": {
  "image": [
    { "image": "/ISO/winpe.iso", "pwd": "admin123" },
    { "image": "/ISO/kali.iso", "pwd": "kali2024" }
  ]
}

七、镜像列表插件 image_list默认 Ventoy自动扫描整个 U盘找出所有可启动文件。不想全部显示的话，用这个插件手动指定要出现在菜单里的镜像清单：

"image_list": [
  "/ISO/win11.iso",
  "/ISO/ubuntu.iso",
  "/ISO/winpe.iso"
]

配置后只显示列表里的文件，U盘上其他 ISO不会出现在菜单中。适合 U盘里同时放了"公开用"和"备用不放"两类镜像的场景。

八、DUD驱动注入插件 dud某些服务器或工作站用了特殊 RAID卡/NVMe控制器，标准 Linux安装镜像不认硬盘。这个插件允许在启动时注入额外驱动。

"dud": [
  {
    "image": "/ISO/rhel9.iso",
    "dud": "/ventoy/driver/raid_driver.img"
  }
]

驱动文件通常从硬件厂商官网下载 .img或 .iso格式的驱动镜像。配置后启动对应系统时会自动加载，安装程序就能识别硬盘了。服务器运维场景下这个功能很实用。

生产级组合配置把以上常用插件整合成一份可直接使用的 ventoy.json：

{
  "control": [
    { "VTOY_DEFAULT_MENU_MODE": "0" },
    { "VTOY_DEFAULT_SEARCH_ROOT": "/ISO" },
    { "VTOY_MAX_SEARCH_LEVEL": "max" },
    { "VTOY_MENU_TIMEOUT": "15" },
    { "VTOY_DEFAULT_IMAGE": "/ISO/Win11_24H2.iso" },
    { "VTOY_WIN11_BYPASS_CHECK": "1" },
    { "VTOY_WIN11_BYPASS_NRO": "1" },
    { "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" }
  ],
  "theme": {
    "file": "/ventoy/theme/dedsec/theme.txt",
    "gfxmode": "1920x1080"
  },
  "menu_alias": [
    { "image": "/ISO/Win11_24H2.iso", "alias": "Windows1124H2" },
    { "image": "/ISO/ubuntu-24.04.iso", "alias": "Ubuntu24.04 LTS" },
    { "image": "/ISO/WePE_64.iso", "alias": "微PE工具箱" }
  ],
  "auto_install": [
    {
      "image": "/ISO/Win11_24H2.iso",
      "template": "/ventoy/script/autounattend.xml"
    }
  ]
}

这份配置实现的效果：中文列表菜单、限定搜索 /ISO目录、15秒倒计时默认启动 Win11、自动跳过 TPM检测和微软账户步骤、应用自定义主题、镜像显示别名、Windows自动安装。根据自己的需求增删对应模块即可。

下载：https://ventoy.ijinshan.com/

配置注意事项：JSON不支持注释，改完在启动菜单按 F5做语法检查，所有路径用绝对路径（以 /开头）。更多插件参考 Ventoy**文档。

posted @ 2026-06-15 10:01  PC修复电脑医生  阅读(62)  评论(0)    收藏  举报