Windows

[![构建]][build_url] [![版本]][tag_url] [![大小]][tag_url] [![包]][pkg_url] [![拉取]][hub_url]

Docker容器中的Windows系统。

特性 ✨

• 多语言支持
• ISO下载器
• KVM加速
• 基于Web的查看器

视频 📺

使用方法 🐳

通过Docker Compose:

services:
  windows:
    image: dockurr/windows
    container_name: windows
    environment:
      VERSION: "win11"
    devices:
      - /dev/kvm
    cap_add:
      - NET_ADMIN
    ports:
      - 8006:8006
      - 3389:3389/tcp
      - 3389:3389/udp
    stop_grace_period: 2m

通过Docker CLI:

docker run -it --rm -p 8006:8006 --device=/dev/kvm --cap-add NET_ADMIN --stop-timeout 120 dockurr/windows

通过Kubernetes:

kubectl apply -f kubernetes.yml

常见问题 💬

如何使用？

非常简单！按照以下步骤操作：

• 启动容器并使用网页浏览器连接到8006端口。

• 坐下来放松一下，等待魔法发生，整个安装过程将完全自动进行。

• 一旦你看到桌面，你的Windows安装就准备就绪了。

享受你全新的机器吧，别忘了给这个仓库点个星！

如何选择Windows版本？

默认情况下，将安装Windows 11。但你可以在compose文件中添加VERSION环境变量，以指定要下载的其他Windows版本：

environment:
  VERSION: "win11"

从以下值中选择：

[!提示] 要安装ARM64版本的Windows，请使用dockur/windows-arm。

如何选择Windows语言？

默认情况下，将下载英语版本的Windows。但你可以在compose文件中添加LANGUAGE环境变量，以指定其他语言：

environment:
  LANGUAGE: "French"

你可以选择：🇦🇪 阿拉伯语、🇧🇬 保加利亚语、🇨🇳 中文、🇭🇷 克罗地亚语、🇨🇿 捷克语、🇩🇰 丹麦语、🇳🇱 荷兰语、🇬🇧 英语、🇪🇪 爱沙尼亚语、🇫🇮 芬兰语、🇫🇷 法语、🇩🇪 德语、🇬🇷 希腊语、🇮🇱 希伯来语、🇭🇺 匈牙利语、🇮🇹 意大利语、🇯🇵 日语、🇰🇷 韩语、🇱🇻 拉脱维亚语、🇱🇹 立陶宛语、🇳🇴 挪威语、🇵🇱 波兰语、🇵🇹 葡萄牙语、🇷🇴 罗马尼亚语、🇷🇺 俄语、🇷🇸 塞尔维亚语、🇸🇰 斯洛伐克语、🇸🇮 斯洛文尼亚语、🇪🇸 西班牙语、🇸🇪 瑞典语、🇹🇭 泰语、🇹🇷 土耳其语和🇺🇦 乌克兰语。

如何选择键盘布局？

如果你想使用非所选语言默认的键盘布局或区域设置，可以添加带有文化代码的KEYBOARD和REGION变量，如下所示：

environment:
  REGION: "en-US"
  KEYBOARD: "en-US"

[!注意]
在安装已经完成后更改这些值将不会生效。在这种情况下，请使用Windows内部的控制面板。

如何更改存储位置？

要更改存储位置，请在compose文件中包含以下绑定挂载：

volumes:
  - /var/win:/storage

将示例路径 /var/win 替换为你想要的存储文件夹。

如何更改磁盘大小？

要扩展默认的 64 GB 大小，在你的 compose 文件中添加 DISK_SIZE 设置并将其设置为你想要的容量:

environment:
  DISK_SIZE: "256G"

[!TIP] 这也可以用来将现有磁盘调整为更大的容量,而不会丢失任何数据。

如何与主机共享文件？

打开"文件资源管理器"并点击"网络"部分,你会看到一台名为 host.lan 的计算机。双击它会显示一个名为 Data 的文件夹,可以通过 compose 文件绑定到主机上的任何文件夹:

volumes:
  - /home/user/example:/shared

示例文件夹 /home/user/example 将作为 \\host.lan\Data 可用。

[!TIP] 你可以将此路径映射到 Windows 中的驱动器号,以便更轻松地访问。

如何安装自定义镜像？

为了下载上面列表中不可选择的不受支持的 ISO 镜像,在 VERSION 环境变量中指定该 ISO 的 URL,例如:

environment:
  VERSION: "https://example.com/win.iso"

或者,你也可以跳过下载而改用本地文件,只需在 compose 文件中这样绑定:

volumes:
  - /home/user/example.iso:/custom.iso

将示例路径 /home/user/example.iso 替换为你想要的 ISO 文件的文件名,在这种情况下 VERSION 的值将被忽略。

如何在安装后运行脚本？

要在安装后运行自己的脚本,你可以创建一个名为 install.bat 的文件,并将其放在一个文件夹中,连同它需要的任何其他文件(例如要安装的软件)。然后在 compose 文件中这样绑定该文件夹:

volumes:
  - /home/user/example:/oem

示例文件夹 /home/user/example 将在安装过程中被复制到 C:\OEM,其中的 install.bat 将在最后一步执行。

如何执行手动安装？

最好坚持使用自动安装,因为它会调整各种设置以防止在虚拟环境中运行 Windows 时出现常见问题。

