garybowers/iventoy

iVentoy Docker镜像文档

镜像概述

iVentoy Docker镜像是将开源多ISO网络启动工具iVentoy打包而成的容器化应用。iVentoy允许用户通过网络（类似PXE）启动多个ISO镜像文件，无需复杂的PXE服务器配置。该Docker镜像进一步简化了iVentoy的部署流程，提供跨平台、隔离化的运行环境，方便快速搭建网络启动服务。

核心功能与特性

• 多ISO管理：支持同时管理和启动多个ISO镜像文件，满足不同系统安装需求
• 网络启动支持：通过HTTP和TFTP协议提供网络启动服务，兼容大多数支持PXE的设备
• Docker化优势：容器化部署确保环境隔离、跨平台运行（Linux、Windows、macOS），简化依赖管理
• 配置简单：无需手动配置DHCP/PXE服务器，通过容器配置即可快速启动服务
• 持久化存储：支持挂载本地目录存储ISO文件和配置，确保数据持久化
• 轻量级：基于精简基础镜像，资源占用低，适合各种硬件环境

使用场景与适用范围

• IT运维：企业内部批量部署操作系统，替代传统PXE服务器，降低维护成本
• 系统安装：机房、实验室等环境中通过网络快速安装多个不同操作系统
• 多系统测试：开发或测试环境中，快速切换不同ISO镜像进行系统兼容性测试
• 教学与演示：教学环境中展示多操作系统启动过程，无需物理介质

使用方法与配置说明

前提条件

• 安装Docker Engine（20.10+）或Docker Desktop
• 确保主机网络环境支持桥接模式，容器可被网络内其他设备访问
• 准备ISO文件目录（本地目录，用于挂载到容器）

快速启动（docker run）

通过以下命令快速启动iVentoy容器：

bash
docker run -d \
  --name iventoy \
  --net=host \
  -v /path/to/local/isos:/isos \
  -v /path/to/local/config:/config \
  -e IVENTOY_IP=192.168.1.100 \
  --restart unless-stopped \
  garybowers/iventoy:latest

Docker Compose配置

创建docker-compose.yml文件简化部署：

yaml
version: '3'
services:
  iventoy:
    image: garybowers/iventoy:latest
    container_name: iventoy
    network_mode: host
    volumes:
      - /path/to/local/isos:/isos
      - /path/to/local/config:/config
    environment:
      - IVENTOY_IP=192.168.1.100
      - IVENTOY_HTTP_PORT=80
      - IVENTOY_TFTP_PORT=69
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

关键配置说明

挂载卷（Volumes）

• /isos: 必须挂载的目录，存放需要启动的ISO镜像文件。容器将扫描该目录下的ISO文件并提供启动选项。
• /config: 可选挂载目录，用于持久化iVentoy的配置文件（如ISO列表、网络设置等），避免容器重建后配置丢失。

环境变量（Environment Variables）

• IVENTOY_IP: 容器或主机的IP地址（必填），用于网络启动设备识别服务地址
• IVENTOY_HTTP_PORT: HTTP服务端口，默认80
• IVENTOY_TFTP_PORT: TFTP服务端口（UDP），默认69
• IVENTOY_DEBUG: 是否启用调试模式，可选值true/false，默认false

网络配置

推荐使用--net=host（主机网络模式），因iVentoy需处理DHCP相关响应和PXE协议，桥接模式可能导致网络兼容性问题。若使用桥接模式，需确保宿主机端口转发正确（包括UDP 69和TCP 80端口）。

访问与使用

1. 将ISO文件放入宿主机挂载的/path/to/local/isos目录
2. 启动容器后，iVentoy自动扫描ISO文件并运行服务
3. 目标设备设置从网络（PXE）启动，将自动连接iVentoy服务并显示ISO启动菜单

注意事项

• 宿主机防火墙需开放HTTP（80）和TFTP（69/UDP）端口
• 新增ISO文件需重启容器或通过管理界面刷新（若支持）
• 网络环境需确保DHCP服务器正常工作，iVentoy可与现有DHCP共存