企业官网建设流程全解析

本文基于 szabis/iventoy:1.0.39，实测引擎iVentoy 1.0.39（Free Edition · Linux x86_64），测试平台Ubuntu 24.04Linux。

机房里新到一批裸机：有人抱着一摞 U 盘逐台烧 Ubuntu，有人在 BIOS 里改启动项装到一半才发现 ISO 放错版本，有人半夜还在给 Windows 装机包拷盘。想「网线一插就能选系统」，常见做法是自建 DHCP + TFTP + HTTP，再手写菜单——规则散在 Wiki 和脚本里，换架构或加一张 ISO 就要重配一轮。

另一层更硬：装机流量和 ISO 最好留在内网盘上。公有云模板不适合专有云 / 等保机房；纯手工 PXE 又容易和现网 DHCP、67/69 端口打架。很多团队其实已经有一台跑 Docker 的 Ubuntu，缺的只是镜像能拉、26000能开、ISO 落在挂载目录。

iVentoy（中文官网、GitHub · ventoy/PXE）是增强版PXE / HTTPBoot服务器：ISO 直接投放、无需拆包，可同时给多台机器网络启动与安装；支持 Legacy / 各架构 UEFI（含安全启动）及鲲鹏、飞腾、龙芯等信创机型，覆盖 Windows / WinPE / Linux 等110+类系统。社区镜像szabis/iventoy（镜像页）把能力装进容器；管理台26000，PXE HTTP16000。

部署跑通之后，你实际能做这些事：

本文用 轩辕镜像 加速拉取szabis/iventoy:1.0.39，Docker Compose以host 网络 + privileged +AUTO_START_PXE=false启动。实测局域网 IP192.168.1.35，请换成你的。无 Compose 见第八节。文内7张实测截图。

上手要点

