用途:在 Docker 中通过 dockur/windows 管理一台无界面(headless)Windows 11 虚拟机,使用 KVM 加速,仅通过 SSH 访问,无需 RDP 或图形界面。
主要能力:提供 create(首次安装或完全重建)、start、stop、restart、status、ssh、screenshot 等操作。容器名 windows11,VM 目录 /home/jesse/windows-vm/,含 storage(磁盘镜像,重建时被清空)、iso/win11x64.iso(缓存的 Windows ISO,7.3GB,重建后保留)、oem/install.bat(安装后脚本,安装 OpenSSH Server)。凭据 user / password;SSH 为 localhost:2222,RDP 为 localhost:3389,Web 控制台为 localhost:8006,均仅绑定 127.0.0.1;资源为 8GB 内存、4 核 CPU、64GB 磁盘。
使用方式:宿主机需 Docker、KVM(/dev/kvm 存在)、sshpass,可选 imagemagick 用于截图调试。创建时先建目录并准备 oem/install.bat,重建需先 docker stop windows11 && docker rm windows11 并删除 storage/data.img。有缓存 ISO 时用 docker run 挂载 /boot.iso;首次无 ISO 时省略该挂载并加 -e VERSION="win11"。必须加 --cap-add NET_ADMIN 与 --device /dev/kvm。ISO 下载并启动后应立即复制到 iso/ 目录。全新安装约 20-30 分钟,可用 docker logs -f windows11 或 http://localhost:8006 监控。SSH 就绪后可通过 stdin 管道执行 PowerShell 脚本安装 Node.js 与 Claude Code,并配置系统 PATH、执行策略与 PowerShell 配置文件。
限制与注意:端口仅本机可访问,跨机需 Tailscale SSH 隧道;挂载 /boot.iso 时不要再用 VERSION;Node.js 非预装,npm 全局 bin 需加入系统 PATH 并重启 sshd;执行策略需设为 RemoteSigned(LocalMachine);SSH 下嵌套引号不可靠,建议用 stdin 管道;winget 可能因证书失败;重建后主机密钥变化,需 ssh-keygen -R '[localhost]:2222'。