在 Docker 容器中运行 Windows 完整指南：从零部署到调优

在 Docker 容器中运行 Windows 完整指南：从零部署到调优

【免费下载链接】windowsWindows inside a Docker container.项目地址: https://gitcode.com/GitHub_Trending/wi/windows

想在测试或兼容性场景里用 Windows，却不想再装一套虚拟化平台？wi/windows 项目把 Windows 直接跑进 Docker 容器：自动下载安装镜像、无人值守安装、浏览器打开就能看到桌面。这篇指南带你走完容器化 Windows 部署的完整流程。

一个 Windows 容器能带来什么

简单说，一个容器就是一台 Windows 机器，相比传统虚拟机软件管理：

• 不需要额外平台：会跑 Docker 就能跑，环境要求很低；
• 全自动安装：容器自己下载安装镜像、分区、配置账号，不用手动点安装向导；
• 接近原生的速度：使用宿主机 KVM 硬件加速，不是嵌套虚拟机的模拟；
• 资源就是环境变量：CPU 核数、内存、磁盘容量全靠参数指定，默认 2 核 / 4G 内存 / 64G 磁盘；
• 多实例并行、彼此隔离，还可以挂载宿主机文件夹与 Windows 直接换文件。

只想要一个轻量 Windows 时，把 VERSION 指向 LTSC 或 Tiny 这类精简版本即可，下载体积可从 3GB 控制到 7.9GB（版本表见下文）。

容器内部机制速览

容器里由 QEMU 负责虚拟整机，KVM 提供硬件加速，安装则完全交给无人值守脚本：

1. 容器启动后，下载脚本按VERSION参数拉取对应安装镜像；
2. assets/ 目录里的无人值守应答文件（每个版本一对 XML 加 cmd，如 assets/win10x64.xml）接管自动分区、语言与账号配置；
3. 装完自动启动并登录，8006 端口是 Web 控制台，3389 端口是 RDP；
4. 系统盘放在容器/storage目录，映射到宿主机文件夹后，删容器不会丢磁盘镜像。

部署前准备

宿主机需是支持 KVM 的 Linux 系统（Docker Desktop 不支持），可用内存至少 2G、磁盘空间至少 32G。先验证 KVM：安装 cpu-checker 后运行sudo kvm-ok，输出KVM acceleration can be used即可用；若宿主机本身是虚拟机，还要确认开启了嵌套虚拟化。

三步完成部署

1. 获取项目

git clone https://gitcode.com/GitHub_Trending/wi/windows cd windows

2. 启动容器：仓库自带 compose.yml，直接执行docker compose up -d。

3. 打开 Web 控制台：浏览器访问 127.0.0.1:8006，能看到 Windows 实时安装过程，出现桌面即安装完成。

用 VERSION 参数选择系统版本

默认安装 Windows 11 Pro（约 7.9GB）。在 compose.yml 的 environment 区改VERSION即可换版本：

LANGUAGE参数可指定安装语言，例如LANGUAGE: "Chinese"。

验证与日常使用

装好后日常使用建议走 RDP 而不是 Web 控制台——响应更快，还支持剪贴板。用任意远程桌面客户端连接容器 IP，默认账号Docker、密码admin（可用USERNAME/PASSWORD修改）。把宿主机文件夹挂载到/shared，它会以 Z: 盘形式出现在 Windows 里，双向换文件很方便。

常用调优参数：RAM_SIZE: "8G"加内存、CPU_CORES: "4"加核数、DISK_SIZE: "256G"扩磁盘（已有数据保留，扩完后需在 Windows 内手动扩展分区）。完整清单见 docs/environment.md。

安装卡住时按顺序排查三件事：KVM 是否可用（没有 KVM 会退化为软件模拟、极慢）、磁盘空间是否充足、镜像下载是否稳定。

【免费下载链接】windowsWindows inside a Docker container.项目地址: https://gitcode.com/GitHub_Trending/wi/windows