Dockur Windows项目加载自定义ISO镜像的技术指南

在使用Dockur Windows项目时，许多用户会遇到自定义ISO镜像加载失败的问题。本文将以Ubuntu 24.04系统为例，详细介绍正确的配置方法。

常见错误现象分析

当用户尝试通过本地路径加载ISO镜像时，通常会遇到以下错误提示：

ERROR: Invalid VERSION specified, value "/data/isos/Windows95.iso" is not recognized!

这个错误表明容器无法识别用户指定的本地路径格式。与直接从URL下载ISO不同，本地加载需要遵循特定的文件命名和存储规则。

正确的配置方法

1. 文件命名规范：

   • 必须将ISO文件重命名为custom.iso
   • 这是项目的硬性要求，任何其他名称都会导致加载失败

2. 存储路径设置：

   • 文件必须放置在容器内的/storage目录
   • 通过volume映射将主机目录挂载到容器中
   • 示例配置：

     volumes:
       - /path/on/host:/storage
     

3. 环境变量配置：

   • 不需要在VERSION变量中指定路径
   • 系统会自动检测/storage目录下的custom.iso文件

完整配置示例

services:
  windows:
    image: dockurr/windows
    container_name: windows95
    devices:
      - /dev/kvm
      - /dev/net/tun
    cap_add:
      - NET_ADMIN
    ports:
      - 8006:8006
      - 3389:3389/tcp
      - 3389:3389/udp
    volumes:
      - /data/isos:/storage

注意事项

1. 在修改配置后，建议先删除旧容器再创建新容器，以确保配置完全生效
2. 确保主机上的ISO文件具有正确的读写权限
3. 对于Windows 95等较旧系统，可能需要额外的兼容性设置

通过遵循以上规范，用户可以顺利加载自定义ISO镜像并运行各种Windows系统。这种设计既保证了安全性，又简化了用户操作流程。

进阶技巧

对于需要频繁切换不同ISO镜像的用户，可以通过以下方法优化：

1. 创建多个子目录，每个目录包含一个custom.iso
2. 根据需要修改volume映射路径
3. 使用脚本自动完成ISO文件的切换和重命名

这种方案既保持了项目的规范性，又提供了足够的灵活性。