netboot.xyz 网络启动故障排除指南：从通电到装机的完整排障路线

【免费下载链接】netboot.xyzYour favorite operating systems in one place. A network-based bootable operating system installer based on iPXE.项目地址: https://gitcode.com/gh_mirrors/ne/netboot.xyz

机房里 50 台新机没有光驱，或者电脑进不了系统想抢救一份数据——netboot.xyz 就是干这个的：它是基于 iPXE（运行在网卡上的轻量启动器）的网络装机与救援工具，机器开机联网后就能从菜单里挑发行版装系统，或起一个 Live 环境修机器。

选对启动文件：BIOS 用 .lkrn，UEFI 用 .efi

选错启动文件是失败的第一大原因。对照固件类型挑文件：

通电之后按时间线走：DHCP 拿地址 → 拉菜单 → 下镜像

整个流程是一条链，卡在哪一步就查哪一步：

1. DHCP 拿地址。卡住了试试：检查网线与交换机端口，确认 DHCP 服务在运行，防火墙放行 DHCP 报文。
2. TFTP/HTTPS 拉菜单。卡住了试试：解析 boot.netboot.xyz 失败通常是 DNS 问题。手动配静态 IP 和 DNS，或者直接用 IP 绕过域名：

chain http://45.79.92.203/ipxe/netboot.xyz.lkrn

3. 选镜像下载。卡住了试试：先确认走对了固件对应的文件（见上表），再看源站带宽，必要时换源。

镜像下载不动时：换源或自建

官方源在你网络里慢或不通时，最简单的办法是自己搭一套，一行命令：

ansible-playbook site.yml

跑完后内网机器走本地 TFTP/HTTPS，下载速度取决于你自己的带宽。

进阶三连：自建服务、定制菜单、签名验证

自建服务跑通后，菜单内容可以在 etc/netbootxyz/custom/custom.ipxe.j2 里裁剪，只留你们常用的发行版，菜单加载会更快。对完整性有要求的环境，用签名验证（roles/netbootxyz/tasks/generate_signatures.yml）给启动文件做签名，防止中途被篡改。另外菜单里备了不少现成工具：系统救援类的 Clonezilla、GParted、System Rescue，硬件诊断类的 Memtest、MemTest86，安全类的 Kali、Tails，排障时不必另外找 U 盘介质。

🛠️ 排障速查表

需要手动深挖时，在启动过程按下m进安全菜单，选 iPXE Debug Shell 用shell命令逐条调试网络参数。

收尾：三条行动建议

定期关注 CHANGELOG.md 的更新记录，站点版本越新兼容性越好。改过配置就备份一份 user_overrides.yml，方便回滚。上线新配置前，先在测试机上走一遍完整流程再推生产。

【免费下载链接】netboot.xyzYour favorite operating systems in one place. A network-based bootable operating system installer based on iPXE.项目地址: https://gitcode.com/gh_mirrors/ne/netboot.xyz