导入镜像、连接Linux与携带作业

课前准备

主机采用Windows 10/11 x86-64，内存至少16GB，开启CPU虚拟化，本地磁盘预留25GB可用空间。按机房规定使用VMware Workstation或VirtualBox，下载对应平台和本周实验的一份镜像。

镜像配置为4个虚拟CPU、6GB内存、40GB动态磁盘。40GB是磁盘增长上限；下载包大小和SHA-256记录在发布清单中。携带介质推荐32GB exFAT U盘，支持超过4GB的单个磁盘文件。

导入与登录

VMware：解压完整目录，打开.vmx。首次询问选择“已复制”，生成新的虚拟机标识，网络采用NAT。
VirtualBox：导入.ova，确认6GB内存、4个CPU和NAT网络。在“高级→端口转发”增加TCP规则：主机IP 127.0.0.1、主机端口22220、客体端口22，客体IP留空。
同一主机运行一份课程虚拟机；更换镜像前关闭当前虚拟机，释放内存和转发端口。
用户名为student，密码留空。控制台出现密码提示时直接回车，SSH可直接执行命令。

空密码账号用于本机NAT教学环境。VirtualBox转发地址保持127.0.0.1，SSH的root登录关闭。

登录后执行：

whoami
hostname -I
labctl doctor
cat /opt/course/checkpoint.json

whoami应输出student。记录hostname -I显示的客体IP，以及checkpoint中的实验编号。

Windows连接

在PowerShell执行ssh -V，检查OpenSSH客户端。缺少客户端时由机房管理员通过Windows可选功能安装。

VMware采用虚拟机控制台显示的实际NAT地址：

ssh [email protected]

VirtualBox采用本机端口转发：

ssh -p 22220 [email protected]

首次连接核对主机指纹并输入yes，随后直接进入Linux。用以下命令验证AI所需的非交互连接：

# VMware：替换为实际客体IP
ssh -o BatchMode=yes [email protected] 'whoami; hostname'
# VirtualBox
ssh -o BatchMode=yes -p 22220 [email protected] 'whoami; hostname'

预期输出用户student及虚拟机主机名，过程无需输入密码或配置密钥。连接目标是自己的虚拟机；课程构建服务器由教师管理。

学生资料包的windows/Connect-Lab.ps1可创建独立连接配置：

# VMware：替换IP
.\Connect-Lab.ps1 -HostAddress 192.168.80.128
# VirtualBox
.\Connect-Lab.ps1 -HostAddress 127.0.0.1 -Port 22220

脚本显示ssh -F ... dc-lab命令，并建立三个网页隧道：

服务	Windows浏览器地址	Linux服务端口
HDFS	http://127.0.0.1:19870	9870
YARN	http://127.0.0.1:18088	8088
实训页面	http://127.0.0.1:18501	8501

保持SSH窗口开启，并启动对应服务后访问页面。配置使用accept-new记录首次主机指纹；更换checkpoint后，先核对新虚拟机，再清理该地址的旧记录：

# VMware示例
ssh-keygen -R 192.168.80.128
# VirtualBox示例
ssh-keygen -R '[127.0.0.1]:22220'

WorkBuddy

在Windows上从官方渠道安装并登录WorkBuddy，验证本机终端命令执行能力。把已验证的SSH命令、实验工作目录和指导书路径交给它：

Windows运行WorkBuddy。通过ssh -o BatchMode=yes student@虚拟机IP '命令'操作Linux，student为空密码账号。先执行whoami、hostname、python3 --version确认环境，再读取/opt/course/handbook/lab01.md，逐步协助我完成实验。每次运行后核对实际输出。

VirtualBox将连接部分换成ssh -o BatchMode=yes -p 22220 [email protected]。WorkBuddy使用学生账号和当前实验目录。客户端登录、额度、SSH执行能力在课前机房试用；手动操作采用相同命令。

打开本次指导书与报告模板

从课程网页下载最新版学生资料包并解压。在Windows用Microsoft Word打开starter/reports/中本次实验的模板，填写姓名、学号、班级。

镜像已包含配套指导书与模板，导入后即可开始实验。网页和学生资料包提供当前发布的材料；教师直接替换发布文件，学生统一下载最新版。

阅读每步记录、截图与最终提交。各步骤标明对应Word栏目、粘贴内容和图号。截图直接插入模板；源码、结果和文本日志在Linux工作目录用于运行与核对。

保存和换checkpoint

保存Linux源码、日志和结果，在Windows Word中完成对应报告并按规定命名。
按Word提交方法核对截图、结果、源码和AI使用情况报告，提交一份.docx并备份到U盘。流恢复演示保留原虚拟机及checkpoint。
执行labctl stop和sudo poweroff，确认虚拟机完全关机。
将完整VM目录复制到U盘。禁止在运行或挂起时复制单个磁盘文件。
将作业单独备份，再导入下一份checkpoint。各镜像独立启动，可分别保存或更换。

运行时将虚拟机放在电脑本地磁盘，利用本地磁盘的随机读写性能；U盘负责携带关机后的副本。

无法启动时

依次检查虚拟化软件报错、主机剩余内存、磁盘空间和CPU虚拟化状态。Hyper-V/VBS兼容设置由机房管理员统一处理。报障时提供软件版本、报错原文和镜像校验值。