VentoyPlugson 完整使用指南：手把手用 Web 界面管理 Ventoy 启动盘

VentoyPlugson 完整使用指南手把手用 Web 界面管理 Ventoy 启动盘【免费下载链接】VentoyA new bootable USB solution.项目地址: https://gitcode.com/GitHub_Trending/ve/VentoyVentoyPlugson 是 Ventoy 官方自带的图形化配置工具它把密码保护、主题定制、持久化存储这些原本要手写 JSON 的配置项变成了浏览器里的表单页面。本文带你从零启动它的 Web 服务按四个高频场景逐项实操每一步都附上你应该看到什么的预期结果并附常见故障排查让你全程不碰配置文件也能完成管理。工具速览VentoyPlugson 能替你做什么一句话定位它是一个跑在你电脑上的轻量 Web 服务服务端程序负责读写 U 盘里的配置浏览器只负责展示表单启动后所有配置都在 http://127.0.0.1:24681 这个默认地址上完成。类别具体能做什么设备信息显示 Ventoy 版本号、MBR/GPT 分区样式、安全启动支持状态、文件系统类型密码管理设置启动密码 bootpwd以及 ISO/WIM/IMG/VHD/EFI/VTOY 各类镜像的默认密码支持按文件、按目录单独设密码主题定制更换启动菜单背景图、字体按分辨率自适应显示持久化为 Live Linux 关联持久化镜像文件关机重启后数据还在菜单管理给 ISO 起中文别名、按目录自动分类、添加菜单提示其他内核参数注入、配置文件替换、自动安装、内存盘等高级项从零启动 VentoyPlugson 服务环境要求 Linux 系统架构为 x86_64、aarch64、mips64el 或 i386 之一脚本会自动识别一块已写入 Ventoy 的 U 盘先用 Ventoy2Disk 完成安装否则服务会直接报错退出U 盘第一个分区已挂载脚本会检查挂载点没挂载就拒绝启动root 权限脚本开头就用id -u判断非 root 直接提示退出分步启动第 1 步拿到 Ventoy 安装包目录从官网获取 Ventoy 最新版压缩包并解压进入其中的INSTALL目录。VentoyPlugson.sh就在这个目录下它依赖同目录tool/里预编译的服务端程序。第 2 步先确认你的 U 盘设备名lsblk找到 U 盘对应的整盘设备通常是/dev/sdb这类形式注意是整盘不要带分区号脚本会自动去掉末尾数字。第 3 步启动服务cd INSTALL sudo bash VentoyPlugson.sh /dev/sdb你应该看到什么终端先打印设备摘要再打印访问地址大致如下Ventoy version in Disk: 1.x.xx Disk Partition Style : GPT Secure Boot Support : YES ... Ventoy Plugson Server 已经启动 ... 请打开浏览器访问 http://127.0.0.1:24681 ################## Press Ctrl C to exit #####################看到Press Ctrl C to exit说明服务进入常驻状态此时不要关终端。第 4 步浏览器打开 http://127.0.0.1:24681页面标题是 Ventoy Plugson左侧是功能菜单树右上角有 Preview预览生成的配置、语言切换等按钮。完成上面这步后接下来按场景逐项操作。如果你需要在局域网另一台电脑访问用-H换绑定地址、-P换端口sudo bash VentoyPlugson.sh -H 192.168.1.100 -P 8080 /dev/sdb参数无效时脚本会明确报错例如Invalid host或Invalid port端口范围是 1~65535。界面快速巡览整个界面是左侧菜单树 右侧配置区的经典布局各功能页对应关系如下注意一个细节Password、Theme、Persistence 这几页内部都带架构标签页如 legacy / uefi / ia32 / aa64 / mips意思是同一份配置可以按启动模式分别设置只改默认标签页就只影响最常用的那条启动路径。场景一 给启动菜单上锁Ventoy 密码设置想做什么防止别人随便翻你 U 盘里的镜像或至少给特定文件加一道密码。怎么做左侧菜单进入 Password 页。先在通用密码区设置bootpwd启动入口密码——这是进 Ventoy 主菜单就要输的那道锁。再按需设置各类型镜像的默认密码isopwdISO、wimpwdWIM、imgpwdIMG、vhdpwdVHD/VHDX、efipwd、vtoypwd。若只想锁个别文件用菜单密码区的添加按钮类型选file锁单个文件选parent锁整个目录路径支持*通配符例如/ISO/Ubuntu*.iso只匹配 Ubuntu 开头的镜像/ISO/Windows/则锁住整个目录。密码可以填明文也可以填 MD5 散列形如md5#...避免明文落在配置文件里。如果你的 U 盘既走 UEFI 又走传统 BIOS切到对应的架构标签页再设一遍。怎么验证点右上角 Preview 查看即将写入的 ventoy.json 片段确认无误真正验证靠重启——从 U 盘启动时应在菜单处提示输入密码输错无法进入。场景二 一键更换启动菜单背景与字体想做什么启动菜单默认是 Ventoy 的水墨风背景就是上面那张默认主题背景图换成自己的壁纸和字体。怎么做进入 Theme 页。在背景文件区添加图片支持常用位图格式建议分辨率 1024x768 或 1920x1080过小会拉伸发虚。在字体区添加字体文件菜单文字才会改用新字体。如提供多档分辨率可开启按分辨率自适应res_fit相关选项让 4K 屏和普通屏都显示正常。同样注意架构标签页只改 uefi 页传统 BIOS 启动下看到的仍是旧背景。怎么验证Preview 检查配置文件然后重启机器从 U 盘引导菜单背景与字体即生效。这是所有场景里眼见为实最直接的一个。场景三 让 Live Linux 记住你的修改持久化存储想做什么Live 系统装在内存里重启就清零用持久化镜像一个磁盘镜像文件相当于给 Live 系统挂一块随身硬盘保存修改。怎么做先准备持久化镜像文件在INSTALL目录下用配套的CreatePersistentImg.sh生成指定大小的 img 文件把它拷到 U 盘的ventoy目录附近。进入 Persistence 页点击添加。填入 ISO 文件路径必须和 U 盘上真实路径一致区分大小写和对应的持久化镜像路径。保存。怎么验证重启进入该 Live 系统装一个软件或存一个文件重启后再进系统确认还在。场景四 给启动菜单起中文别名、自动分类想做什么菜单里ubuntu-22.04-desktop-amd64.iso这种文件名不友好且几十个镜像挤在一起难找。怎么做Menu Alias 页为某个镜像路径填一个显示名例如把长文件名显示为Ubuntu 22.04 LTS。Menu Class 页按目录树把 ISO 归类U 盘里建好ISO/Linux/...、ISO/Windows/...的目录结构后菜单会按层级展开成树形分类而不是平铺。顺手可以在菜单提示Menu Tip页给某一项加一行说明文字。怎么验证Preview 查看配置重启后菜单应显示中文名称与树形目录。常见坑位现象 → 原因 → 解决坑 1浏览器打开 127.0.0.1:24681 连不上现象页面转圈或显示连接被拒绝。 原因服务没起来终端里其实有报错或用了-H绑定了别的 IP本地回环地址自然不通也可能是同一台机器已有一个同地址同端口的服务在跑脚本检测到会直接拒绝二次启动。 解决先看终端输出本地访问时确认默认127.0.0.1未改远程访问改成-H 0.0.0.0并用对应主机 IP 访问提示Another ventoy server is running时先 Ctrl C 结束旧进程。坑 2设置密码后重启不弹密码框现象Preview 里配置没问题重启却没要求输密码。 原因最常见是架构标签页没对上——你从 UEFI 启动却只在 legacy 页设了密码或反之其次是路径大小写与 U 盘实际文件名不一致file类型匹配失败。 解决对照实际启动方式把密码补到正确标签页用lsblk进 U 盘目录核对镜像路径的每个字符。坑 3脚本报 is NOT Ventoy disk 或 please mount it first现象启动即失败退出。 原因前者是设备路径指向了没装过 Ventoy 的盘后者是 U 盘第一个分区没挂载脚本不替用户自动挂载。 解决先用 Ventoy2Disk 把 Ventoy 写入该盘再运行挂载分区如sudo mount /dev/sdb1 /mnt后重新执行。坑 4持久化重启后数据没保存现象进系统操作正常重启后一切恢复原样。 现象背后原因通常是镜像文件本身没创建或大小为 0Persistence 页里 ISO 路径与实际不符或该发行版不识别 Ventoy 的持久化参数。 解决确认镜像文件已生成且非空核对路径查阅该发行版是否支持对应持久化方式个别发行版需要额外的内核参数以官方最新版文档为准。总结与延伸VentoyPlugson 把 Ventoy 最折腾的配置项全部搬进了浏览器表单密码、主题、持久化三条线都有设置—预览—重启验证的闭环。熟练之后建议把精力投向两个延伸方向一是 Menu Class 的目录规划从源头保证菜单整洁二是内核参数注入Injection页为特定 ISO 追加启动参数解锁更多发行版的定制行为。附录高频命令速查命令功能sudo bash VentoyPlugson.sh /dev/sdb默认地址 24681 端口启动配置服务sudo bash VentoyPlugson.sh -H 0.0.0.0 -P 8080 /dev/sdb指定监听 IP 与端口启动sudo bash VentoyPlugson.sh -h查看参数帮助lsblk确认 U 盘整盘设备名cat /mnt/ventoy/ventoy.json查看服务写入 U 盘的最终配置【免费下载链接】VentoyA new bootable USB solution.项目地址: https://gitcode.com/GitHub_Trending/ve/Ventoy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考