windows

<h1 align="center">Windows<br /> <div align="center"> <a href="https://github.com/dockur/windows"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/41c1565f-cbe7-4635-80e5-72623e6778ee.png" title="Logo" style="max-width:100%;" width="128" /></a> </div> <div align="center">

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

</div></h1>

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"

从以下值中选择：

值	版本	大小
win11	Windows 11 专业版	6.4 GB
win11e	Windows 11 企业版	5.8 GB
win10	Windows 10 专业版	5.7 GB
ltsc10	Windows 10 LTSC	4.6 GB
win10e	Windows 10 企业版	5.2 GB
win8	Windows 8.1 专业版	4.0 GB
win8e	Windows 8.1 企业版	3.7 GB
win7	Windows 7 企业版	3.0 GB
vista	Windows Vista 企业版	3.0 GB
winxp	Windows XP 专业版	0.6 GB
2022	Windows Server 2022	4.7 GB
2019	Windows Server 2019	5.3 GB
2016	Windows Server 2016	6.5 GB
2012	Windows Server 2012	4.3 GB
2008	Windows Server 2008	3.0 GB
core11	Tiny 11 核心版	2.1 GB
tiny11	Tiny 11	3.8 GB
tiny10	Tiny 10	3.6 GB

[!提示] 要安装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 提供的用于试用目的的通用占位符。因此，根据所有适用法律，这个项目被认为是合法的。

星标 🌟

免责声明 ⚖️

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