
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
本Docker镜像提供独立的PXE(预启动执行环境)服务器功能,基于dnsmasq实现。可部署在已配置DHCP服务器的现有网络中,也可用于无DHCP服务器的网络环境。当前支持提供MemTest86+工具的网络启动服务。
linux/amd64和linux/arm64架构构建和运行本容器镜像需满足以下依赖:
镜像的ENTRYPOINT已设置为以no-daemon模式运行dnsmasq。可通过命令行选项添加一个或多个dhcp-range配置。有关dnsmasq命令行选项的详细信息,请参考dnsmasq文档。
在不配置网络DHCP中继的情况下,最简单的运行方式是使用主机网络模式:
shelldocker run -it --rm --net=host ferrarimarco/pxe
容器镜像同时发布于GitHub容器仓库:https://github.com/ferrarimarco/docker-pxe/pkgs/container/pxe
若要为指定IP地址范围启用内置DHCP服务器,添加dhcp-range选项:dhcp-range=x.x.x.x,y.y.y.y,z.z.z.z,其中:
x.x.x.x:IP地址范围起始值y.y.y.y:IP地址范围结束值z.z.z.z:子网掩码若要使用现有DHCP服务器,仅让dnsmasq处理PXE功能,添加dhcp-range选项:dhcp-range=x.x.x.x,proxy,其中x.x.x.x是运行dnsmasq的服务器IP地址。
所有配置文件均可根据需求修改。查看Dockerfile可了解文件位置(主要在/etc和/var/lib/tftpboot目录),可通过以下方式自定义:
若只需添加额外启动菜单项,可覆盖/var/lib/tftpboot/pxelinux.cfg/additional_menu_entries文件。该文件语法参考syslinux文档。
示例:添加Memtest86+第二入口和Ubuntu 16.04启动项
以下是additional_menu_entries文件示例,除默认Memtest86+外,添加自定义Memtest86+和Ubuntu 16.04启动选项:
textLABEL memtest86-2 MENU LABEL Memtest86+ 第二入口 KERNEL /memtest/memtest86+ LABEL ubuntu-16-04-amd64 MENU LABEL Ubuntu 16.04 amd64 KERNEL /ubuntu/16.04/16.04.2-server-amd64/install/netboot/ubuntu-installer/amd64/linux APPEND /install/vmlinuz auto=true interface=eth0 hostname=cluster domain=home url=tftp://<pxe-container-ip>/preseed/16.04/preseed.cfg initrd=ubuntu/16.04/16.04.2-server-amd64/install/netboot/ubuntu-installer/amd64/initrd.gz debian-installer=en_US locale=en_US kbd-chooser/method=us keyboard-configuration/modelcode=SKIP keyboard-configuration/layout=USA keyboard-configuration/variant=USA console-setup/ask_detect=false --
dhcp-range和/var/lib/tftpboot/pxelinux.cfg/default--net=host选项运行容器vagrant up,将启动一个通过指定PXE启动的Virtualbox VM(带NAT网络适配器)测试示例
Virtualbox默认在每个虚拟网络中运行DHCP服务器。若要测试PXE功能,需将基于本镜像的容器以DHCP代理模式(参见独立DHCP服务器)和主机网络栈(使用--net=host选项)运行,此时容器IP与Docker主机IP相同。
例如,若Virtualbox DHCP服务器在192.168.56.0/24子网分配地址(可通过查看主机-only网络的虚拟网络配置获取此信息),则启用DHCP代理的dhcp-range选项可为:dhcp-range=192.168.56.2,proxy,其中192.168.56.2是运行本镜像容器的Docker主机在"主机网络"模式下的IP地址。
若通过TFTP服务器提供内容(如preseed.cfg),需更新/var/lib/tftpboot/pxelinux.cfg/default中的IP地址以指向运行PXE的容器IP。建议为运行PXE的容器手动分配或保留IP地址(或主机名)。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。





来自真实用户的反馈,见证轩辕镜像的优质服务