但是,如果你坚持手动执行安装,请在 compose 文件中添加以下环境变量:

environment:
  MANUAL: "Y"

如何更改 CPU 或 RAM 的数量？

默认情况下,容器将被允许使用最多 2 个 CPU 核心和 4 GB 的 RAM。

如果你想调整这个,可以使用以下环境变量指定所需的数量:

environment:
  RAM_SIZE: "8G"
  CPU_CORES: "4"

如何配置用户名和密码？

默认情况下,在安装过程中会创建一个名为 Docker 的用户,密码为空。

如果你想使用不同的凭据,可以在 compose 文件中更改它们:

environment:
  USERNAME: "bill"
  PASSWORD: "gates"

如何使用 RDP 连接？

网页查看器主要用于安装过程,因为它的图像质量较低,并且没有音频或剪贴板等功能。

因此,为了获得更好的体验,你可以使用任何 Microsoft 远程桌面客户端连接到容器的 IP,使用用户名 Docker 并将密码留空。

Play Store 上有适用于 Android 的 RDP 客户端,Apple Store 中有适用于 iOS 的客户端。对于 Linux,你可以使用 FreeRDP,在 Windows 上只需在搜索框中输入 mstsc。

如何为容器分配单独的 IP 地址？

默认情况下,容器使用桥接网络,与主机共享 IP 地址。

如果你想为容器分配单独的 IP 地址,可以按如下方式创建 macvlan 网络:

docker network create -d macvlan \
    --subnet=192.168.0.0/24 \
    --gateway=192.168.0.1 \
    --ip-range=192.168.0.100/28 \
    -o parent=eth0 vlan

请确保修改这些值以匹配你的本地子网。

创建网络后,将你的 compose 文件更改如下:

services:
  windows:
    container_name: windows
    ..<省略>..
    networks:
      vlan:
        ipv4_address: 192.168.0.100

networks:
  vlan:
    external: true

这种方法的一个额外好处是你不再需要执行任何端口映射,因为默认情况下所有端口都将被暴露。

[!IMPORTANT]
由于 macvlan 的设计不允许两者之间的通信,Docker 主机将无法访问此 IP 地址。如果这是一个问题,你需要创建第二个 macvlan作为解决方法。

Windows 如何从我的路由器获取 IP 地址？

在为macvlan配置容器后,Windows 可以成为你家庭网络的一部分,通过向你的路由器请求 IP,就像真正的 PC 一样。

要启用此模式,在你的 compose 文件中添加以下行:

environment:
  DHCP: "Y"
devices:
  - /dev/vhost-net
device_cgroup_rules:
  - 'c *:* rwm'

[!NOTE]
在这种模式下,容器和 Windows 将各自拥有独立的 IP。

如何添加多个磁盘？

要创建额外的磁盘,请按如下方式修改你的 compose 文件:

environment:
  DISK2_SIZE: "32G"
  DISK3_SIZE: "64G"
volumes:
  - /home/example:/storage2
  - /mnt/data/example:/storage3

如何直通磁盘？

可以通过在 compose 文件中以这种方式添加来直接传递磁盘设备:

devices:
  - /dev/sdb:/disk1
  - /dev/sdc:/disk2

如果你想将其设为主驱动器，请使用 /disk1，使用 /disk2 及更高编号来添加次要驱动器。

如何直通 USB 设备？

要直通 USB 设备，首先通过 lsusb 命令查找其供应商和产品 ID，然后按以下方式将它们添加到你的 compose 文件中：

environment:
  ARGUMENTS: "-device usb-host,vendorid=0x1234,productid=0x1234"
devices:
  - /dev/bus/usb

[!重要] 如果该设备是 USB 磁盘驱动器，请在安装完成后再连接它。否则安装可能会失败，因为磁盘的顺序可能会重新排列。

如何验证我的系统是否支持 KVM？

要验证你的系统是否支持 KVM，运行以下命令：

sudo apt install cpu-checker
sudo kvm-ok

如果你从 kvm-ok 收到错误提示无法使用 KVM 加速，请检查：

• 虚拟化扩展（Intel VT-x 或 AMD SVM）是否在 BIOS 中启用。

• 你是否正在运行支持它们的操作系统，如 Linux 或 Windows 11（不幸的是，macOS 和 Windows 10 不支持）。

• 如果你在虚拟机内运行容器，是否启用了"嵌套虚拟化"。

• 你是否使用云服务提供商，因为大多数提供商不允许其 VPS 进行嵌套虚拟化。

如果 kvm-ok 没有报错，但容器仍然提示 /dev/kvm 缺失，可以尝试在 compose 文件中添加 privileged: true（或在 run 命令中添加 --privileged），以排除权限问题。

如何在容器中运行 macOS？

你可以使用 dockur/macos 来实现。它具有许多相同的功能，除了自动安装。

这个项目合法吗？

是的，这个项目只包含开源代码，不分发任何受版权保护的材料。代码中找到的任何产品密钥都只是 Microsoft 提供的用于试用目的的通用占位符。因此，根据所有适用法律，这个项目被认为是合法的。

星标 🌟

免责声明 ⚖️

本项目中提到的产品名称、标识、品牌和其他商标均为其各自商标持有者的财产。本项目不隶属于、不受赞助或认可于微软公司。