Ventoy 图形化配置:5 分钟设置好启动密码与菜单主题
2026/8/29 10:09:52 网站建设 项目流程

Ventoy 图形化配置:5 分钟设置好启动密码与菜单主题

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

当你想给 U 盘里某颗 ISO 单独加密码、或者把启动菜单换成自己的背景图时,绕不开手动编辑 U 盘上的 ventoy.json:字段容易拼错、路径容易写反、改完也没法立刻验证。其实 Ventoy 自带一个图形化配置工具 VentoyPlugson——它在本地把配置服务跑起来,你全程在浏览器里操作,结果直接写进 U 盘上的配置文件。

项目速览

VentoyPlugson 是 Ventoy 官方随版本发布的 Web 配置工具(源码在Plugson/目录),它先检测你的 Ventoy U 盘,再在本地起一个 HTTP 服务,密码、主题、持久化等配置全部在浏览器里完成,并由工具直接写入 U 盘分区的/ventoy/ventoy.json。相比手改 JSON,它帮你省掉三件事:字段拼写错误、路径大小写错误、改完无法校验——界面会实时检查文件是否存在,路径错了当场报错。

功能适用场景
密码管理给启动流程、指定 ISO 或目录单独上锁
菜单主题定制启动菜单背景、字体、分辨率
持久化给 Linux Live ISO 挂一个 .dat 持久化文件
菜单别名把冗长 ISO 文件名换成短名称显示

整体工作流程四步:

  1. 在插着 U 盘的机器上执行 VentoyPlugson.sh 脚本
  2. 脚本解压对应架构的工具并校验 Ventoy U 盘
  3. 启动本地 HTTP 服务(默认 127.0.0.1:24681)
  4. 浏览器里完成配置,每次保存都落盘到 U 盘

从零跑通

前提:Linux 环境(x86_64、aarch64、mips64el、i386 均支持),U 盘已经用 Ventoy2Disk 装好 Ventoy 并拷入了 ISO。

先拿到代码(如果你用的是发布包,直接进包里的 INSTALL 目录即可):

git clone https://gitcode.com/GitHub_Trending/ve/Ventoy cd Ventoy/INSTALL

把 U 盘插好,确认第一分区已经挂载——这一步不能省,没挂载时 Plugson 会直接拒绝启动:

lsblk sudo mount /dev/sdX1 /mnt

其中sdX1按 lsblk 输出替换为你的 U 盘第一分区,/dev/sdX(替换为你的实际设备)指整盘。

启动服务:

sudo bash VentoyPlugson.sh **/dev/sdX**

成功的标志非常明确,终端会先打出一段设备信息:

Ventoy version in Disk: 1.x.x Disk Partition Style : GPT Secure Boot Support : YES

接着出现Ventoy Plugson Server 已经启动 ...,并提示访问http://127.0.0.1:24681。浏览器打开这个地址,能看到主页面,含密码、主题、持久化、别名等入口,说明服务就绪。

默认端口被占用、或想从别的机器访问时,指定 IP 和端口:

sudo bash VentoyPlugson.sh -H 0.0.0.0 -P 8080 **/dev/sdX**

同一 HOST+PORT 只允许跑一个实例,重复启动会提示 Another ventoy server is running now。

核心能力拆解

给特定 ISO 或目录上锁

解决"哪些 ISO 只有知道密码的人能启动"的问题,不用把整个 U 盘都锁死。密码分两层:通用密码(bootpwd 是进 Ventoy 菜单的密码,isopwd 是所有 ISO 的默认密码,另有 wim、img、vhd、efi、vtoy 六类)和菜单密码(对单个文件或整个目录单独设置)。

操作步骤:

  1. 打开"密码"页面
  2. 菜单密码区点"添加",选 file 或 parent(目录)
  3. 填路径,支持 * 通配,如 /ISO/Ubuntu*.iso
  4. 输入密码,选明文 / MD5 / 带盐 MD5 存储方式
  5. 保存,列表中该条状态应显示"存在"

生成到 ventoy.json 里的内容长这样:

"list": [ { "type": 0, "path": "/ISO/Ubuntu-22.04-desktop-amd64.iso", "valid": 1, "pwd": "txt#123456" } ]

type 0 是文件、1 是目录;path 相对 U 盘根目录且区分大小写。页面顶部还有 password、password_legacy、password_uefi 等标签页,对应 BIOS 与各 UEFI 架构,按你的启动方式选对标签页。

换掉启动菜单的背景与字体

解决"菜单千篇一律,想换成自己的风格和分辨率"的问题。

  1. 打开"主题"页面
  2. 添加 theme.txt 文件全路径,可加多个
  3. 选择 display_mode(默认 GUI)与 gfxmode 分辨率
  4. 按需添加字体文件(ttf)路径
  5. 保存
"theme": { "theme_file": ["/ventoy/themes/ventoy/theme.txt"], "default_file": 0, "gfxmode": "1920x1080", "fonts": ["/ventoy/themes/ventoy/font.ttf"] }

theme.txt 是纯文本文件,定义背景图、菜单颜色、边框等外观;配置了多个主题文件后,启动时按 F5 进入 Tools → Theme Select 即可切换。

给 Live ISO 挂持久化文件

解决"Linux Live 系统重启后文件、设置全部丢失"的问题。

  1. 生成持久化 .dat 文件,大小单位 MB,支持 ext2/3/4 与 xfs
  2. 把 .dat 放进 U 盘,与对应 ISO 同目录
  3. 打开"持久化"页面,点"添加"
  4. pattern 填 .dat 文件的卷标(不是路径)
  5. 保存
cd Ventoy/INSTALL sudo bash CreatePersistentImg.sh -s 1024 -t ext4 -l casper-rw -o persistence.dat
"persistence": [ { "pattern": "casper-rw", "timeout": 0, "autosel": 1 } ]

pattern 必须和生成时的 -l 卷标完全一致;不同发行版要求的卷标不一样,以该发行版自己的持久化文档为准。

踩坑 & 进阶

常见问题:

  1. 现象:终端提示 is NOT mounted, please mount it first! 原因:U 盘第一分区没有挂载。 解法:先 sudo mount /dev/sdX1 /mnt 再重跑脚本。

  2. 现象:提示 XXX is NOT Ventoy disk. 原因:整盘没有安装 Ventoy,或装完后被格式化过。 解法:用 Ventoy2Disk 重新对整盘安装 Ventoy,再启动 Plugson。

  3. 现象:密码保存成功,启动时却不弹密码框。 原因:路径大小写不匹配(U 盘文件系统区分大小写),或改错了启动模式标签页。 解法:看密码列表的状态列确认路径存在;UEFI 启动的机器注意确认在默认标签页还是 password_uefi 标签页里设置的。

  4. 现象:U 盘所在机器能打开页面,别的机器连接被拒绝。 原因:服务默认只监听 127.0.0.1。 解法:⚠️ 加 -H 0.0.0.0 启动,但该服务没有任何认证机制,别暴露到公网。

💡 进阶两招:

  • 菜单排序与分组:ISO 文件名加数字前缀(01-ubuntu.iso、02-win11.iso)可自动排序;在 /ISO 下建子目录,菜单会按目录自动分类,比逐条设别名省事。
  • 配置备份:ventoy.json 是 U 盘 ventoy 目录下的纯文本,改完配置顺手拷一份(cp /mnt/ventoy/ventoy.json ~/ventoy.json.bak),出问题直接拷回去;它也适合直接纳入 git 管理。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询