• 部署：第五节 Compose；备选docker run见第八节
• 访问：宿主26000→ GUI；PXE HTTP16000（host 模式直接占宿主端口）
• 硬性：privileged: true+network_mode: host
• 自动启：镜像默认AUTO_START_PXE=true。跟做须写false（省略 ≠ 关闭）；否则进程会退出，curl得000（见 5.4）
• Server IP：GUI 常默认docker0/172.17.0.1——装机改选局域网（实测 **192.168.1.35/ br0`）
• 数据：./data、./iso、./driver、./log、./user→/opt/iventoy/...
• 标签：跟做1.0.39，勿写latest；体积 DISK253MB/ CONTENT74.4MB
• 现网：已有 DHCP 时先改 External / Proxy，或隔离实验网段

官方：中文官网 · 快速开始 · 第三方 DHCP · 镜像页

一、iVentoy 是什么？

相对「自己拼 DHCP + TFTP + nginx」，iVentoy 更偏浏览器里管多 ISO 网络启动：ISO 放进目录即可，菜单可中文显示，并按客户端架构过滤镜像。不熟悉 PXE / DHCP / TFTP 时，不要直接在生产办公网开内置 DHCP。

浏览器（管理台） │ :26000 ▼ szabis/iventoy （host + privileged） ├── ./data → /opt/iventoy/data ├── ./iso → /opt/iventoy/iso ├── ./user / ./driver / ./log ├── :16000 PXE HTTP └── :67/udp :69/udp …（按 DHCP 模式）

能力说明见 iVentoy 中文简介。/r/与/zh/r/为同一镜像不同页面。同站还有其它社区 iventoy 镜像；本文固定szabis/iventoy:1.0.39。上游官网若已发新版本资讯，Docker 标签仍以 tags 为准。

二、环境要求

docker--versiondockercompose version

Linux 未装 Docker 可使用轩辕镜像一键安装脚本：

bash<(wget-qO- https://get.xuanyuan.cloud/docker.sh)

备用地址：

bash<(wget-qO- https://get.xuanyuan.me/docker.sh)

更多见 轩辕镜像使用手册。

ss-tlnp|grep-E':26000|:16000'ss-ulnp|grep-E':67|:69'

host 网络下不能像桥接那样改映射左侧端口，只能停掉占用进程，或在 iVentoy「参数配置」里改服务端口。

安全：PXE 可让可达客户端拉起安装菜单。勿把26000 / 16000裸暴露公网；生产网优先第三方 DHCP + External，并限制二层域。

三、标签怎么选

跟做使用1.0.39。完整列表：tags。

升级前备份./data与./iso，同步改 pull、Compose、docker run三处标签，并核对维护者 changelog / 上游说明。

四、拉取镜像

用 轩辕镜像 加速拉取：

dockerpull docker.xuanyuan.run/szabis/iventoy:1.0.39

Ubuntu 24.04 实测：

1.0.39: Pulling from szabis/iventoy 1b89f26c9bf9: Pull complete 1c24335ddd46: Pull complete 6f5c5aa4e145: Pull complete 86281a433bb8: Pull complete 938d92953e2b: Pull complete fae021f388e1: Pull complete Digest: sha256:64b80533370881587c8e958f5d572729934cecdfe036f48ba138f2036e8fe741 Status: Downloaded newer image for docker.xuanyuan.run/szabis/iventoy:1.0.39 docker.xuanyuan.run/szabis/iventoy:1.0.39

dockerimages docker.xuanyuan.run/szabis/iventoy:1.0.39

IMAGE ID DISK USAGE CONTENT SIZE EXTRA docker.xuanyuan.run/szabis/iventoy:1.0.39 64b805333708 253MB 74.4MB

401 / 402 见 常见问题。

五、Docker Compose 部署（推荐）

容器须以 root 跑，且privileged: true、network_mode: host。host 下 Compose 的ports:不生效，故下文不写端口映射。

5.1 准备目录

mkdir-p/www/wwwroot/iventoy/{data,driver,iso,log,user}cd/www/wwwroot/iventoy# macOS：mkdir -p ~/docker/iventoy/{data,driver,iso,log,user} && cd ~/docker/iventoy

非 root 给mkdir加sudo。ISO 可稍后放入iso/（见 6.5）；官方要求目录名与文件名不要含空格和非 ASCII，也可用ln -s链到大容量盘。

5.2 编写 docker-compose.yml

cat>docker-compose.yml<<'EOF' services: iventoy: image: docker.xuanyuan.run/szabis/iventoy:1.0.39 container_name: iventoy hostname: iventoy network_mode: host privileged: true restart: unless-stopped environment: - TZ=Asia/Shanghai - AUTO_START_PXE=false healthcheck: test: ["CMD", "curl", "--fail", "--silent", "--head", "http://localhost:26000/"] interval: 30s timeout: 10s retries: 3 start_period: 2m volumes: - ./data:/opt/iventoy/data - ./driver:/opt/iventoy/driver - ./iso:/opt/iventoy/iso - ./log:/opt/iventoy/log - ./user:/opt/iventoy/user EOF

宿主端口对照（核对占用用，不是Compose 映射）：

5.3 启动并验证

dockercompose up-ddockercomposeps

Ubuntu 24.04 实测：

[+] up 1/1 ✔ Container iventoy Started

NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS iventoy docker.xuanyuan.run/szabis/iventoy:1.0.39 "/opt/iventoy/entryp…" iventoy 4 seconds ago Up 2 seconds (health: starting)

host 下PORTS列常为空。Up≠ GUI 已就绪，以日志与curl为准。

dockercompose logs-fiventoy

成功关键行（实测，AUTO_START_PXE=false）：

iventoy | [INFO] Timezone set to Asia/Shanghai iventoy | [INFO] Auto start disabled iventoy | iventoy start SUCCESS PID=31 iventoy | #################### iVentoy 1.0.39 #################### iventoy | [HTTP] HTTP API service is running on 0.0.0.0:26000 ... iventoy | [5] 192.168.1.35 255.255.255.0 192.168.1.1 br0 iventoy | iVentoy entering main loop ... iventoy | [HTTP] 200 HEAD / size 0

若仍是Auto start enabled或随后出现Main loop break，见5.4。装机用局域网 IP（上表 **192.168.1.35/ br0），不要用172.x` 的 docker 网桥。

