结论先说:想在服务器上跑一台 Windows,不想装双系统、不想手配虚拟机,dockur/windows 是一条捷径——它把 Windows 11 装进 Docker 容器,一条命令拉起,全程自动安装,浏览器打开 8006 端口就能看到桌面。这个项目在 GitHub 上有 5.4 万星(54,214,MIT 开源协议,2026 年 11 月 17 日核验),2024 年 1 月建仓至今仍在积极维护。唯一的硬门槛是宿主机必须是支持 KVM 的 Linux,内存至少 2GB、硬盘至少 32GB 空闲。
站内 11 月 16 日已发过它的项目解读(见文末内链),这篇是上手步骤。
第一步:确认宿主机能用 KVM
这是最容易翻车的地方:dockur/windows 依赖 KVM 加速,没有 KVM 也能跑,但慢到没法用。先在宿主机上执行:
sudo apt install cpu-checker sudo kvm-ok
看到“KVM acceleration can be used”才算过关。再确认设备存在:
ls -l /dev/kvm
如果 kvm-ok 报错,先查三件事:BIOS/UEFI 有没有开 Intel VT-x 或 AMD-V;宿主机本身是虚拟机的话有没有开嵌套虚拟化;VPS 要确认服务商支不支持嵌套虚拟化。kvm-ok 通过了但容器仍报 KVM 不可用,可以临时在 compose 里加 privileged: true 排查权限问题,定位清楚后再去掉。
注意:Linux/macOS/Windows 10 上的 Docker Desktop 不给容器提供 KVM 访问,走不通,最稳的是直接用一台 Linux 宿主机。
第二步:一条命令跑起来
用 Docker Compose 最省事,新建目录放一个 compose.yml:
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
然后 docker compose up -d;喜欢命令行也可以直接跑:
docker run -it --rm --name windows -e "VERSION=11" -p 8006:8006 --device=/dev/kvm --device=/dev/net/tun --cap-add NET_ADMIN -v "${PWD:-.}/windows:/storage" --stop-timeout 120 docker.io/dockurr/windows
第一次启动先下载 Windows 11 Pro 镜像(约 7.9GB),下载完自动安装,全程不用点下一步。浏览器打开宿主机 IP 的 8006 端口看安装进度,看到桌面就是装好了。
第三步:连进去用
8006 的网页查看器适合装机和临时操作,日常用建议走 RDP:任意微软远程桌面客户端连宿主机 IP 的 3389 端口,用户名 Docker,密码 admin。网页查看器响应慢、不支持剪贴板共享,RDP 体验好得多。
默认账号安装时自动建,用户名 Docker、密码 admin,装完第一件事就是改密码,也可以在启动前用环境变量指定。别把默认密码的机器直接暴露到公网,3389 一开弱密码就是送人头;只在内网用,或前面套 VPN、防火墙只放行自己的 IP。
常用配置:版本、语言、内存、硬盘
默认装 Windows 11 Pro,VERSION 可以换:11l 是 Windows 11 LTSC(4.7GB)、10 是 Windows 10 Pro(5.7GB),还有 Tiny11(5.3GB)这类精简版;连 Windows Server 2025/2022、Windows XP、Windows 98 都支持,完整版本表在项目 README 里。
默认英文版,想装中文版加 LANGUAGE: “Chinese”;键盘布局不对再加 REGION 和 KEYBOARD,例如 en-US。
默认 2 核 CPU、4GB 内存、64GB 硬盘,跑 Win11 建议至少给 8GB 内存:
environment: RAM_SIZE: "8G" CPU_CORES: "4" DISK_SIZE: "256G"
DISK_SIZE 对已有磁盘也能扩容,扩完要在 Windows 磁盘管理里手动把多出来的未分配空间扩展进分区。
宿主机和 Windows 之间怎么传文件?
装完后 Windows 桌面上多一个 Shared 文件夹,对应宿主机共享目录,这样挂:
volumes: - ./example:/shared
这个目录在 Windows 里是桌面上的 Shared 文件夹和 Z: 盘,往里放文件宿主机立刻能看到,反过来也一样。传大文件、导安装包都走这里,比网页查看器拖拽靠谱。
想装机后自动跑点什么,单个命令用 COMMAND 环境变量;复杂的把 install.bat 和文件放进一个文件夹挂到 /oem,安装最后一步自动执行。
声音、USB 与独立 IP
声音默认关,走 RDP 时才有。想在浏览器里听到,加 AUDIO: “Y”,再在网页查看器设置、高级里打开音频开关。
USB 直通要先 lsusb 查厂商 ID 和产品 ID,用 ARGUMENTS 传给 QEMU,同时把 /dev/bus/usb 挂进容器。官方明确警告过:首次启动、系统还没装完时千万别接 USB 存储设备,装机程序可能把它当系统盘格式化。等桌面出来了再接。
默认桥接网络,和宿主机共用 IP。想要独立 IP 可以建 macvlan 网络,再加 DHCP: “Y”,Windows 就能直接从路由器拿 IP。注意 macvlan 的限制:宿主机本身访问不了这个独立 IP。
dockur/windows 适合谁?哪些情况别用?
适合:手里有 Linux 服务器想顺手跑 Windows 软件的人;需要一台用完即删的干净 Windows 测试机的人;想在 NAS 或工控机上长期挂一台 Windows 的人。状态都收在 ./windows 一个目录里。
不适合:没有 KVM 的环境(大多数无嵌套虚拟化的 VPS、Mac 上的 Docker Desktop);对图形性能要求高的场景(虚拟机不是显卡直通,玩游戏、跑 GPU 渲染别指望);长期跑生产业务的 Windows 服务(备份、快照、自动重启要先配齐)。
法律层面 README 也写明了:项目只含开源代码,不分发 Windows,代码里的产品密钥是微软公开的通用安装密钥,不是有效激活许可,使用者要自己保证有合法许可并遵守微软授权条款。
常见问题:装到一半卡住怎么办?
先看容器日志 docker logs windows。常见情况:一直停在下载镜像,是网络慢或磁盘不够,先确认 32GB 空闲;报 KVM 不可用,回第一步重查;进度条长时间不动别急着重启,Win11 首次安装本来就要二三十分钟,日志没报错就等一等。
站长点评
我挑 dockur/windows 写这篇教程,是因为它把一件本来很重的事(装虚拟机、配 KVM、做无人值守安装)压成了一个 compose 文件。5.4 万星不是白来的:README 从版本表到 KVM 排查都写得全。我的建议是先在闲置机器上按默认配置跑通一次,确认 8006 能进桌面、RDP 能连上,再慢慢加内存、换版本。默认密码 admin 记得第一时间改掉,这事比调性能重要。
想先看项目本身的解读,可以回看站内文章:站内项目解读:dockur/windows