VentoyPlugson 完整使用指南7 步在浏览器里管理 Ventoy 密码、主题与持久化【免费下载链接】VentoyA new bootable USB solution.项目地址: https://gitcode.com/GitHub_Trending/ve/Ventoy你是不是也遇到过这种情况Ventoy U 盘装好了想给某些 ISO 加个启动密码结果得去官网翻插件说明、手写ventoy.json格式错一个引号就白干VentoyPlugson 就是官方给的图形化配置工具它在本地起一个 Web 服务你打开浏览器就能管理密码、主题、持久化这些高级功能配置文件它替你写。一句话认识 VentoyPlugsonVentoyPlugson 可以理解成一个运行在你电脑上的管理面板它读取你 Ventoy U 盘上的ventoy/ventoy.json把里面的密码、主题、持久化等配置做成表格和表单你改完点保存它再写回 U 盘。全程不用手写 JSON也不用手抄官网示例。能力适合谁你能拿到什么结果密码管理要给 U 盘加锁的人给整个启动流程或指定 ISO/WIM/IMG 目录设置密码支持按启动架构分别配置主题定制嫌启动菜单单调的人换菜单背景图、字体、颜色还能配多套主题按 F5 切换数据持久化用 Live 系统装软件存文件的人给 Linux Live ISO 配持久化存储关机后数据不丢菜单别名/提示/分类ISO 存得又多又乱的人把ubuntu-22.04-desktop-amd64.iso显示成Ubuntu 22.04按类型分组自动安装/文件注入批量装系统的高级玩家给指定 ISO 挂自动安装应答文件、注入自定义文件它的工作方式一句话就是浏览器发起请求 → 本地 Web 服务改配置 → 写回 U 盘。3 分钟跑通启动 VentoyPlugson 并打开面板跑通只需要一条命令前提是你的 Ventoy U 盘已经装好即 U 盘上有ventoy目录且能正常启动系统。第 1 步把 U 盘插上确认它已经挂载Plugson 需要直接访问 U 盘上的文件所以 U 盘第一个分区必须先挂载Windows 下就是能看到盘符Linux 下插进去一般自动挂载。挂载点下能看到ventoy目录就对了。第 2 步进入 Ventoy 的 INSTALL 目录工具都在这个目录里脚本会自动解压并启动对应 CPU 架构的Plugson二进制x86_64 / i386 / aarch64 / mips64el 各有一份脚本自己选cd INSTALL第 3 步用 sudo 启动传入整盘设备号sudo bash VentoyPlugson.sh /dev/sdX把/dev/sdX换成你 U 盘的真实设备名用lsblk或fdisk -l查注意是整盘如/dev/sdb不是分区。Linux 下必须加sudo脚本会检查 root 权限不是 root 直接退出。第 4 步看到设备信息 访问地址就算成功正常情况下终端会打印类似这样的信息说明设备识别正常、服务已启动Ventoy version in Disk: 1.0.97 Disk Partition Style : GPT Secure Boot Support : YES Ventoy Plugson Server 已经启动 ... 请打开浏览器访问 http://127.0.0.1:24681 ################## Press Ctrl C to exit #####################第 5 步浏览器打开 http://127.0.0.1:24681左侧就是功能菜单设备信息、全局控制插件、主题插件、菜单别名插件、数据持久化插件、密码插件等每一页对应 U 盘上ventoy.json里的一组配置。到这里你手上已经有了一个跑着的 Plugson 服务 一个能改配置的 Web 面板。改任何东西前先在设备信息页确认显示的是你预期的 U 盘。用完在终端按Ctrl C结束服务即可。我想给 U 盘加密码用密码插件保护启动项场景U 盘会借给别人你想让它启动 Ventoy 时先输密码或者只有 Windows 目录下的 ISO 需要单独设密码。进入密码插件页面左侧菜单点密码插件密码插件对应源码在 Plugson/www/plugson_password.html。页面分两大块Common Password通用密码和Menu Password菜单密码。设置通用密码通用密码管大门bootpwd控制进入 Ventoy 菜单时要不要密码isopwd/wimpwd/imgpwd/vhdpwd/efipwd/vtoypwd则分别给 ISO、WIM、IMG、VHD(x)、EFI、VTOY 这六类文件设默认密码。在对应行的操作列点设置弹出框里输入密码、选存储类型TXT 明文 / MD5 / Salt MD5确定即可。给指定文件或整个目录设密码在 Menu Password 区点添加填两样东西路径注意界面提示的是填当前系统中该文件的绝对路径比如 Linux 下 U 盘挂载在/media/usb就填/media/usb/ISO/Windows/类型选file匹配单个文件选parent目录则目录下所有文件都套这个密码也支持*通配符例如/media/usb/ISO/Ubuntu*.iso存好后 VentoyPlugson 会把密码写进ventoy.json的menu_pwd段下次启动走到对应项就会弹密码框。为什么页面顶上有 6 个标签页password、password_legacy、password_uefi、password_ia32、password_aa64、password_mips对应不同启动环境传统 BIOS / UEFI / 各 CPU 架构。password是总默认只在某些环境下有特殊要求时才切到对应标签页单独配一般用户只配第一页就够。我想换个启动菜单皮肤3 步完成主题定制场景默认菜单太素想换成自己做的背景图字体颜色也调一调。添加主题文件左侧点主题插件在文件表里点添加填 U 盘上theme.txt的全路径例如 Linux 挂载在/media/usb时填/media/usb/ventoy/themes/mytheme/theme.txt。主题文件本身是一段 GRUB 风格的配置背景、字体、颜色你直接编辑文本就行Plugson 负责把它登记进ventoy.json。配字体和显示模式同一个页面里还能添加.pf2字体文件GRUB 的专用字体格式并设置dismode显示模式如 GUI / CLI / 串口和gfxmode分辨率。多配了几个主题文件时启动后按F5 → Tools → Theme Select可以现场切换不用重新写配置。保存并预览改完点保存再点页面右上角的Preview预览能直接看到最终生成的插件配置 JSON确认无误后拔盘重启机器验证效果。页面右上角还有指向官网主题插件文档的入口resolution_fit这类细分选项可以按需查。我想让 Live 系统数据不丢配置数据持久化场景你拿 Ubuntu Live 版装软件、存文档重启后全没了想给这个 ISO 配持久化。先进入数据持久化插件页面左侧菜单点数据持久化插件。这个页面管理的是ventoy.json里的persistence配置即哪个 ISO 用哪个持久化文件/分区的映射关系。添加持久化条目点添加填入 ISO 文件路径当前系统下的绝对路径如/media/usb/ISO/Ubuntu/ubuntu-22.04-desktop-amd64.iso和对应的持久化文件路径比如/media/usb/ventoy/persistence/ubuntu.dat。持久化文件本身是个 ext4 的磁盘镜像用 Ventoy 主程序或CreatePersistentImg.sh提前建好Plugson 只负责写映射配置不替你生成文件。保存后重启验证保存后启动该 ISO装一个软件、存一个文件重启再进东西还在就说明配对了。注意持久化文件放在 U 盘 FAT 分区上时单个文件受文件系统限制FAT32 最大 4GB大持久化盘建议用 NTFS/exFAT 格式的 U 盘。我想让菜单好认好找配别名、提示和分类场景U 盘里 ISO 越来越多菜单上一串长长的文件名根本分不清哪个是哪个。菜单别名插件把文件路径映射成一个显示名如ubuntu-22.04-desktop-amd64.iso → Ubuntu 22.04菜单提示插件给菜单项加一行注释文字版本号、用途等菜单类型插件按规则把 ISO 归入不同分类菜单自动分组展示三个页面操作方式一致添加一条路径 → 别名/提示/类型的映射保存即可。它们最终都写进ventoy.json的menu_alias、menu_tip、menu_class段配合 U 盘上 ISO 的目录结构基本能替代手动建菜单。参数深水区这些配置项到底怎么填密码插件参数含义推荐值不填会怎样存储类型 TXT密码以明文txt#密码写入个人 U 盘随便用必选其一默认 TXT存储类型 MD5存md5#哈希值文件里看不到明文借给别人的 U 盘同上存储类型 Salt MD5存md5#盐#哈希值防彩虹表同上同上密码类型 file/parent单文件 / 整目录生效按目录管理选 parent必选路径当前系统下的绝对路径支持*通配用挂载点拼出真实路径匹配不到密码不生效为什么强调当前系统的绝对路径Plugson 要拿这个路径去 U 盘挂载点里实际查找文件、校验存在性写进 JSON 的才是 U 盘内的相对路径这一步它自动换算你填错前缀就会看到文件不存在提示。主题插件参数含义推荐值不填会怎样theme.txt 路径主题配置文件位置/ventoy/themes/xxx/theme.txt必配否则没有主题default_file多主题时默认启用哪个0第一个默认第一个dismode菜单显示模式GUI/CLI/串口GUI用默认值gfxmodeGRUB 图形分辨率1920x1080 或留默认用默认分辨率fonts 列表额外加载的 .pf2 字体需要中文菜单时加一个只有 GRUB 自带字体为什么多主题建议配多套再加resolution_fit不同分辨率机器上同一张 1920x1080 背景可能被拉伸按分辨率匹配主题文件可以每套机器都显示正常。启动脚本参数参数含义推荐值不填会怎样-H x.x.x.x服务监听 IP本机用127.0.0.1局域网访问填0.0.0.0或本机 IP默认127.0.0.1-P PORT服务端口默认即可默认24681磁盘参数整盘设备名/dev/sdXlsblk查到的 U 盘整盘必填缺了只打印用法# 允许同一局域网内的手机/其他电脑访问面板注意等于把 U 盘配置暴露给局域网 sudo bash VentoyPlugson.sh -H 0.0.0.0 -P 8080 /dev/sdX避坑与排错按你看到的症状对号入座症状 1启动脚本直接退出提示 Please use sudo or run the script as root.原因脚本第 14 行就检查了用户 uid非 root 不往下走。解决命令前加sudo。症状 2提示 is NOT Ventoy disk 或 does NOT exist原因设备号填成了分区如/dev/sdb1或者根本填错了盘。脚本虽然会自动剥掉末尾分区号sdX1→/dev/sdX但盘不对就无解。解决lsblk找到 U 盘对应的整盘再填。症状 3提示 is NOT mounted, please mount it first原因脚本靠/proc/mounts找 U 盘第一分区的挂载点没挂载就写不了文件。解决Linux 下sudo mount /dev/sdX1 /mnt或桌面环境自动挂载后重试Windows 下确认盘符可访问。症状 4提示 Another ventoy server is running now原因脚本会先ps -ef检查同 IP 同端口是否已有 Plugson 在跑防止两个服务同时改一个ventoy.json。解决把上次没关干净的服务停掉再启动。症状 5密码设了但启动时不提示原因① 路径填的不是当前系统绝对路径Plugson 校验时找不到文件② 给password默认页配了密码但机器走的是特殊架构启动实际命中的是别的标签页③ ISO 路径大小写与 U 盘上不一致。解决先在菜单密码表格里确认状态列显示存在再对照实际启动方式BIOS/UEFI检查是否配在正确的标签页。症状 6浏览器打不开 http://127.0.0.1:24681原因端口被防火墙拦了或者你换过-P但忘了改地址。解决看终端打印的实际地址服务器上用-H 0.0.0.0绑到所有网卡再从客户端访问服务器IP:端口同时放行该端口。进阶技巧 收尾先 Preview 再拔盘每个插件页保存后点右上角 Preview能看到这次要写入ventoy.json的最终 JSON比盲配再重启试错快得多。配置备份就备一个文件所有插件配置最终都在 U 盘的ventoy/ventoy.json里定期拷一份cp /media/usb/ventoy/ventoy.json ~/ventoy.json.bak换电脑、重插盘前恢复它全部配置原样回来。多架构机器只配一次也行密码/主题插件的 6 个标签页共享同一套操作逻辑先在默认页配好个别架构有差异时再去对应页微调不用每页重复一遍。记住两句话就够用了VentoyPlugson 只是帮你安全地写ventoy/ventoy.json的人改完 Preview 一眼确认路径永远是当前系统里的绝对路径填对这一条能避开 80% 的坑。【免费下载链接】VentoyA new bootable USB solution.项目地址: https://gitcode.com/GitHub_Trending/ve/Ventoy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
VentoyPlugson 完整使用指南7 步在浏览器里管理 Ventoy 密码、主题与持久化【免费下载链接】VentoyA new bootable USB solution.项目地址: https://gitcode.com/GitHub_Trending/ve/Ventoy你是不是也遇到过这种情况Ventoy U 盘装好了想给某些 ISO 加个启动密码结果得去官网翻插件说明、手写ventoy.json格式错一个引号就白干VentoyPlugson 就是官方给的图形化配置工具它在本地起一个 Web 服务你打开浏览器就能管理密码、主题、持久化这些高级功能配置文件它替你写。一句话认识 VentoyPlugsonVentoyPlugson 可以理解成一个运行在你电脑上的管理面板它读取你 Ventoy U 盘上的ventoy/ventoy.json把里面的密码、主题、持久化等配置做成表格和表单你改完点保存它再写回 U 盘。全程不用手写 JSON也不用手抄官网示例。能力适合谁你能拿到什么结果密码管理要给 U 盘加锁的人给整个启动流程或指定 ISO/WIM/IMG 目录设置密码支持按启动架构分别配置主题定制嫌启动菜单单调的人换菜单背景图、字体、颜色还能配多套主题按 F5 切换数据持久化用 Live 系统装软件存文件的人给 Linux Live ISO 配持久化存储关机后数据不丢菜单别名/提示/分类ISO 存得又多又乱的人把ubuntu-22.04-desktop-amd64.iso显示成Ubuntu 22.04按类型分组自动安装/文件注入批量装系统的高级玩家给指定 ISO 挂自动安装应答文件、注入自定义文件它的工作方式一句话就是浏览器发起请求 → 本地 Web 服务改配置 → 写回 U 盘。3 分钟跑通启动 VentoyPlugson 并打开面板跑通只需要一条命令前提是你的 Ventoy U 盘已经装好即 U 盘上有ventoy目录且能正常启动系统。第 1 步把 U 盘插上确认它已经挂载Plugson 需要直接访问 U 盘上的文件所以 U 盘第一个分区必须先挂载Windows 下就是能看到盘符Linux 下插进去一般自动挂载。挂载点下能看到ventoy目录就对了。第 2 步进入 Ventoy 的 INSTALL 目录工具都在这个目录里脚本会自动解压并启动对应 CPU 架构的Plugson二进制x86_64 / i386 / aarch64 / mips64el 各有一份脚本自己选cd INSTALL第 3 步用 sudo 启动传入整盘设备号sudo bash VentoyPlugson.sh /dev/sdX把/dev/sdX换成你 U 盘的真实设备名用lsblk或fdisk -l查注意是整盘如/dev/sdb不是分区。Linux 下必须加sudo脚本会检查 root 权限不是 root 直接退出。第 4 步看到设备信息 访问地址就算成功正常情况下终端会打印类似这样的信息说明设备识别正常、服务已启动Ventoy version in Disk: 1.0.97 Disk Partition Style : GPT Secure Boot Support : YES Ventoy Plugson Server 已经启动 ... 请打开浏览器访问 http://127.0.0.1:24681 ################## Press Ctrl C to exit #####################第 5 步浏览器打开 http://127.0.0.1:24681左侧就是功能菜单设备信息、全局控制插件、主题插件、菜单别名插件、数据持久化插件、密码插件等每一页对应 U 盘上ventoy.json里的一组配置。到这里你手上已经有了一个跑着的 Plugson 服务 一个能改配置的 Web 面板。改任何东西前先在设备信息页确认显示的是你预期的 U 盘。用完在终端按Ctrl C结束服务即可。我想给 U 盘加密码用密码插件保护启动项场景U 盘会借给别人你想让它启动 Ventoy 时先输密码或者只有 Windows 目录下的 ISO 需要单独设密码。进入密码插件页面左侧菜单点密码插件密码插件对应源码在 Plugson/www/plugson_password.html。页面分两大块Common Password通用密码和Menu Password菜单密码。设置通用密码通用密码管大门bootpwd控制进入 Ventoy 菜单时要不要密码isopwd/wimpwd/imgpwd/vhdpwd/efipwd/vtoypwd则分别给 ISO、WIM、IMG、VHD(x)、EFI、VTOY 这六类文件设默认密码。在对应行的操作列点设置弹出框里输入密码、选存储类型TXT 明文 / MD5 / Salt MD5确定即可。给指定文件或整个目录设密码在 Menu Password 区点添加填两样东西路径注意界面提示的是填当前系统中该文件的绝对路径比如 Linux 下 U 盘挂载在/media/usb就填/media/usb/ISO/Windows/类型选file匹配单个文件选parent目录则目录下所有文件都套这个密码也支持*通配符例如/media/usb/ISO/Ubuntu*.iso存好后 VentoyPlugson 会把密码写进ventoy.json的menu_pwd段下次启动走到对应项就会弹密码框。为什么页面顶上有 6 个标签页password、password_legacy、password_uefi、password_ia32、password_aa64、password_mips对应不同启动环境传统 BIOS / UEFI / 各 CPU 架构。password是总默认只在某些环境下有特殊要求时才切到对应标签页单独配一般用户只配第一页就够。我想换个启动菜单皮肤3 步完成主题定制场景默认菜单太素想换成自己做的背景图字体颜色也调一调。添加主题文件左侧点主题插件在文件表里点添加填 U 盘上theme.txt的全路径例如 Linux 挂载在/media/usb时填/media/usb/ventoy/themes/mytheme/theme.txt。主题文件本身是一段 GRUB 风格的配置背景、字体、颜色你直接编辑文本就行Plugson 负责把它登记进ventoy.json。配字体和显示模式同一个页面里还能添加.pf2字体文件GRUB 的专用字体格式并设置dismode显示模式如 GUI / CLI / 串口和gfxmode分辨率。多配了几个主题文件时启动后按F5 → Tools → Theme Select可以现场切换不用重新写配置。保存并预览改完点保存再点页面右上角的Preview预览能直接看到最终生成的插件配置 JSON确认无误后拔盘重启机器验证效果。页面右上角还有指向官网主题插件文档的入口resolution_fit这类细分选项可以按需查。我想让 Live 系统数据不丢配置数据持久化场景你拿 Ubuntu Live 版装软件、存文档重启后全没了想给这个 ISO 配持久化。先进入数据持久化插件页面左侧菜单点数据持久化插件。这个页面管理的是ventoy.json里的persistence配置即哪个 ISO 用哪个持久化文件/分区的映射关系。添加持久化条目点添加填入 ISO 文件路径当前系统下的绝对路径如/media/usb/ISO/Ubuntu/ubuntu-22.04-desktop-amd64.iso和对应的持久化文件路径比如/media/usb/ventoy/persistence/ubuntu.dat。持久化文件本身是个 ext4 的磁盘镜像用 Ventoy 主程序或CreatePersistentImg.sh提前建好Plugson 只负责写映射配置不替你生成文件。保存后重启验证保存后启动该 ISO装一个软件、存一个文件重启再进东西还在就说明配对了。注意持久化文件放在 U 盘 FAT 分区上时单个文件受文件系统限制FAT32 最大 4GB大持久化盘建议用 NTFS/exFAT 格式的 U 盘。我想让菜单好认好找配别名、提示和分类场景U 盘里 ISO 越来越多菜单上一串长长的文件名根本分不清哪个是哪个。菜单别名插件把文件路径映射成一个显示名如ubuntu-22.04-desktop-amd64.iso → Ubuntu 22.04菜单提示插件给菜单项加一行注释文字版本号、用途等菜单类型插件按规则把 ISO 归入不同分类菜单自动分组展示三个页面操作方式一致添加一条路径 → 别名/提示/类型的映射保存即可。它们最终都写进ventoy.json的menu_alias、menu_tip、menu_class段配合 U 盘上 ISO 的目录结构基本能替代手动建菜单。参数深水区这些配置项到底怎么填密码插件参数含义推荐值不填会怎样存储类型 TXT密码以明文txt#密码写入个人 U 盘随便用必选其一默认 TXT存储类型 MD5存md5#哈希值文件里看不到明文借给别人的 U 盘同上存储类型 Salt MD5存md5#盐#哈希值防彩虹表同上同上密码类型 file/parent单文件 / 整目录生效按目录管理选 parent必选路径当前系统下的绝对路径支持*通配用挂载点拼出真实路径匹配不到密码不生效为什么强调当前系统的绝对路径Plugson 要拿这个路径去 U 盘挂载点里实际查找文件、校验存在性写进 JSON 的才是 U 盘内的相对路径这一步它自动换算你填错前缀就会看到文件不存在提示。主题插件参数含义推荐值不填会怎样theme.txt 路径主题配置文件位置/ventoy/themes/xxx/theme.txt必配否则没有主题default_file多主题时默认启用哪个0第一个默认第一个dismode菜单显示模式GUI/CLI/串口GUI用默认值gfxmodeGRUB 图形分辨率1920x1080 或留默认用默认分辨率fonts 列表额外加载的 .pf2 字体需要中文菜单时加一个只有 GRUB 自带字体为什么多主题建议配多套再加resolution_fit不同分辨率机器上同一张 1920x1080 背景可能被拉伸按分辨率匹配主题文件可以每套机器都显示正常。启动脚本参数参数含义推荐值不填会怎样-H x.x.x.x服务监听 IP本机用127.0.0.1局域网访问填0.0.0.0或本机 IP默认127.0.0.1-P PORT服务端口默认即可默认24681磁盘参数整盘设备名/dev/sdXlsblk查到的 U 盘整盘必填缺了只打印用法# 允许同一局域网内的手机/其他电脑访问面板注意等于把 U 盘配置暴露给局域网 sudo bash VentoyPlugson.sh -H 0.0.0.0 -P 8080 /dev/sdX避坑与排错按你看到的症状对号入座症状 1启动脚本直接退出提示 Please use sudo or run the script as root.原因脚本第 14 行就检查了用户 uid非 root 不往下走。解决命令前加sudo。症状 2提示 is NOT Ventoy disk 或 does NOT exist原因设备号填成了分区如/dev/sdb1或者根本填错了盘。脚本虽然会自动剥掉末尾分区号sdX1→/dev/sdX但盘不对就无解。解决lsblk找到 U 盘对应的整盘再填。症状 3提示 is NOT mounted, please mount it first原因脚本靠/proc/mounts找 U 盘第一分区的挂载点没挂载就写不了文件。解决Linux 下sudo mount /dev/sdX1 /mnt或桌面环境自动挂载后重试Windows 下确认盘符可访问。症状 4提示 Another ventoy server is running now原因脚本会先ps -ef检查同 IP 同端口是否已有 Plugson 在跑防止两个服务同时改一个ventoy.json。解决把上次没关干净的服务停掉再启动。症状 5密码设了但启动时不提示原因① 路径填的不是当前系统绝对路径Plugson 校验时找不到文件② 给password默认页配了密码但机器走的是特殊架构启动实际命中的是别的标签页③ ISO 路径大小写与 U 盘上不一致。解决先在菜单密码表格里确认状态列显示存在再对照实际启动方式BIOS/UEFI检查是否配在正确的标签页。症状 6浏览器打不开 http://127.0.0.1:24681原因端口被防火墙拦了或者你换过-P但忘了改地址。解决看终端打印的实际地址服务器上用-H 0.0.0.0绑到所有网卡再从客户端访问服务器IP:端口同时放行该端口。进阶技巧 收尾先 Preview 再拔盘每个插件页保存后点右上角 Preview能看到这次要写入ventoy.json的最终 JSON比盲配再重启试错快得多。配置备份就备一个文件所有插件配置最终都在 U 盘的ventoy/ventoy.json里定期拷一份cp /media/usb/ventoy/ventoy.json ~/ventoy.json.bak换电脑、重插盘前恢复它全部配置原样回来。多架构机器只配一次也行密码/主题插件的 6 个标签页共享同一套操作逻辑先在默认页配好个别架构有差异时再去对应页微调不用每页重复一遍。记住两句话就够用了VentoyPlugson 只是帮你安全地写ventoy/ventoy.json的人改完 Preview 一眼确认路径永远是当前系统里的绝对路径填对这一条能避开 80% 的坑。【免费下载链接】VentoyA new bootable USB solution.项目地址: https://gitcode.com/GitHub_Trending/ve/Ventoy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
预测表的硬编码实现)