Ctrl+C只退出日志跟踪。再探测：

curl-s-o/dev/null-w"%{http_code}\n"http://127.0.0.1:26000/

200

浏览器打开：

http://192.168.1.35:26000

界面步骤见第六节。

5.4 踩坑：自动启默认开、脏config.dat

镜像 ENV 默认AUTO_START_PXE=true。Compose省略该变量时仍会自动启。

现象：日志Auto start enabled，随后No config.dat exist, can NOT auto run或DHCP server ip is 0，再Main loop break；curl得000。失败退出时还会写出残缺config.dat（ip:0.0.0.0），下次自动启仍会挂。

修复：

cd/www/wwwroot/iventoydockercompose downrm-f./data/config.dat# 确认 compose 含 AUTO_START_PXE=falsedockercompose up-d--force-recreatecurl-s-o/dev/null-w"%{http_code}\n"http://127.0.0.1:26000/

期望日志出现Auto start disabled与entering main loop，curl为200。GUI 选好局域网 IP、点过绿色 Start 并确认 PXE 可用后，再视需要改回AUTO_START_PXE=true。

六、浏览器首次配置与体验

建议Chrome或Firefox。打开http://192.168.1.35:26000。

6.1 启动信息：改选局域网 IP 并启 PXE

首次进入多为启动信息。下拉「选择本机 IP」常默认docker0/172.17.0.1——局域网裸机装机必须改选192.168.1.35（或你的 br0 / eth0），再按需改地址池 / 网关 / DNS，最后点右侧绿色启动。

页脚可见Version 1.0.39 Linux x86_64与免费版提示。

6.2 参数配置：DHCP 与端口

参数配置可改 TFTP 超时、HTTP16000/ NBD / iSCSI / NFS，以及 DHCP 模式、二次 DHCP、启动背景、Legacy/UEFI 引导文件等。改完点保存。

External 时在第三方 DHCP 设：next-server= iVentoy IP；bootfile=iventoy_loader_16000（HTTP 端口改过则后缀跟着改）。见 第三方 DHCP。

6.3 MAC 过滤

控制哪些客户端可获得PXE服务：白名单 / 黑名单，支持*模糊匹配。办公网建议至少看一眼，避免无关机器误进装机菜单。

6.4 用户过滤

按 IP 限制谁能打开管理台（不是 PXE 客户端）。支持192.168.1.*通配；生产建议只放运维网段。

6.5 镜像管理

空目录时界面会提示：把镜像放到iso目录后点刷新（也可上传）。

cp/path/to/ubuntu-24.04-live-server-amd64.iso /www/wwwroot/iventoy/iso/# GUI 点「刷新」；文件名勿含空格与非 ASCII

刷新后列表应出现 ISO。客户端开网络启动，即可进入 iVentoy 菜单选系统；装机流量走16000等端口，需保证二层/三层可达。

6.6 注册信息

可核对1.0.39 Linux x86_64、免费版标识与机器码（升级专业版时用）。

6.7 可选：配置成功后再开自动启

仅当 GUI 已选好局域网 IP、点过绿色 Start、PXE 确认可用后，再把 Compose 改为AUTO_START_PXE=true并docker compose up -d。此前保持false（原因见 5.4）。

6.8 生产加固

• 26000仅内网或 VPN；配合用户过滤限制运维 IP
• 现网优先第三方 DHCP + External
• MAC 过滤限制可装机客户端
• 升级前备份./data与 ISO；勿把 privileged 容器暴露公网

七、备份、升级与迁移

