dreamcat4/pxe

PXE镜像概述

本Docker镜像提供PXE网络启动解决方案，帮助本地PC实现无磁盘、无USB或DVD的网络引导。支持Legacy BIOS和UEFI两种启动模式，适用于快速部署操作系统或无盘工作站场景。

核心功能

镜像包含以下组件及特性：

• dnsmasq服务器：预配置为代理模式，响应初始PXE请求，内置TFTP服务器发送ipxe二进制文件；
• ipxe工具：支持BIOS和UEFI模式，支持HTTP（比TFTP更快）和iSCSI客户端（仅Legacy BIOS），提供示例启动菜单；
• nginx web服务器：在ipxe加载后发送后续启动文件；
• 示例配置：自动在/pxe卷中生成pxe.default文件夹，包含Win10、Ubuntu等系统的启动示例。

使用场景

• 企业IT批量部署操作系统；
• 实验室或教学环境快速装机；
• 无盘工作站的网络启动需求；
• 系统维护与恢复场景。

配置说明

前置要求

1. 下载所需操作系统的ISO文件（如Win10、Ubuntu桌面版）；
2. 手动解压ISO中的必要启动文件（参考pxe.default文件夹内的说明）；
3. 配置Samba共享（用于挂载ISO文件，可使用dreamcat4/samba-iso辅助镜像）。

Windows配置

• 按pxe.default内的指引解压缺失的BOOT文件；
• 将ISO文件挂载到独立的Samba共享。

Ubuntu配置

• 编辑boot.ipxe文件中的Samba用户名、密码等信息；
• 持久化模式（casper-rw）仅支持Legacy BIOS模式。

Docker部署示例

单容器运行

bash
docker run -d \
  --name pxe \
  --net=host \
  -v /your/local/pxe/folder:/pxe \
  dreamcat4/pxe

注：使用--net=host确保网络广播功能正常。

已知问题

• Windows：Win10安装程序可能缺少修复按钮，需拆分启动项；部分UEFI客户端启动Win7较慢；
• Ubuntu：持久化模式在UEFI下不生效，关机时分区可能无法正确卸载。

FAQ

Q：支持Mac OS X吗？
A：Mac设备需额外工具（如BSDPy），可参考官方资源尝试配置。

credits

由Dreamcat4开发维护的PXE镜像V1版本。 ===FULL_DESC===