linuxserver/netbootxyz

镜像概述和主要用途

Netbootxyz 是一种通过PXE从BIOS中启动各种操作系统安装程序或实用工具的方式，无需获取物理介质。它使用iPXE提供用户友好的菜单，让您可以轻松选择所需的操作系统以及任何特定类型的版本或可启动标志。

弃用通知

此镜像已弃用。我们将不再为该镜像提供支持，也不会更新。

建议切换到官方容器：[***]

核心功能和特性

LinuxServer.io团队提供的此容器具有以下特点：

• 定期及时的应用更新
• 简单的用户映射（PGID、PUID）
• 带有s6覆盖的自定义基础镜像
• 每周基础操作系统更新，在整个LinuxServer.io生态系统中共享公共层，以最小化空间使用、停机时间和带宽
• 定期安全更新

支持的架构

我们利用docker manifest实现多平台支持。只需拉取 lscr.io/linuxserver/netbootxyz:latest 即可获取适合您架构的正确镜像，您也可以通过标签拉取特定架构的镜像。

此镜像支持的架构：

版本标签

此镜像提供多种版本，可通过标签获取。请仔细阅读描述，并在使用不稳定或开发标签时谨慎行事。

应用设置

要使用此镜像，您需要一个现有的DHCP服务器，您可以在其中将此TFTP服务器设置为DHCP启动目标。此镜像不包含DHCP服务器，我们未来也不打算支持DHCP服务器功能。这只是一个托管来自netboot.xyz的最新IPXE内核构建的TFTP服务器。如果您对他们的项目感兴趣，但没有能力设置DHCP服务器来引导此 payload，他们的下载页面上也提供了可使用的USB stick镜像。

路由器设置示例

PFSense

服务 -> DHCP服务器

设置"TFTP服务器"选项和高级"网络启动"部分下的选项。

• 勾选启用
• 下一个服务器 - TFTP服务器使用的IP
• 默认BIOS文件名 - netboot.xyz.kpxe
• UEFI 32位文件名 - netboot.xyz.efi
• UEFI 64位文件名 - netboot.xyz.efi

OPNsense

服务 -> DHCP服务器

在高级"网络启动"部分下。

• 勾选启用
• 下一个服务器 - docker主机的IP
• 默认BIOS文件名 - netboot.xyz.kpxe
• UEFI 32位文件名 - netboot.xyz.efi
• UEFI 64位文件名 - netboot.xyz.efi

Unifi安全网关（带控制器）

网络 -> LAN（或您要从中启动的网络）-> 高级DHCP选项

• 勾选启用网络启动
• 服务器 - YOURSERVERIP
• 文件名 - netboot.xyz.kpxe 高级完全支持
• 对于USG变体，强制配置包含与EdgeOS相同配置的json（如下所示）将完全支持netboot。
• 对于UDM变体，创建有效的dnsmasq配置并放置在/run/dnsmasq.conf.d中将加载配置，但不会在重启或固件更新后保留来源。

EdgeOS/VyOS

通过SSH连接

configure
set service dhcp-server use-dnsmasq enable
set service dns forwarding options "dhcp-match=set:bios,60,PXEClient:Arch:00000"
set service dns forwarding options "dhcp-boot=tag:bios,netboot.xyz.kpxe,,SERVERIP"
set service dns forwarding options "dhcp-match=set:efi32,60,PXEClient:Arch:00002"
set service dns forwarding options "dhcp-boot=tag:efi32,netboot.xyz.efi,,SERVERIP"
set service dns forwarding options "dhcp-match=set:efi32-1,60,PXEClient:Arch:00006"
set service dns forwarding options "dhcp-boot=tag:efi32-1,netboot.xyz.efi,,SERVERIP"
set service dns forwarding options "dhcp-match=set:efi64,60,PXEClient:Arch:00007"
set service dns forwarding options "dhcp-boot=tag:efi64,netboot.xyz.efi,,SERVERIP"
set service dns forwarding options "dhcp-match=set:efi64-1,60,PXEClient:Arch:00008"
set service dns forwarding options "dhcp-boot=tag:efi64-1,netboot.xyz.efi,,SERVERIP"
set service dns forwarding options "dhcp-match=set:efi64-2,60,PXEClient:Arch:00009"
set service dns forwarding options "dhcp-boot=tag:efi64-2,netboot.xyz.efi,,SERVERIP"
commit; save

Dnsmasq/DD-WRT/OpenWRT/Tomato/PIHOLE

在UI或配置文件中的各个位置设置附加/自定义DNSMASQ选项 设置以下行：

dhcp-match=set:bios,60,PXEClient:Arch:00000
dhcp-boot=tag:bios,netboot.xyz.kpxe,,YOURSERVERIP
dhcp-match=set:efi32,60,PXEClient:Arch:00002
dhcp-boot=tag:efi32,netboot.xyz.efi,,YOURSERVERIP
dhcp-match=set:efi32-1,60,PXEClient:Arch:00006
dhcp-boot=tag:efi32-1,netboot.xyz.efi,,YOURSERVERIP
dhcp-match=set:efi64,60,PXEClient:Arch:00007
dhcp-boot=tag:efi64,netboot.xyz.efi,,YOURSERVERIP
dhcp-match=set:efi64-1,60,PXEClient:Arch:00008
dhcp-boot=tag:efi64-1,netboot.xyz.efi,,YOURSERVERIP
dhcp-match=set:efi64-2,60,PXEClient:Arch:00009
dhcp-boot=tag:efi64-2,netboot.xyz.efi,,YOURSERVERIP

更改后确保重启DNSMASQ服务。

Microsoft Server DHCP

