企业官网建设流程全解析

VentoyPlugson 完整使用指南：7 步在浏览器里管理 Ventoy 密码、主题与持久化

【免费下载链接】VentoyA new bootable USB solution.项目地址: https://gitcode.com/GitHub_Trending/ve/Ventoy

你是不是也遇到过这种情况：Ventoy U 盘装好了，想给某些 ISO 加个启动密码，结果得去官网翻插件说明、手写ventoy.json，格式错一个引号就白干？VentoyPlugson 就是官方给的图形化配置工具，它在本地起一个 Web 服务，你打开浏览器就能管理密码、主题、持久化这些高级功能，配置文件它替你写。

一句话认识 VentoyPlugson

VentoyPlugson 可以理解成一个"运行在你电脑上的管理面板"：它读取你 Ventoy U 盘上的ventoy/ventoy.json，把里面的密码、主题、持久化等配置做成表格和表单，你改完点保存，它再写回 U 盘。全程不用手写 JSON，也不用手抄官网示例。

它的工作方式一句话就是：浏览器发起请求 → 本地 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 的目录结构，基本能替代手动建菜单。

参数深水区：这些配置项到底怎么填

密码插件

为什么强调"当前系统的绝对路径"：Plugson 要拿这个路径去 U 盘挂载点里实际查找文件、校验存在性，写进 JSON 的才是 U 盘内的相对路径，这一步它自动换算，你填错前缀就会看到"文件不存在"提示。

主题插件

为什么多主题建议配多套再加resolution_fit：不同分辨率机器上同一张 1920x1080 背景可能被拉伸，按分辨率匹配主题文件可以每套机器都显示正常。

启动脚本参数

# 允许同一局域网内的手机/其他电脑访问面板（注意：等于把 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:端口，同时放行该端口。

进阶技巧 + 收尾

1. 先 Preview 再拔盘：每个插件页保存后点右上角 Preview，能看到这次要写入ventoy.json的最终 JSON，比盲配再重启试错快得多。
2. 配置备份就备一个文件：所有插件配置最终都在 U 盘的ventoy/ventoy.json里，定期拷一份（cp /media/usb/ventoy/ventoy.json ~/ventoy.json.bak），换电脑、重插盘前恢复它，全部配置原样回来。
3. 多架构机器只配一次也行：密码/主题插件的 6 个标签页共享同一套操作逻辑，先在默认页配好，个别架构有差异时再去对应页微调，不用每页重复一遍。

记住两句话就够用了：VentoyPlugson 只是帮你安全地写ventoy/ventoy.json的人，改完 Preview 一眼确认；路径永远是"当前系统里的绝对路径"，填对这一条能避开 80% 的坑。

【免费下载链接】VentoyA new bootable USB solution.项目地址: https://gitcode.com/GitHub_Trending/ve/Ventoy