dockur/windows

项目简介

dockur/windows 是一个让你能在 Docker 容器中运行 Windows 操作系统的开源项目。它通过自动化下载和安装流程，将完整的 Windows 系统封装在容器内，并利用 KVM 加速提供接近原生的性能。你只需启动容器，通过浏览器访问指定端口，即可开始使用一个全新的 Windows 环境。

核心特性

• 全自动安装：无需手动操作，容器启动后自动下载并安装所选 Windows 版本。
• 多版本支持：涵盖 Windows 11、10、8.1、7、Vista、XP 乃至 Windows 2000、98、95、ME，以及 Windows Server 系列和 Tiny11 等精简版。
• 资源可调：可自定义 CPU 核心数、内存大小和磁盘容量，支持动态内存分配。
• 外设与共享：支持 USB 直通和宿主机文件夹共享，方便文件交换。
• 网络灵活：支持 NAT、用户模式、macvlan 和 macvtap 等多种网络模式。
• 多种访问方式：提供基于 Web 的查看器（默认端口 8006）和 RDP 连接（默认端口 3389）。

快速开始

使用 Docker Compose 启动一个 Windows 11 容器：

services:
  windows:
    image: dockurr/windows
    container_name: windows
    environment:
      VERSION: "11"
    devices:
      - /dev/kvm
      - /dev/net/tun
    cap_add:
      - NET_ADMIN
    ports:
      - 8006:8006
      - 3389:3389/tcp
      - 3389:3389/udp
    volumes:
      - ./windows:/storage
    restart: always
    stop_grace_period: 2m

启动后，在浏览器中打开 http://127.0.0.1:8006 即可看到安装进度，安装完成后自动进入 Windows 桌面。

配置说明

通过环境变量可以调整各项参数，例如：

• VERSION：指定 Windows 版本（如 10、11l、2022 等）。
• DISK_SIZE：设置磁盘大小（默认 64G）。
• RAM_SIZE：设置内存大小（默认 4G）。
• CPU_CORES：设置 CPU 核心数（默认 2）。
• USERNAME / PASSWORD：自定义登录凭据（默认 Docker / admin）。
• AUDIO：设为 Y 可启用音频流。

更多配置（如共享文件夹、网络模式）可参考项目 README。

注意事项

• 宿主机需要支持 KVM，且 Docker Desktop 在 Linux、macOS 和 Windows 10 上不提供 KVM 访问，因此不受支持。
• 建议使用 RDP 客户端连接以获得更流畅的体验，Web 查看器主要用于安装阶段。
• 安装过程需要下载数 GB 的系统镜像，请确保网络和磁盘空间充足。

适用场景

该项目非常适合需要在 Linux 环境中快速获得 Windows 实例的开发者，例如进行跨平台测试、运行 Windows 专属工具，或在 CI 中提供临时的 Windows 环境。