Skip to content

网络启动目录(Netboot)

OS 安装目录菜单、覆盖层、应答文件模板与安装任务管理。

相关文档: 引导配置 | OS 镜像管理 | Web UI 指南


OS 目录菜单

PxeLab 内置 OS 安装目录,集成 netboot.xyz 的发行版索引,支持 10 个分组:

分组内容
Linux Distributionsx86_64 Linux 发行版
Linux Distributions (32-bit)32 位 Linux
Linux Distributions (arm64)ARM64 Linux
BSD SystemsFreeBSD / OpenBSD 等
Live CDs图形化 Live 环境
Live CDs (arm64)ARM64 Live 环境
System Tools系统工具 / 救援镜像
WindowsWindows PE / 安装
DOSDOS 引导
Unix其他 Unix 系统

Web UI:基础配置 → 服务配置 → Netboot 目录(或侧边栏底部 设置 → Netboot → 目录菜单结构

  • 启用/禁用分组
  • 自定义显示标题
  • 拖拽排序分组顺序

覆盖层(Overlay)

为特定发行版定制引导参数,不影响默认配置:

  • API:PUT /api/v1/netboot/overlays/{distro}
  • 覆盖 kernel 参数、initrd 参数等
  • 按发行版独立配置

应答文件模板

自动化安装的应答文件管理:

  • 预设模板:常见发行版的安装应答文件
  • 自定义模板:创建、编辑、验证
  • 版本管理:保存历史版本,支持回滚
  • 预览:生成最终应答文件预览
  • 验证:语法和格式验证

API:/api/v1/netboot/answer-templates


安装任务

跟踪和管理网络安装任务:

  • 创建安装任务(指定发行版、目标、应答文件)
  • 查询任务状态
  • 按 MAC 地址查询任务:GET /api/v1/netboot/task/by-mac/{mac}
  • 获取应答文件:GET /api/v1/netboot/answer/{task_id}

本地缓存

侧边栏底部 设置 → Netboot 中启用本地缓存(默认开启):

  • 缓存下载的引导文件到磁盘
  • 加快重复引导速度
  • 缓存统计:GET /api/v1/netboot/cache-stats
  • Web UI 实时显示缓存路径和磁盘占用

PxeLab - 一体化 PXE 网络引导服务器