干运维这行最怕听到“帮我把机房几十台机器都装上系统”。最开始我也是老老实实做启动 U 盘一台一台插上去按 F12装完再拔下来跑下一台。那会儿 Windows 10 的镜像动辄五六个 G往 U 盘里拷都得等半天做到第十台基本就开始怀疑人生。后来在一个技术群里看到有人提 iVentoy说这玩意儿能把 ISO 全扔在服务器上客户端开机走 PXE 网络引导自己选镜像装系统。当时我就觉得这事儿靠谱折腾了一周把 Docker 版整套跑通之后回头再看传统装机方式真有一种“以前都在用蛮力”的感觉。这篇就把 Docker 部署 iVentoy 这件事从头到尾拆开讲清楚它解决的到底是什么问题、底层走的是什么协议链路、部署时哪些网络参数必须先想明白、客户端从开机到进安装界面会踩哪些坑。不管你是在机房做批量装机还是想给实验室几台旧电脑换 Linux又或者是纯粹想在家里 NAS 上搭一个“随时能装系统”的服务这篇都能当一份可以照着抄的作业。1. 从“U 盘巡航”到“网络引导”iVentoy 究竟改变了什么1.1 传统批量装机的三个“体力活”痛点批量装系统这件事表面上是技术活实际上大部分时间是体力活。第一个痛点是启动介质本身的维护成本电脑型号不一样可能有的机器只认 UEFI有的老机器还在用 Legacy BIOSU 盘的文件系统格式、分区表稍有不对某些主板就是死活不认。第二个痛点是物理操作效率低几十台机器逐台插 U 盘、逐台选启动项机器密集的机房还得蹲着操作半天下来腰先受不了。第三个痛点是镜像版本的管理混乱今天装 Win10 LTSC明天装 Ubuntu 22.04每个版本都要单独做一个盘U 盘一多自己也记不清哪个是哪个。这些问题听起来不大但真正面对几十台机器时就会被放大成灾难。而 PXE 网络装机恰恰能把“逐台插拔”变成“一次配置、批量引导”服务器上摆好镜像客户端开机从网卡引导装上装不上都不需要物理接触那台机器。1.2 Ventoy 与 iVentoy 的关系同一个灵魂不同的载体Ventoy 很多人都知道它最大的贡献是把“做启动盘”这件事简化到了令人发指的程度把 Ventoy 装进 U 盘之后剩下的就是往 U 盘里拷 ISO开机选一下就能引导。它的核心技术是实现了自己的引导框架让大多数 ISO 都能直接被 GRUB2 或兼容模式拉起不需要单独做引导处理。iVentoy 其实就是 Ventoy 的网络版核心思路一脉相承把那个“U 盘”变成一个网络服务器上的共享目录把引导器从本地 U 盘换成了 PXE 网络引导程序。你在浏览器里打开 iVentoy 的管理界面能看到一个和 Ventoy 风格高度一致的 ISO 列表客户端从网络引导启动后也会看到同样的列表。也就是说Ventoy 时代“拷贝 ISO 到 U 盘”的动作在 iVentoy 时代变成了“拷贝 ISO 到服务器目录”。1.3 PXE 引导链路到底长什么样懂一点网络的老哥应该知道PXE 启动不是一个协议搞定的事它是一条链路由 DHCP、TFTP、HTTP 三个环节串起来。我用大白话描述一遍客户端开机之后网卡开始大喊“我要 IP 地址顺便告诉我启动文件在哪”这是 DHCP 干的活拿到 IP 和引导文件位置之后客户端会用 TFTP 去下载一个很小的引导程序相当于拿到了一把钥匙引导程序启动后再从 HTTP 服务拉取真正的菜单和 ISO 镜像文件这才是大块数据的传输通道。iVentoy 牛的地方在于它把这几个服务全做进了同一个程序里。传统 PXE 方案里你得手动装 dnsmasq 配 DHCP、装 tftpd-hpa 配引导文件、装 Nginx 或 Apache 放镜像还要自己写 pxelinux.cfg 菜单语法稍有不慎整个链路就断掉。iVentoy 把这些全包了你只需要关心 ISO 放哪个目录。1.4 什么场景合适什么场景别硬上我个人的判断标准很简单同一网段内、需要频繁装不同系统的场景iVentoy 体验极好。比如学校机房、企业办公区维护、网吧电脑更新、维修店给客户试系统都很合适。它最大价值不是“网络装机”本身而是把选择权交给客户端让装哪个系统变成“开机选菜单”的事。但如果你的需求是跨三层交换机大范围批量分发或者要求几百台机器同时并发安装、还要网络克隆整个硬盘iVentoy 就不是最合适的工具了那种场景更接近无盘工作站或者专业网刻系统的范畴涉及组播、VLAN 规划、镜像格式转换复杂度完全是另一个层级。iVentoy 的定位很清楚解决中小心规模的“随手装系统”问题。2. 部署前先理清网络与端口这步没想明白后面全是坑2.1 iVentoy 用到的端口与各自职责在跑 docker run 之前我建议你先花十分钟理解 iVentoy 要用到的端口不然容器起来了你也不知道哪些映射该留、哪些该删。端口协议职责26000TCPWeb 管理界面浏览器配置用1080TCPHTTP 文件服务给客户端提供菜单和镜像下载16000UDPTFTP 引导服务发给客户端的第一个引导程序67UDPDHCP/BOOTP 服务分配 IP 并提供 PXE 引导参数视模式而定这里最容易被忽略的是 67 端口。如果 iVentoy 以完整 DHCP 服务器模式运行它会监听 67如果局域网里已经有一台路由器在派发 IP你就得考虑改成 proxy DHCP 模式只提供 PXE 引导参数、不参与 IP 分配。不同的运行模式对应的端口策略完全不同所以部署前先问自己一句这台 iVentoy 所在网段IP 由谁分配2.2 第一个大坑DHCP 冲突是怎么毁掉整个局域网的这是我见过最多人踩的坑也是我第一次搭时翻车最惨的地方。iVentoy 默认开了 DHCP 服务而绝大多数办公室、教室、家里的网络已经有一台 DHCP 服务器通常就在路由器上两边同时响应客户端地址请求网络里就会出现 IP 地址混乱有些设备拿到两个 offer个别设备直接没法上网。我记得第一次测试时容器刚跑起来五分钟同事就喊办公室网络断了当时我还没意识到是自己这边的问题排查了半天才发现罪魁祸首是我刚起的 iVentoy。后来学乖了部署前先看当前网段的 DHCP 是谁如果是路由器在管iVentoy 这边就关闭自己的 DHCP 服务或者只开 proxy DHCP 模式如果不具备这个条件就把 iVentoy 放到一个独立的物理网段或 VLAN 里让它当这个子网的唯一 DHCP 服务器。2.3 第二个大坑host 网络模式与桥接模式的取舍Docker 部署 iVentoy 时网络模式的选择直接决定了你能不能跑通。我的结论非常直接在 Linux 宿主机上优先用--nethost。原因有两个一是 DHCP 和 TFTP 这两个协议和 UDP 广播、MAC 地址绑定得特别紧Docker 的 NAT 转发和虚拟网桥在这种场景下很容易出幺蛾子二是 host 模式下端口天然全通不用一个个映射少一层排查。桥接模式并不是完全不能用在局域网环境简单、没有其他 DHCP 干扰的前提下映射端口也能跑通。但一旦涉及 PXE我建议你别在最容易出问题的网络环节上省事。如果你是用 Docker DesktopWindows 或 macOS那就更要注意了Docker Desktop 本身跑在一个虚拟化层里对 host 网络模式的支持非常有限很多情况下 iVentoy 容器起了、界面能开但客户端死活拿不到引导文件原因就在这层虚拟化网络把 DHCP/TFTP 的链路打断了。2.4 目录规划让容器随便升级数据毫发无损iVentoy 容器把数据都放在/data目录下里面主要是 iso 目录和生成运行日志、配置文件。我建议你在宿主机上单独建一个目录比如/data/iventoy然后绑定挂载到容器的/data这样以后升级镜像、重建容器ISO 和配置都不会丢。目录规划还要考虑容量。一个 Windows 原版 ISO 通常是 4-6GB如果你打算放十个八个镜像没有一两百 GB 空闲空间是不够的。我见过有人把 ISO 放在系统盘结果装系统装到一半提示磁盘满场面相当尴尬。检查一下你挂载的宿主机目录容量是否充足比什么都重要。3. Docker 部署两种姿势命令行与 docker-compose 的完整走通3.1 最省心的姿势host 网络模式一把梭如果你宿主机是 Linux且这个网络环境你也确认过没有 DHCP 冲突那我推荐直接用这条命令docker run -d --name iventoy \ --restartalways \ --nethost \ -v /data/iventoy:/data \ fyde/iventoy--restartalways的意思是宿主机重启后容器会自动拉起网络装机服务器这东西一旦部署完你肯定不希望它下次开机还要手动启动。-v /data/iventoy:/data把数据目录挂出来这一点非常关键后面升级容器镜像时只要挂载点不变所有 ISO 原封不动。fyde/iventoy是官方镜像直接拉就行。跑完这条命令后先用docker logs -f iventoy看一眼日志正常会输出服务启动信息和 Web 管理地址默认端口是 26000。如果日志里没有任何报错再检查一下进程是否真的在监听ss -lunp | grep -E 67|16000|26001和ss -ltnp | grep -E 26000|1080端口在就说明服务起来了。3.2 桥接模式的完整命令与端口映射说明如果你的环境只能用桥接网络或者你确实想把端口显式映射出来方便管理命令是这样docker run -d --name iventoy \ --restartalways \ -p 26000:26000 \ -p 1080:1080 \ -p 16000:16000/udp \ -p 67:67/udp \ -p 26001:26001/udp \ -v /data/iventoy:/data \ fyde/iventoy需要注意把宿主机的 67 端口映射给容器意味着宿主机本身不能再跑 dnsmasq、dhcpd 这类 DHCP 服务否则端口冲突直接导致容器起不来。另外桥接模式下 DHCP 广播的到达范围、虚拟网桥对 MAC 地址的处理都可能带来意料之外的问题所以我依然建议能 host 就 host实在不行再走桥接并且做好“PXE 链路可能不通”的心理准备。3.3 docker-compose 方式适合长期维护如果你习惯用 docker-compose 管理容器或者想把这套配置纳入现有的编排体系下面这个文件可以直接用内容就是把 host 网络参数翻译成 compose 语法services: iventoy: image: fyde/iventoy:latest container_name: iventoy restart: always network_mode: host volumes: - /data/iventoy:/data保存为docker-compose.yml然后在同目录执行docker compose up -d就完事。相比命令行compose 的好处是配置可版本化管理哪天要迁移服务器把这个 yml 一拷、数据目录一搬新机器上docker compose up -d就能复现整个环境。3.4 放 ISO、开 Web 界面、验证服务状态容器起来之后打开浏览器访问http://你的IP:26000会看到 iVentoy 的 Web 管理界面默认账号是 admin默认密码是 iventoy第一次登录后记得立刻改掉。接下来把 ISO 放进挂载目录。你可以直接在 Web 界面上传小镜像但我更推荐用scp、rsync或直接插硬盘拷到/data/iventoy/iso/目录下传几个 G 的大文件时比网页上传稳定得多、也快得多。放好之后刷新管理页面就能在镜像列表里看到刚才添加的 ISO并且会自动识别系统类型和架构信息。管理界面里一般会显示 DHCP、TFTP、HTTP 这几个服务组件的状态三个都正常就是基本就绪。到这一步建议先在虚拟机里做一次网络引导验证虚拟机的网卡选择桥接模式开机后进入启动菜单选 PXE 启动如果能看到 iVentoy 的镜像列表链路就通了。3.5 在飞牛 NAS 这类设备上部署的额外注意点最近很多玩 NAS 的朋友喜欢把 iVentoy 装在飞牛 fnOS 这类国产 NAS 系统上一台设备既做存储又做装机服务器思路很实用。在 NAS 上部署的 Docker 命令和 Linux 一样因为 fnOS 底层就是 Debian 系Docker 兼容性没有问题。需要注意两点。第一NAS 上如果开了 SMB、NFS 等服务端口很多务必确认 67、16000 这些 PXE 相关端口没被占用。第二ARM 版 NAS 建议先确认镜像是否支持对应架构x86 架构的 NAS 基本无脑跑ARM 设备偶尔会遇到处理器架构不兼容的问题多留意一下镜像平台的兼容性。4. 客户端从 PXE 引导到装完系统的完整链路与镜像脾胃4.1 BIOS 与 UEFI网络引导的第一道分水岭客户端能不能顺利进入 iVentoy 菜单首先要看它启动模式是 Legacy BIOS 还是 UEFI。现在新出的机器基本都是 UEFI而 UEFI 模式下网络引导默认未必是开启状态得进 BIOS 找网卡 ROM 或 Network Boot 选项把它打开有些主板还专门有“允许 UEFI PXE 引导”之类的开关找不到就翻主板说明书。另一个常见问题是 Secure Boot。iVentoy 的引导文件有签名理论上能过安全启动校验但主板固件实现五花八门遇到“引导文件校验失败”这类报错时最直接的排查办法就是先把 Secure Boot 关掉再试。等确认网络引导链路完全稳定了再回头研究怎么开着 Secure Boot 也能引导不然排查时变量太多容易怀疑人生。4.2 客户端启动实测从 F12 到安装界面我习惯在 VirtualBox 或 VMware 里先把整条链路跑通再上真机。虚拟机网卡选择桥接模式开机按 F12 或者进入 Boot Menu 选网卡启动会看到一行Booting from Network...然后 DHCP 分配 IP、TFTP 拉引导程序几秒钟后屏幕上出现 iVentoy 的镜像选择界面。这个界面的交互逻辑和 Ventoy 几乎一致上下键选择镜像回车开始引导。选完 ISO 后它会走两种启动模式之一默认是普通模式如果某些镜像启动有问题会在启动菜单里切到兼容模式或 GRUB2 模式再试。真机上操作流程也一样只是不同品牌主板进入启动菜单的按键不同F12、F11、F9 都有老 HP 机器甚至是 F9。4.3 Windows ISO最顺利也最容易翻车的一类Windows 原版 ISO 在 iVentoy 里整体兼容性不错Win10、Win11 的官方镜像基本都能直接启动进入安装界面。但有个坑你迟早会碰到Windows 安装程序在启动到 PE 阶段时需要用网络访问服务器上的install.wim这个文件动辄 4-6GB走 TFTP 根本不现实所以 iVentoy 用 HTTP 来传。问题在于PE 环境能不能联网取决于 PE 里有没有集成你的网卡驱动如果你的机器网卡比较新或比较偏门PE 里没驱动安装程序就会卡在“找不到 install.wim”或者“加载安装源失败”。解决办法是提前把网卡驱动注入到 Windows 镜像的 boot.wim 里或者选择官方原版镜像里已经自带驱动的常见网卡型号。如果只是测试最省事的做法是虚拟机里用 e1000e 或者 Realtek 虚拟网卡基本不会踩驱动坑。4.4 Linux 与无人值守插件机制带来的自动化玩法Linux 发行版在 iVentoy 下体验更顺因为它不依赖 Windows PE 那套网络驱动逻辑加载内核和 initrd 之后根文件系统直接通过 HTTP 挂载。Ubuntu、Debian、CentOS 这类主流发行版都支持。更进阶的玩法是配合 Ventoy 插件机制实现无人值守安装比如给某个 Ubuntu ISO 配置自动安装参数客户端一开机选一下剩下的分区、用户、软件包安装全部自动化。可以把插件的 JSON 文件按 Ventoy 文档约定放到 iso 目录对应的 ventoy 子目录下iVentoy 启动菜单会自动读取并应用。判断插件是否生效看客户端启动菜单里对应镜像下方有没有多出来额外的配置标识。这一步能让你从“手动装一台”进化到“批量装一百台只按回车”但上手门槛稍高建议先把基础链路跑熟再折腾插件。4.5 ISO 启动模式的那点讲究很多人第一次用 iVentoy 时遇到某个 ISO 引导黑屏第一反应是镜像坏了其实更多时候是启动模式不匹配。同一份 ISO在 iVentoy 菜单里可能对应两种引导方式一种类似 Ventoy 的默认 GRUB2 引导一种更接近兼容模式。对于 Windows 官方镜像用默认模式通常没问题对于某些精简版、修改版 ISO或者体积特别大的 Linux Live 镜像可能要切到兼容模式才能正常启动。遇到黑屏、重启循环、卡在某个加载进度条时别急着删镜像先去 iVentoy 菜单里切换启动模式试一次。另外镜像文件的校验值也值得看一眼下载过程中文件损坏导致的启动失败有时候和镜像本身没关系。5. 实测中的五个高频故障与排查链路5.1 卡在 “No Boot Filename received” 的排查全链路客户端 PXE 启动卡在No Boot Filename received时说明 DHCP 响应里没有给引导文件名这一项。优先怀疑对象就是客户端拿到的 IP 是路由器这类普通 DHCP 服务器分配的而它并不具备 PXE 引导参数。也就是说iVentoy 的 DHCP 没有生效或者它根本就没打算派 IP。排查顺序我建议这样做先确认客户端和服务器在同一个二层网络里跨三层的话 iVentoy 默认配置根本管不到再检查服务器上防火墙有没有放行 67/udp、16000/udp 和 26001/udp然后看 iVentoy 管理界面里 DHCP 服务状态是否正常如果显示异常把日志片段贴出来查一下。实在不行在服务器上抓包确认 DHCP 请求有没有到本机用tcpdump -i eth0 udp port 67 or udp port 68看客户端广播是否到达一目了然。5.2 DHCP 冲突把办公室网络打瘫的十分钟我之前已经吃过一次亏这里再展开说下现象和处置。iVentoy 的 DHCP 服务如果开着它会响应所有广播的 DHCP 请求包括那些本来该由路由器应答的客户端。客户端手里同时握着两个 DHCP offer网卡到底用哪个取决于实现和时序结果就是有的设备一直拿不到 IP有的设备拿到了但网关不对整个网络像得了脑血栓一样。如果已经发生这类问题先把 iVentoy 容器停掉网络会很快恢复这是最快的止血方案。接下来要做的是进入 Web 管理界面关闭 DHCP 服务或切换到 proxy DHCP 模式然后重新启动容器。如果你的场景确实需要 iVentoy 自己分配 IP那就必须确保它是一个独立二层网段内的唯一 DHCP 服务。5.3 Windows 装到一半报“找不到 install.wim”这个故障十有八九是网络驱动导致的。Windows PE 启动后iVentoy 通过 HTTP 向客户端传输 install.wimPE 里如果没有对应网卡驱动网卡就是红叉状态HTTP 请求发不出去安装程序自然找不到 install.wim。排查思路是先确认 ISO 本身有没有问题MD5 对比一下官方哈希然后确认 PE 阶段网卡是否已经拿到 IP如果没拿到从网卡驱动入手解决。我知道有些人为了省事会直接在启动菜单里用兼容模式重新引导有时候确实能绕过某些奇奇怪怪的问题。但核心建议还是给镜像的 boot.wim 注入你实际硬件需要的网卡驱动一次性解决。5.4 Docker Desktop 起容器容易PXE 引导却始终失败如果你用的是 Windows 的 Docker Desktop容器起来之后 Web 界面也能打开ISO 也放好了但客户端 PXE 就是找不到引导服务我基本可以断定问题出在 Docker Desktop 的虚拟网络层。Docker Desktop 本质上是跑在虚拟机里的 Docker它无法像 Linux 宿主那样直接用 host 网络和物理网卡通信DHCP 广播和 TFTP 这类低层协议在经过虚拟交换机时很容易出问题。不要在这个环境上死磕 PXE性价比太低了。想要在 Windows 上体验 iVentoy直接用它的 Windows 原生安装包反而最省事如果你只愿意用 Docker那就找一台 Linux 虚拟机或独立主机来跑容器少折腾网络层。同理macOS 上的 Docker Desktop 也要避开 PXE 这类依赖二层广播的服务。5.5 拉镜像慢、大 ISO 无处安放、容器日志刷屏等杂症第一次docker pull fyde/iventoy卡很久是大环境问题可以给 Docker 配置镜像加速源通常网上找一些公开的 registry mirror 填进/etc/docker/daemon.json就能解决。如果内网环境连镜像源都访问不了那就找一台能正常拉镜像的机器docker save导出再docker load导入目标机器离线部署也能走通。大 ISO 没地方放的问题前面说过务必提前规划挂载目录的容量。最后说下日志iVentoy 在运行时会记录每个客户端的引导请求、镜像加载情况日志信息很全排查问题时要养成先看日志的习惯。但日志在长时间运行后会越滚越大建议定期清理或交给 logrotate 处理容器本身不负责帮你瘦身。我自己的实际体会是iVentoy 这把利器真正解决的是“降低网络装机门槛”这件事。以前提起 PXE大家默认要会 dnsmasq、要会写菜单、要懂 TFTP 目录结构普通人根本不敢碰。现在一个 Docker 命令加一个 Web 界面就能把整套链路支棱起来不需要对 PXE 原理有多深的理解把 ISO 往目录里一丢剩下的交给它。如果你也想在局域网里搞一个随用随装的系统仓库建议先拿虚拟机把整条链路跑通再找个不忙的时间段上真机试一台确认无误后再批量推进。