• 运行DHCP程序
• 在作用域/作用域选项下
• 勾选选项066并输入TFTP引导服务器的FQDN或IP
• 勾选选项067并输入以下引导文件名之一：
• 默认BIOS文件名 - netboot.xyz.kpxe
• UEFI 32位文件名 - netboot.xyz.efi
• UEFI 64位文件名 - netboot.xyz.efi

从路由器角度来看，其他任何支持Dnsmasq选项或专有PXE引导选项的设备都需要检查Google以获取支持（尝试使用确切的路由器型号加上'pxe boot'）或考虑在Linux中设置自己的DHCP服务器。

此镜像还包含netboot.xyz.efi，可用于使用UEFI网络引导。如果选择使用UEFI引导和菜单，其功能将受到限制。

使用方法

为帮助您从此镜像创建容器，您可以使用docker-compose或docker cli。

[!NOTE] 除非参数标记为"可选"，否则它是必填项，必须提供值。

docker-compose（推荐，点击此处了解更多信息）

---
services:
  netbootxyz:
    image: lscr.io/linuxserver/netbootxyz:latest
    container_name: netbootxyz
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - MENU_VERSION=1.9.9 #可选
      - PORT_RANGE=30000:30010 #可选
      - SUBFOLDER=/ #可选
      - NGINX_PORT=80 #可选
      - WEB_APP_PORT=3000 #可选
    volumes:
      - /path/to/netbootxyz/config:/config
      - /path/to/assets:/assets #可选
    ports:
      - 3000:3000
      - 69:69/udp
      - 8080:80 #可选
    restart: unless-stopped

docker cli（点击此处了解更多信息）

docker run -d \
  --name=netbootxyz \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e MENU_VERSION=1.9.9 `#可选` \
  -e PORT_RANGE=30000:30010 `#可选` \
  -e SUBFOLDER=/ `#可选` \
  -e NGINX_PORT=80 `#可选` \
  -e WEB_APP_PORT=3000 `#可选` \
  -p 3000:3000 \
  -p 69:69/udp \
  -p 8080:80 `#可选` \
  -v /path/to/netbootxyz/config:/config \
  -v /path/to/assets:/assets `#可选` \
  --restart unless-stopped \
  lscr.io/linuxserver/netbootxyz:latest

参数说明

容器通过运行时传递的参数进行配置（如上所示）。这些参数用冒号分隔，表示<外部>:<内部>。例如，-p 8080:80会将容器内的端口80暴露出来，可从主机的IP上通过端口8080访问。

来自文件的环境变量（Docker secrets）

您可以通过使用特殊的前缀FILE__从文件中设置任何环境变量。

例如：

-e FILE__MYVAR=/run/secrets/mysecretvariable

将根据/run/secrets/mysecretvariable文件的内容设置环境变量MYVAR。

运行应用程序的Umask

对于我们所有的镜像，您可以使用可选的-e UMASK=022设置来覆盖容器内启动的服务的默认umask设置。 请记住，umask不是chmod，它基于其值减去权限，而不是添加权限。在请求支持之前，请先阅读相关内容。

用户/组标识符

使用卷（-v标志）时，主机操作系统和容器之间可能会出现权限问题，我们通过允许您指定用户PUID和组PGID来避免此问题。

确保主机上的任何卷目录都由您指定的相同用户拥有，任何权限问题都将神奇地消失。

在这个例子中PUID=1000和PGID=1000，要找到您的ID，请使用id your_user，如下所示：

id your_user

示例输出：

uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

我们发布各种Docker Mods以启用容器内的附加功能。可用于此镜像的Mods列表（如果有）以及可应用于我们任何镜像的通用Mods可通过上面的动态徽章访问。

支持信息

• 容器运行时的Shell访问：

  docker exec -it netbootxyz /bin/bash
  

• 实时监控容器日志：

  docker logs -f netbootxyz
  

• 容器版本号：

  docker inspect -f '{{ index .Config.Labels "build_version" }}' netbootxyz
  

• 镜像版本号：

  docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/netbootxyz:latest
  

更新信息

我们的大多数镜像是静态的、版本化的，需要更新镜像和重新创建容器来更新内部的应用程序。除了一些例外情况（在相关的readme.md中注明），我们不建议或支持在容器内更新应用程序。请查阅上面的应用设置部分，了解是否推荐对该镜像进行更新。

以下是更新容器的说明：

通过Docker Compose

• 更新镜像：

  • 所有镜像：

    docker-compose pull
    

  • 单个镜像：

    docker-compose pull netbootxyz
    

• 更新容器：

  • 所有容器：

    docker-compose up -d
    

  • 单个容器：

    docker-compose up -d netbootxyz
    

• 您还可以删除旧的悬空镜像：

  docker image prune
  

通过Docker Run

• 更新镜像：

  docker pull lscr.io/linuxserver/netbootxyz:latest
  

• 停止运行中的容器：

  docker stop netbootxyz
  

• 删除容器：

  docker rm netbootxyz
  

• 使用上述相同的docker run参数重新创建一个新容器（如果正确映射到主机文件夹，您的/config文件夹和设置将被保留）

• 您还可以删除旧的悬空镜像：

  docker image prune
  

镜像更新通知 - Diun（Docker镜像更新通知器）

[!TIP] 我们推荐Diun用于更新通知。不建议或支持其他自动更新容器的工具。

本地构建

如果您想对这些镜像进行本地修改以用于开发目的或只是为了自定义逻辑：

git clone [***]
cd docker-netbootxyz
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/netbootxyz:latest .

可以使用lscr.io/linuxserver/qemu-static在x86_64硬件上构建ARM变体，反之亦然

docker run --rm --privileged lscr.io/linuxserver/qemu-static --