如何在 Github Codespace 上部署 Windows 7
大家好!👋
今天我要为大家介绍一个相当有趣的黑科技——如何在 Github Codespace 上部署 Windows 7 虚拟机。这个方案基于开源项目 dockurr/windows,这是一个非常棒的 Docker 容器化 Windows 虚拟机解决方案。如果你觉得这个项目有帮助,别忘了给它一个 ⭐ Star!
一. 前提条件与技术可行性的探索
💡 核心问题:GitHub Codespace 的免费额度能否满足 Windows 7 的运行需求?
众所周知,GitHub 为每个开发者(个人免费用户)每个月提供 120 小时的额度,而每一个 CPU 占用 30h 额度。这意味着一个单核机器可以运行整整一个月!GitHub 默认提供的 2 核 8GB 内存 32GB 存储的机器,从容量上讲完全足以支持一个基础的 Windows 7 虚拟机。
经过我的实践验证,这套配置完全够日常 Windows 7 使用的。无论是运行某些只支持 Windows 的老旧软件,还是进行兼容性测试,都绰绰有余。这简直是一个被长期忽视的云上宝藏!
二. 准备工作
在开始这段云上冒险之前,请确保你已准备好以下工具和资源:
- 一个 GitHub 账号(可通过 Email 注册,不需要付费)
- 一台能连接互联网的电脑
- 本篇博客
三. 开始部署
首先,新建一个仓库
为了方便演示,我建议使用 Public 公开仓库(这样后续如果想分享给朋友也很方便)。

操作步骤:
- 进入 GitHub 首页
- 单击右上方 ”+” 号旁边的向下小三角
- 选择 New repository

填写仓库信息:
- Repository name(仓库名称):随意填写(例如
RDP7u、windows-codespace等) - Description:可选,简单描述一下这个项目(例如 “Windows 7 on Codespace”)

最后一步:
- Choose visibility(可见性):选择
Public或Private(根据需要) - 单击绿色的 “Create repository” 按钮完成创建
恭喜!你已经有了一个新的仓库。现在是时候在里面放入”灵魂”——docker-compose 配置文件。
其次,向仓库内添加必要的文件
这一步是整个过程的核心。我们需要创建一个 docker-compose.yml 文件,它就像一份”施工蓝图”,告诉 Codespace 如何构建和运行我们的 Windows 7 虚拟机。

操作步骤:
- 在仓库主页,单击 “Add file” 按钮(靠近页面右侧)
- 在下拉菜单中选择 “Create new file”

创建配置文件:
- 在仓库名旁的输入框中输入文件名:
docker-compose.yml(注意小写和连字符) - 在下方的编辑区域粘贴以下配置代码:
services: windows: image: dockurr/windows container_name: windows environment: VERSION: "7u" # 指定 Windows 7 Ultimate # 性能调优参数 RAM_SIZE: "4G" # 分配给虚拟机的内存(须小于机型总内存) CPU_CORES: "2" # 分配的 CPU 核心数 DISK_SIZE: "28G" # 虚拟硬盘初始容量(后续可在磁盘管理中扩展) USERNAME: "yang" # 虚拟机用户名 PASSWORD: "yangyouzi1234" # 虚拟机密码
devices: - /dev/kvm - /dev/net/tun cap_add: - NET_ADMIN ports: - 8006:8006 # VNC 端口映射 volumes: - ./windows-data:/storage # 核心数据持久化目录 - /workspaces/241331302:/shared # 宿主机与虚拟机的共享文件夹 restart: always stop_grace_period: 2m关键配置解析:
image: dockurr/windows- 使用官方的 dockurr/windows 镜像(必须)RAM_SIZE: "4G"- 4GB 内存已足够 Windows 7 的日常使用CPU_CORES: "2"- 2 核 CPU 是 Codespace 标准配置DISK_SIZE: "28G"- 留足磁盘空间,但不超过总容量ports- 将 RDP 服务端口暴露给外界volumes- 确保虚拟机数据在容器停止后不会丢失

最后,提交这个配置文件:
- 确认代码无误后,单击右上角绿色的 “Commit changes…” 按钮
- 添加一个简短的提交描述(例如 “Initial docker-compose configuration”)
- 再 “commit changes” 确认提交
四. 创建 Codespace 并选择合适的配置
①提交好文件后,我们在浏览器地址栏键入 https://github.com/codespaces 并访问。

等待加载好后选择绿色按钮 New codespace 进入到新的界面

②根据自己的需求选择机器类型。由于本人身处中国,故我选离自己家最近或者线路最优的 US West ,这样可以降低延迟,提升流畅度。分支(Branch)没啥可选的,机器类型默认足矣。

最后单击右下方绿色的 Create codespace 按钮
(等待加载完成)
载入后,我们在左边的文件显示区域,找到 yml 文件,进入后还可以根据需求修改。这时我们可以安装来自 Microsoft 的 “Container Tools” 扩展,以实现更简单地对 Docker 容器进行开机、关机、控制。
五. 使用该虚拟机
0. 更新 Codespace 环境
(这一步可以不做,因为在我做的时候,GitHub给的都是最新的资源)
输入
sudo apt update && upgrade以用来更新环境
1. 构建并启动该虚拟机
在终端输入 docker compose up -d 命令来构建。若没有终端,请单击右上角三条横线,二级菜单选择终端,再选择新建终端
等待这个命令行跑完
跑完以后,它会提示我们在8006有一个端口,点进去,会显示Downloading Windows 7 (???%) 。这是我们什么都不用管,等待他跑完即可(全自动进入桌面哦)
由于我们已经安装了 来自 Microsoft 的 “Container Tools” 扩展 ,我们可以在这个插件里面,右键单击dockurr/windows,选择start/stop进行开关及操作,这比在命令行里输入简单了不少。
2. 配置 Windows 7
大概等上10分钟,不出意外的话他是可以自己装好系统的。由于Windows 7 SP1发布时期古早,最后的安全更新也已经在2020年停止了。我们想要正常使用,就得打一些补丁。当然,这取决于你想用的软件。我们这里推荐 Windows 7能用的浏览器supermium 。
使用 Win7语言包(繁体,英文,韩文,日文等多国语言包大全)|Windows7旗舰版语言包下载 - wu.g.q - 博客园 下载 简体中文版语言包
- 安装 .NET Framework 4.7.2 或 4.8
- 安装微软常用运行库合集(包含 Visual C++ 2005 到 2022)
我们可以通过UU远程进行文件互传。由于我们配置了shared文件夹,我们可以在项目根目录(/workspaces/你的用户名)通过wget下载,或者直接将.exe的安装包拖拽到vs code网页端左侧资源管理器内
🔗 参考资源
- dockurr/windows - GitHub - 本教程所依赖的开源项目,推荐 Star ⭐
- CNBlogs - Win7语言包 - 更多技术交流
- supermium - 提供较新的能在win7上运行的chromium内核浏览器
- Gemini - 可用于提问和故障排查
- Claude Haiku 4.5 - 用于git命令修复与写作思路指导
文章修订历史 (1 次提交)
添加第三篇文章的图片资源和备忘录