cd/www/wwwroot/iventoydockercompose stoptar-czfiventoy-backup-$(date+%F).tar.gz data driver iso user log docker-compose.ymldockercompose start

ISO 很大时可只备份data/user，ISO 库另做存储快照。

升级：查 tags → 改 Compose 标签 →docker compose pull && docker compose up -d→ 打开:26000核对版本。迁移时恢复同结构目录与docker-compose.yml，在新机改选 Server IP 后启动。

八、备选：docker run

无 Compose 时可临时使用；日常仍建议第五节。

mkdir-p/www/wwwroot/iventoy/{data,driver,iso,log,user}dockerrun-d--nameiventoy\--networkhost\--privileged\--restartunless-stopped\-eTZ=Asia/Shanghai\-eAUTO_START_PXE=false\--health-cmd='curl --fail --silent --head http://localhost:26000/ || exit 1'\--health-interval=30s\--health-timeout=10s\--health-retries=3\--health-start-period=2m\-v/www/wwwroot/iventoy/data:/opt/iventoy/data\-v/www/wwwroot/iventoy/driver:/opt/iventoy/driver\-v/www/wwwroot/iventoy/iso:/opt/iventoy/iso\-v/www/wwwroot/iventoy/log:/opt/iventoy/log\-v/www/wwwroot/iventoy/user:/opt/iventoy/user\docker.xuanyuan.run/szabis/iventoy:1.0.39

host 下-p无效。首次必须AUTO_START_PXE=false；曾失败则先删data/config.dat。

dockerps--filtername=iventoydockerlogs-fiventoydockerstop iventoy&&dockerrmiventoy

九、常见问题 FAQ

Q1：和现网 DHCP 冲突？
立刻停容器或改 External / Proxy，并在路由器配next-server与bootfile。实验用独立交换机。

Q2：curl得000/ 打不开 26000？
看是否Auto start enabled后进程退出，或存在脏config.dat——按5.4处理。再查防火墙与访问 IP（用192.168.1.35，勿用172.x）。

Q3：ISO 放了但镜像管理是空的？
去掉空格与中文文件名；确认挂载的是宿主机./iso；GUI 点刷新。

Q4：必须 privileged + host 吗？
按维护者说明，是。桥接 + 普通权限通常跑不稳完整 PXE。

Q5：Docker Desktop 能给办公室电脑装系统吗？
管理台或许能开，局域网裸机 PXE不可靠。装机用 Linux 物理机或桥接网卡的虚拟机。

Q6：GUI 里 Server IP 选哪个？
选局域网地址（实测 **192.168.1.35/ br0）。默认的docker0/172.17.0.1` 只服务 Docker 网桥，物理机进不了装机菜单。

Q7：为什么不用latest？
浮动标签会静默升级，步骤可能与文档脱节。跟做固定1.0.39。

Q8：Compose 删了AUTO_START_PXE为何还是 Auto start enabled？
镜像默认就是true。必须显式写false。Hub 示例里的true仅适合已有成功配置之后。

十、命令速查

dockerpull docker.xuanyuan.run/szabis/iventoy:1.0.39cd/www/wwwroot/iventoydockercompose up-ddockercomposepsdockercompose logs-fiventoycurl-s-o/dev/null-w"%{http_code}\n"http://127.0.0.1:26000/# 修复自动启失败dockercompose down&&rm-f./data/config.dat&&dockercompose up-d--force-recreatedockercompose pull&&dockercompose up-ddockercompose down

十一、延伸阅读

总结

• 跟做szabis/iventoy:1.0.39：Compose +host+privileged+AUTO_START_PXE=false
• 管理台http://IP:26000；Server IP 选局域网，勿用 docker0；ISO 进./iso
• 现网处理好 DHCP；可用 MAC / 用户过滤加固
• 自动启失败：删./data/config.dat并保持false，GUI 跑通后再改true

阅读原文

• 轩辕镜像官方博客：https://xuanyuan.cloud/blog/iventoy-docker-deploy