插件配置

相关源文件

• .github/ISSUE_TEMPLATE/config.yml
• .github/ISSUE_TEMPLATE/issue_template.yml
• INSTALL/grub/grub.cfg
• Plugson/www/buildtime
• Plugson/www/helplist
• Plugson/www/index.html
• Plugson/www/menulist
• Plugson/www/plugson_menu_tip.html
• Plugson/www/plugson_password.html
• Plugson/www/plugson_theme.html
• README.md

目的与范围

本文档解释了如何在 Ventoy 中配置插件。插件通过自定义启动菜单外观、控制启动行为、添加密码保护以及提供其他功能来扩展 Ventoy 的功能。本页涵盖了插件配置系统的架构、ventoy.json 配置文件结构，以及如何使用 VentoyPlugson（图形化插件配置器）。有关特定插件功能的详细信息，请参阅相应的插件文档页面。

概述

Ventoy 的插件系统提供了一种灵活的方式来定制启动行为和用户体验。所有插件都通过一个名为 ventoy.json 的中央配置文件进行配置，该文件可以手动创建，也可以使用 VentoyPlugson Web 界面生成。Ventoy 启动时，会检查并加载此配置文件，并根据启动环境（Legacy BIOS、UEFI 等）应用设置。

插件配置架构

来源：INSTALL/grub/grub.cfg1-150 Plugson/www/index.html1-150

插件配置文件

Ventoy 插件通过放置在 Ventoy 设备根目录下的名为 ventoy.json 的 JSON 文件进行配置。对于平台特定的配置，您可以使用专用文件

配置文件	用途
ventoy.json	所有平台（默认）
ventoy_legacy.json	仅限 Legacy BIOS
ventoy_uefi.json	仅限 x86_64 UEFI
ventoy_ia32.json	仅限 IA32 UEFI
ventoy_aa64.json	仅限 ARM64 UEFI
ventoy_mips.json	仅限 MIPS64EL UEFI

在各自的平台上使用特定平台的配置会覆盖 ventoy.json 中的默认设置。

基本结构

ventoy.json 文件遵循此通用结构

每个插件在 JSON 文件中都有自己的部分，每个部分的结构因插件类型而异。

来源：README.md97-117

配置方法

使用 VentoyPlugson

VentoyPlugson 是一个用于配置 Ventoy 插件的图形用户界面。它是创建和编辑插件配置的推荐方式。

启动 VentoyPlugson

1. 从 Ventoy 安装包中启动 VentoyPlugson
2. Web 浏览器将自动打开，显示 VentoyPlugson 界面
3. 如果浏览器没有自动打开，请导航至 http://127.0.0.1:24680

VentoyPlugson 界面

VentoyPlugson 界面提供了一种用户友好的方式来配置所有 Ventoy 插件

来源：Plugson/www/index.html98-174

手动编辑 JSON

您也可以使用文本编辑器手动创建或编辑 ventoy.json 文件。此方法适用于高级配置或将相同配置部署到多个 Ventoy 设备的情况。

特定平台配置

Ventoy 允许平台特定的插件配置，仅在特定模式下启动时生效

1. 通用配置：使用 ventoy.json 进行适用于所有启动模式的设置
2. 平台特定配置：为仅在特定启动模式下适用的设置使用专用文件

例如，您可以在 UEFI 和 Legacy BIOS 模式下使用不同的主题

• 在 ventoy.json 中设置基本主题（适用于所有平台）
• 在 ventoy_uefi.json 中设置高分辨率主题（仅适用于 UEFI 模式）
• 在 ventoy_legacy.json 中设置低分辨率主题（仅适用于 Legacy BIOS 模式）

配置优先级

Ventoy 加载插件配置时，遵循以下优先级顺序

1. 特定平台的配置文件（如果存在且适用于当前启动模式）
2. 默认 ventoy.json 文件

这使您可以根据启动模式覆盖特定设置，同时维护通用的基础配置。

插件类型

Ventoy 包含以下插件类型，每种插件类型在 ventoy.json 文件中都有自己的配置部分

插件类型	目的	文档
全局控制	控制全局启动行为	全局控制插件
主题	自定义启动菜单外观	主题插件
菜单别名	为菜单项创建别名	-
菜单提示	向菜单项添加工具提示消息	-
Menu 类	对菜单项进行分类	-
自动安装	自动化操作系统安装	-
持久化	为 Linux 支持持久化存储	-
注入	将文件注入可启动介质	-
启动配置替换	替换启动配置文件	-
密码	添加密码保护	-
镜像列表	过滤菜单中显示的镜像文件	-
自动 Memdisk	配置自动 Memdisk 模式	-
驱动程序更新盘	支持驱动程序更新盘	-

来源：README.md97-117 Plugson/www/index.html98-174

插件加载过程

Ventoy 启动时，会通过 GRUB 配置文件加载和应用插件配置

来源：INSTALL/grub/grub.cfg90-111

配置示例

以下是一个包含多个插件配置的基本 ventoy.json 文件的示例

此示例包括

• 指向自定义主题文件的 Theme 配置
• Ubuntu 和 Windows ISO 文件的菜单别名
• 启动和 ISO 访问的密码保护
• 菜单模式和搜索路径的全局控制设置

密码插件特殊情况

由于其安全影响，密码插件值得特别提及。它支持三种密码格式

1. 纯文本：txt#password
2. MD5 哈希：md5#5f4dcc3b5aa765d61d8327deb882cf99
3. 加盐 MD5 哈希：md5#salt#hash_of_salt_and_password

VentoyPlugson 提供了一种通过其界面安全生成这些密码哈希的方法，如密码插件页面所示。

来源：Plugson/www/plugson_password.html147-164

延伸阅读

有关每种插件类型的详细信息，请参阅上面“插件类型”表中链接的特定插件文档页面。这些页面为每种插件类型提供了详细的配置选项和示例。