BSCX教学 · 维护 · 一体化下载体验 ↗
TECHNICAL REFERENCE

完整使用手册

本手册包含两版本的技术说明；本站销售机房版，班班通专属功能不包含在机房版中。

BSCX 终端集中管控平台用户说明书

更新日期：2026 年 10 月 21 日
适用版本：BSCX 4.3。 普通机房版服务端 server.exe、客户端 client.exe；班班通版服务端 server.exe、客户端 client.exe。
版本区别： 班班通版增加网页管控、教师操作授权、手机麦克风、单设备视频和录像功能；两版均支持外置答题卡考试模块。 重要提示： 本软件同时包含课堂控制、远程执行、PXE、VHD、磁盘同传和驱动安装功能。开始批量操作前，必须先在一台测试机验证；任何涉及磁盘、启动项、关机和自定义命令的操作都应有可回滚方案。

本文面向学校机房、班班通教室、工厂 SOP 看板和集中运维场景，说明部署条件、命令格式、参数、限制和故障处理。日常课堂优先使用服务端按钮；命令输入适合批量控制、定时任务、自动发布和维护场景。

快速查阅：日常课堂操作见第三至九章；班班通课件共享见第十章，网页账户和教师权限见第二十四章；制卷、考试、阅卷、结果下发及举手、点名、课堂答题见第二十五章；PXE 兼容设置见第十四章；在线/PE 离线转 VHDX 和离线 Windows 优化见第二十六章；无盘本地化、整盘克隆及 PE 的 iSCSI 分区复制见第二十七章。

4.3 近期操作速查：

想完成的事情 阅读位置
同网段多机房分别管理，保持机名和 IP 登记稳定 第三章“只管本班”及“自动恢复名称和 IP”
列表或画面监控多选、连续选、全选 第三章“选择目标”及第八章“画面监控”
从分类示例找命令、查看参数提示和最近使用 第五章
广播对象重启后自动继续接收，发文件到当前用户桌面 第八章、第十章
临时校时、在线调整 PXE 设置 第十四章
实名签到、个人盘、考试、课堂答题及教学记录归档 第九章、第二十五章
签到后教师端意外退出，恢复本节课 第二十五章“教师端重启后恢复签到”
在没有 PowerShell 的 PE 中把离线 Windows 制作为 VHDX 第二十六章第 4 节

一、软件组成

程序或目录 作用
普通机房版服务端 server.exe 在教师机、管理机或工厂发布机运行，负责发现客户端、发送命令、屏幕演示、签到、文件分发、SOP 发布、PXE/VHD 维护等。
普通机房版客户端 client.exe 在学生机或工位电脑运行，上线后自动出现在服务端列表中。
班班通版服务端 server.exe 在管理机或学校服务器运行，除普通机房版功能外提供网页管控。
班班通版客户端 client.exe 安装在班班通大屏一体机上，接受桌面控制台和网页命令。
config.ini 服务端配置文件，保存网络参数、共享账号、屏幕广播参数、命令历史、SOP 公司名称等。
share 服务端共享目录，存放客户端、任务表、铃声、音频、视频、壁纸、SOP 文件、签到记录和维护文件。
share\tasks.csv 定时公告、铃声、音频、视频、命令任务表。
share\bell 铃声文件目录。
share\audio 后台音频文件目录。
share\video 全屏视频文件目录。
share\sop SOP 源文件目录，默认存放 PDF、Office、图片、视频等源文件。
share\sop_view 生成后的 SOP 静态展示网页目录。
share\sop_render Office 转 PDF、外部源文件复制等中间文件目录。
exam 文件夹 答题卡考试、制卷与阅卷所需的配套文件。请将完整文件夹放在服务端同级目录，两版通用。
.paper、.exam 制作好的试卷和按收卷时间保存的考试记录，默认保存在服务端同级目录，也可选择其他目录。
web_control.db 班班通网页账户、设备授权等数据。迁移网页管理时应保留此文件。
C转VHD.cmd 及其配套文件 当前 Windows 热克隆到 VHDX、单独优化离线 Windows，或在无 PowerShell 的 PE 中离线转 VHDX。
VHD_NIC_DRIVERS 待注入的网卡驱动目录；网卡驱动需解压为 INF、SYS 等完整文件。
ffplay.exe 客户端播放铃声、音频、视频和屏幕演示所需的支持文件。
share\ffmpeg.exe 服务端屏幕演示所需的支持文件。
share\uftp.exe / uftpd.exe 文件分发所需的配套工具，请保留软件包中的完整文件和目录。
share\tvnviewer.exe 服务端双击/右键远程查看客户端时使用，直接从 share 调用。
diskflt.sys / .inf / .cat HDiskflt 系统保护驱动及安装文件；签名、Secure Boot 和 Windows 版本必须匹配。
tightvnc.exe 可选的 VNC 自动安装包，放在客户端同级目录；安装、更新或执行 inject 时，仅在安装目录没有此文件的情况下复制并安排安装。
ipxe.efi 可选的 UEFI 网络启动文件，放在客户端同级目录；安装或注入时一并复制，用于本地 VHD 菜单的一次性网络启动。
rclone.exe 旧系统连接个人磁盘的可选备用组件，需要时手工放置，不再随客户端自动复制。
udp-sender.exe / udp-receiver.exe WinPE 下 SYS 硬盘分区同传所需文件，放在客户端同级目录。
wimlib-imagex.exe / libwim-15.dll PE 下 SYS 同传所需文件，放在 PE 中客户端同级目录；普通 Windows 安装不需要。

建议服务端和客户端都使用管理员权限运行，并允许软件在学校内网通信。SOP 中的 Office 文件转 PDF 功能建议在服务端安装 LibreOffice。

二、版本和运行边界

项目 普通机房版 班班通版
服务端/客户端 普通机房版服务端/客户端 班班通版服务端/客户端
Web 管控 无 有，受 web_enabled 控制，默认关闭
网页屏幕、摄像头、麦克风 无 有；可查看单台设备屏幕或摄像头，并使用手机麦克风对讲
桌面控制台、广播、文件分发、PXE、VHD、分区同传、共享、SOP 有 与普通机房版保持一致
EXAM 答题卡考试、自动评分、人工阅卷和统计 有，需部署外置考试模块 有，使用同一考试模块
适用场景 同一内网机房集中教学和维护 班班通、移动端网页控制及单教室远程协作

两版都建议只在学校内网使用。班班通版网页应通过校园内网或 VPN 访问；公网使用必须由管理员配置 HTTPS、防火墙和安全访问入口。

三、日常启动流程

  1. 在教师机以管理员身份运行教师端。
  2. 确认教师机和学生机在同一管理网段，交换机没有拦截广播通信。
  3. 等待学生机出现在“目标客户机”列表中。
  4. 需要控制部分学生机时，先在列表中选中目标；没有选中时按当前管理范围发送。开启“只管本班”仅针对本班；关闭时普通命令可全网广播，执行前确认范围。
  5. 常用功能优先点按钮：清理窗口、屏幕演示、全体肃静、广播键鼠、冻结/解冻、PXE网启、个人磁盘等。
  6. 需要精确操作时，在“远程命令”输入框输入命令并发送。

右侧页签顺序为 MAIN → EXAM → SOP → VHD/SMB。EXAM 用于组织考试，VHD/SMB 用于镜像和共享维护。需要查看更长的考试状态或设备信息时可最大化。

同网段多个机房：只管本班

本班按客户机的 MAC 地址登记。一个班可以包含 A组、B组、C组等不同名称，两个班也可以使用相同前缀。下方“前缀”下拉框只用于快速选中客户机，不决定归属。

  1. 管理员解锁维护权限，在客户机列表选中一台或多台，右键选择“加入本班”。该菜单位于“删除选中”下面。
  2. 在“只选在线”后面勾选“只管本班”。列表和自动管控立即限制为本班，下一次启动继续沿用。
  3. 调整名单时，选择客户机后右键“移出本班”。若要加入当前列表以外的新机器，先由管理员取消“只管本班”，确认目标后加入，再重新勾选。

加入、移出和开关“只管本班”都需要维护权限。传输、广播或考试进行中应先结束任务再改变范围。删除本班成员的登记行也会移出本班，因此同样需要维护权限。

开关及 MAC 清单由界面保存到本服务端的 config.ini（class_only、class_macs）。客户机名称、IP 等仍保存在 clients.json。每个机房使用自己的本班清单，不要把同一台客户机同时加入两个日常管理服务端，也不要把本班配置原样复制给另一机房。

点击改名与保存名单： 各服务端收到有效点击改名通知后，仍按 MAC 保存新名称和目标 IP，无须本机曾发起改名；这不会自动加入或移出本班。Ctrl+S 在“只管本班”开启时只更新本班信息、保留其他登记；关闭时保存全部。

登记信息保持稳定： clients.json 中的名称和 IP 只在首次登记新 MAC、收到有效点击改名通知、或管理员主动 Ctrl+S 时更新。已有 MAC 进入 PE 不用 PE 名称和临时 IP 覆盖原登记；新 MAC 不论首次在 PE 还是普通系统上线，均会登记。禁用外网等日常操作只更新对应设备的状态字段，删除设备只移除对应 MAC，不把全列表的临时上报信息重新保存。界面显示的当前 IP 可以变化，保存的身份信息保持稳定。

客户端联系哪个服务端： 预设地址、最先发现的服务端及最新实际命令来源的切换规则保持不变；仅收到其他服务端的在线通知并回复信息，不等于接受其管理。预设地址可用 inject_serverip=192.168.11.1 设置，或用 inject_serverip=auto 清除。

广播选定键鼠： 开启“只管本班”时仅通知本班接收；关闭时保留全网维护方式。IP 错乱时，管理员可取消本班限制、不选择客户机，发送 dhcp 或使用广播改名、广播键鼠。广播仍受网卡、交换机、防火墙及 VLAN 限制。

自动恢复名称和 IP： 开启“只管本班”时，服务端只纠正本班设备；保存名单不会用错误上报名覆盖已登记名。

客户机环境 开机恢复与自动纠正规则
本地 VHD 优先恢复引导菜单中对应父本保存的计算机名和 IP；名称已正确时也恢复网络配置。有对应配置时，服务端不覆盖它。没有对应配置且名称与服务端登记不同时，按登记名称、IP 及服务端网络参数纠正，并保存到本机菜单。
普通本地 Windows 名称与服务端按 MAC 登记的名称不同时，同时纠正名称和 IP；没有有效登记 IP 时只改名。
无盘 Windows 名称不一致时只改名，保持当前 DHCP 网络连接。
PE 如果本地 A 盘已有 VHD 引导菜单，按默认系统配置恢复 IP，取原名称末尾数字组成 PE 名称，例如 RoomA030 变为 PE030。一次性进入 PE 时沿用此前默认系统的配置。服务端不自动纠正 PE 环境或名称以 PE 开头的客户机。

服务端只在名称需要纠正时联动修正 IP；名称正确、仅 IP 改变时，不主动改 IP，也不以当前 IP 覆盖登记。客户端从本地 VHD 菜单恢复网络配置是独立流程。多台克隆机重名甚至静态 IP 相同的情况下，服务端可用按 MAC 匹配的广播纠正，目标地址优先沿用该 MAC 已登记的地址；仍需保证网络允许广播。自动纠正不会先向整个网段发送 DHCP 命令。需要统一改为 DHCP 时，由维护人员主动发送 dhcp。这套优先级需要服务端和客户端同时更新。

多机房日常使用时，各服务端都应勾选“只管本班”，清单不要重叠。这个设置用于限制操作范围，不是安全隔离；未勾选的服务端仍可进行全网维护。心跳格式及默认端口不变，无需为各班制作不同 PE。PXE/DHCP、iSCSI 服务仍需统一规划，PXE 自动避让继续生效。

选择目标：列表和画面监控共用

下方“前缀”组合框用于快速选择相同前缀的设备，包含当前管理范围内的在线、离线记录、PE 和预设前缀，不包含临时 PXE 固件名称。它不替代按 MAC 登记的“只管本班”。

四、教师端常用按钮

按钮 作用 使用建议
发送命令 发送输入框中的远程命令 未选中时遵循当前管理范围；“只管本班”关闭时普通命令可全网广播。
清理窗口 关闭学生机上的普通窗口；取消仍在倒计时的部署操作 适合上课前恢复桌面秩序，也可用于批量取消待执行的分区、克隆或同名父本替换。
屏幕演示 开始或停止教师机屏幕广播 可配合声音广播设置使用。
语音广播 只广播教师机声音，学生端不显示播放窗口 可与屏幕演示同时开启、分别停止；黑屏锁定不中断声音。
画面监控 在目标列表区域切换多机画面预览 66 台以内全体同屏，超过 66 台时均衡分页并每 10 秒轮巡。
全体肃静 一键黑屏锁定或解除全体学生机 黑屏界面会显示圆盘指针时钟、数字时间和日期星期。
广播选定键鼠 让一台学生机的键盘鼠标广播给其他学生机 必须只选中一台来源学生机。来源机可用 Alt + Q 停止。
广播改名 弹出学生机点名编号界面 用于批量改计算机名、改 IP。
解冻系统 让学生机进入保留更改状态 维护、安装软件前使用。
冻结系统 让学生机进入还原保护状态 维护完成后使用。
PXE网启 开启或关闭教师端 PXE/iPXE 服务 配合 pxe 命令让学生机下次网启。
个人磁盘 开启或关闭个人磁盘服务 签到、公告任务、壁纸等会按需自动启用。

列表中右键学生机可使用 VNC 连接、发送命令、开机唤醒、关闭外网、黑屏锁定、重启、关机等快捷操作。

五、命令发送规则

命令只输入命令本身，不需要手动加 command, 前缀。

场景 示例
锁定学生机屏幕 screen_lock
解除锁定 screen_unlock
签到七年级1班 checkin_七年级1班
同步定时任务表 notice_tasks.csv
打开网页 https://www.baidu.com
重启学生机 reboot

命令列表分为三类，选中后仍可修改参数再发送：

分类 内容
最近使用 最近实际成功发起发送的 80 条不同命令；重复使用会移到最近位置，内置示例不会自动占位。记录的是发送操作，不代表每台客户机都已执行成功。
教学日常 签到、重启/关机、课堂控制、通知、个人共享和校时等常用示例，始终保留。
系统维护 VHD、PXE、注入和磁盘维护等示例；受维护权限限制的操作仍须验证权限。

鼠标停留在内置示例上显示简短作用，提示中红色下划线标出可按实际情况修改的部分；命令本身不加中文前缀。例如 checkin_七年级1班 开始该班签到；vhd_keep_win10_new 为 win10 建立新节点且保留启动；vhd_restore_win10_new 建立新节点且还原启动；vhd_merge_win10 固化最近修改的 win10 节点为最新更新节点。new 用于新建版本，不会自动把当前尚未合并的修改带入新版本；VHD 命令的执行环境和限制见第十六章。

六、课堂控制命令

命令 作用 注意事项
cleanup 清理学生机普通窗口 不会主动关闭系统关键进程。
screen_lock 黑屏锁定学生机 适合讲解、考试、纪律管理。
screen_unlock 解除黑屏锁定 如正在屏幕演示，演示状态仍由演示按钮控制。
internet_disable 关闭外网访问 教师端会记住目标状态，学生机重新上线后会同步。
internet_undisable 恢复外网访问 恢复后可能需要几秒钟生效。
usb_disable 禁用 U 盘存储 不影响普通键盘鼠标。
usb_enable 恢复 U 盘存储 已插入的 U 盘可能需要重新插拔。
pc_id 显示或隐藏学生机编号 已签到时会显示学生姓名。
label_toggle pc_id 的兼容别名 与 pc_id 相同。
dhcp 让学生机改为自动获取 IP 改网络期间会短暂离线。
pxe / ipxe 设置学生机下次从网络启动 一般先开启“PXE网启”；本地 VHD 使用菜单中的 iPXE 项。
inject 安装/更新客户端，或按当前状态清理注入配置 需要管理员权限；详见“安装、升级和客户端退出”。
diskflt_install 安装 HDiskflt 磁盘过滤驱动 可能开启测试签名并重启；不要在 Secure Boot 生产机直接执行。
diskflt_uninstall 卸载 HDiskflt 驱动 需先解除冻结并按提示重启。
freeze 启用系统保护 PE、无盘和 VHD 系统走各自保护逻辑。
thaw 解除系统保护 维护安装前使用；通常需要重启生效。
stop_uftpd 停止客户端 UFTP 接收服务 正在接收文件时使用；不会撤销已写入文件。
stop_input_receive 停止接收广播键鼠 不影响普通本地键鼠。
stop_kms_from_client 停止本机键鼠广播 stop_kms 的兼容别名。
close 正常退出学生端 会按正常流程退出守护，便于升级或维护。
reboot 立即重启学生机 发送前确认学生没有未保存内容。
shutdown 立即关闭学生机 发送前确认课堂状态。

七、黑屏锁定和考试时钟

发送 screen_lock 或点击“全体肃静”后，学生机会进入全屏黑色锁定界面。当前版本会显示：

  1. 圆盘指针时钟。
  2. 数字时间，格式为 HH:MM:SS。
  3. 日期和星期。
  4. 提示文字：正常课堂锁定显示“请大家保持安静！”，断网锁定会显示网络检查提示。

这个界面适合班班通、考试或自习场景，当投影画面需要一个统一时间时也可使用。解除锁定发送 screen_unlock，或再次使用“全体肃静”按钮切换。

断网锁屏与离线启动： 客户端每次启动时重新判断联网状态，不保存上一次运行的断网锁定。启动时网线未插、网卡禁用或没有可用网卡，不会仅因断网自动黑屏，便于在本机恢复网络；这与系统是否冻结无关。只有本次运行已检测到有效网络连接，随后连接断开时，才触发断网锁屏，恢复连接后解除。网卡信息读取失败按未知状态处理，不会把它误当作“曾经联网”。教师主动发送的黑屏命令独立生效；断网锁屏可通过 inject_netlock=0 关闭。

八、屏幕演示、语音和键鼠广播

屏幕演示建议直接使用“屏幕演示”按钮。教师端会启动屏幕采集并通知学生端接收。

重启后继续接收： 开始时若选中部分设备，所选设备即使当时离线，也会在上线或重启重连后自动接收，只要教师端屏幕演示仍在继续。开始时未选中设备，表示面向当前管理范围全体，后来开机的设备也会加入；开启“只管本班”时仅限本班。客户机名前的屏幕图示表示它属于本次接收范围，不等于已经逐台确认画面正常。停止屏幕演示后清除本次接收安排。

语音广播： 点“屏幕演示”右侧的“语音广播”，学生端在后台播放声音，不锁屏、不抢焦点。屏幕和语音可同时开启，分别按各自开始时的选择确定接收对象，未选择时面向当前管理范围全体；两者分别支持重启上线恢复。客户机名前的“📺”“🔊”表示对应接收范围，两项可同时显示。再次点“停止语音”只停止声音广播；停止屏幕演示也不会停止独立语音。需要学生暂停操作时，可另发 screen_lock，黑屏和解除黑屏都不会中断声音。

同时接收屏幕和语音时，独立语音优先播放，屏幕流中的声音暂时静音，避免叠音；停止语音后恢复屏幕原有声音。切换这一路声音时，画面接收可能短暂重连，不解除屏幕锁定。

语音广播复用下方声音模式：1 为系统声音，2 为麦克风，3 为两者混音；当配置为 0 时，语音广播按 3 处理，但不修改配置，屏幕演示仍保持无声音。需要教师机存在相应采集设备；全部不可用时会提示并拒绝启动。此功能需要配套更新服务端和客户端。

命令 作用 建议
start_demonstrate,地址 开始接收教师端屏幕演示 通常由按钮自动发送。
stop_demonstrate 停止屏幕演示 通常由按钮自动发送。
start_voice,地址 在后台接收教师端语音广播 通常由语音广播按钮自动发送。
stop_voice 只停止独立语音广播 屏幕演示继续；stop_demonstrate 只停止屏幕演示。
start_kms 让选中的学生机开始键鼠广播 通常由“广播选定键鼠”按钮发送。
stop_kms 停止键鼠广播 通常由按钮发送。
stop_input_receive 停止接收广播键鼠 维护时使用。

声音广播由 config.ini 的 [Settings] 中 screen_audio_mode 控制：

值 含义
0 不广播声音。
1 广播教师机系统声音。
2 广播麦克风声音。
3 系统声音和麦克风混音。

系统声音依赖 Windows 中可用的声音采集设备。若没有声音，请先在系统声音设置中启用“立体声混音”或管理员指定的虚拟音频设备，再在 config.ini 中选择相应的声音模式。

快速使用语音： 先选目标（不选即当前管理范围全体），选择系统声、麦克风或混音，再点“语音广播”。播放课件时可选系统声，老师讲解时可选麦克风，两者都要选混音；需要时可以在屏幕演示过程中随时开启语音。软件不会自动启用或更改 Windows 的录音设备；手工启用混音后仍没有声音时，先确认录音设备有电平、没有静音，必要时更新 ffmpeg.exe 后重新启动广播。

若教师机使用 Intel QSV 时出现编码报错或影响系统稳定，可在 config.ini 的 [Settings] 中设置 screen_force_software = 1，重启服务端后屏幕广播会直接使用 CPU 的 libx264 编码，并跳过硬件编码探测。软件编码会增加教师机 CPU 占用；设为 0 或删除该项可恢复自动选择。此项只控制画面编码，不会修复缺少系统声音采集源的问题。

画面监控和自动轮巡

点击目标客户机列表区域的“画面监控”按钮后，服务端会把列表切换为多机画面预览，并根据客户机数量和窗口大小自动排列；窗体放大后，各客户机画面也会随可用区域放大。

画面监控适合巡查学生机当前状态，不用于替代屏幕演示或远程控制。单击某个预览块会同步选中对应客户机，双击预览块会打开或关闭该机器的 VNC 监控窗口，右键可使用原有客户机菜单。

支持 Ctrl 多选、Shift 连续多选、Ctrl+Shift 追加区间和 Ctrl+A 全选，与客户机列表共用选择结果。连续范围按当前列表排序计算；右键命令作用于选中的多台设备，分页轮巡不会把范围缩成当前一页。

客户机总数不超过 66 台时会在一屏内显示全部客户机，并按台数自动调整刷新间隔：1 至 10 台约 1 秒、11 至 20 台约 1.5 秒、21 至 36 台约 1.8 秒、37 至 50 台约 2.2 秒、51 至 66 台约 2.5 秒。超过 66 台时，服务端按每页不超过 66 台计算最少页数，并把客户机尽量平均分配到各页，例如 80 台分为两页、每页 40 台；多页时每 10 秒自动轮巡，也可以用“上页”“下页”手动切换，刷新间隔约 1.8 至 2.2 秒。屏幕演示正在进行时，预览刷新会自动放慢，避免和演示流量互相抢占网络。

监看标签在收到签到信息后优先显示“计算机名 签到名”。密集页面宽度不足时会去掉计算机名前缀，至少保留顺序号和签到名；黑屏、禁网图标以及红色未冻结提示仍会保留。

画面监控要求客户端处于可用的 Windows 桌面会话，并允许服务端访问屏幕查看功能。如果某台机器显示“连接失败”或“超时”，先检查客户端是否在线、系统防火墙和安全软件是否允许屏幕查看，再检查该机是否有人登录桌面。

九、签到和个人磁盘 H: 盘

发送 checkin_班级名 会在学生机弹出签到窗口。学生需要输入姓名，并可反馈设备异常情况。签到记录会保存到教师端：

share\班级名\班级名_年月日_小时.csv

签到时教师端会按需开启个人磁盘服务，并为学生创建个人目录：

share\班级名\学生姓名

学生提交签到后，客户端会尝试把自己的个人目录映射为 H: 盘，并把资源管理器中的卷标设置为学生姓名。

服务端发送 checkin_班级名 后，按本节课的签到安排通知后来上线的设备。已完成同班签到的客户端短暂断网或重启后，服务端会按记录恢复姓名和个人磁盘；未签到设备继续收到签到窗口，同一设备不重复弹窗。同一学生换机签到后以最后一台为准。教师可选中目标设备重新发起签到，要求它重新确认身份。考试登记和历史成绩分发优先使用当前签到姓名。名单校验、临时班归档和教师端重启后的恢复规则见第二十五章。

注意事项：

  1. 签到倒计时默认 5 分钟，超时未提交的学生机会进入关机倒计时。
  2. 学生姓名不要包含路径特殊字符，建议使用真实姓名。
  3. 旧系统需要备用连接方式时，可由管理员手工配置 rclone.exe；客户端不再自动复制它。另需先确认 H: 未被其它程序占用。
  4. 个人磁盘账号密码在服务端 config.ini 的 [Settings] 中设置：webdav_user、webdav_password。留空时使用默认值。

十、SMB 共享、文件分发和壁纸

1. SMB 教学资源共享

SMB 共享主要面向班班通场景：老师不用带 U 盘，也能在办公室电脑上把课件、教学资料复制到对应班班通电脑的 Z: 盘。推荐的使用方式是：

教师办公室电脑 -> SMB 共享服务器/教师机 share 目录 -> 班班通电脑 Z: 盘

如果教师端运行在 Windows Server 或长期在线的管理机上，可以直接在本机 share 目录下为每一台班班通电脑创建同名共享文件夹。也可以把共享放在其它文件服务器上，此时使用教师端生成的配置脚本到目标服务器上执行即可。

教师端的 “VHD/SMB” 页面下方是 “SMB设置管理”，常用项如下：

项目 作用
SMB IP 共享服务器 IP。班班通和教师办公室电脑都通过这个 IP 访问共享。
物理路径 共享文件夹实际保存位置。默认是教师端目录下的 share。
学生机号 选择“全部”或某一台班班通/学生机名。
教师端访问配置 为老师办公室电脑访问共享做账号和映射脚本。
学生端账户配置 为班班通 map_z 访问共享做统一账号和 NTFS 权限。

2. 教师端访问配置

“教师端访问配置”用于让任课老师在办公室电脑上访问对应班班通资料目录。

按钮 作用 使用场景
本机设置 在当前教师端电脑上立即创建共享目录、共享名和教师访问账号 共享就在本机 share 目录时使用。
配置脚本 只生成服务器配置脚本，不立即执行 共享在其它服务器上时，把脚本拿到那台服务器上以管理员身份运行。
映射脚本 为每个学生机号生成 Teacher_AutoMap_名称.bat 发给任课老师，在办公室电脑上双击即可映射 Z:。

当前逻辑会按学生机号创建同名共享和同名教师账号。例如班班通电脑名为 PC-01，就会创建：

共享目录：share\PC-01
共享名：PC-01
教师访问账号：PC-01

任课老师在办公室电脑上运行生成的 Teacher_AutoMap_PC-01.bat 后，会把：

\\SMB服务器IP\PC-01

映射为办公室电脑上的 Z: 盘。老师把课件复制到这个 Z: 盘后，班班通电脑再执行 map_z 就能看到同一批资料。

3. 学生端账户配置

“学生端账户配置”用于给班班通电脑访问 SMB 共享准备账号和权限。默认账号通常是 student，密码默认 123456，权限可选：

权限 含义 建议
只读（仅下载） 班班通只能读取共享内容 推荐日常教学使用，避免误删老师资料。
修改（全开） 班班通可读写修改 需要学生机回传文件时使用。
写而不删 可写入但尽量限制删除 适合收作业、收截图等场景。

如果 SMB 共享就在当前教师端电脑上，点“本机设置”。如果共享在其它服务器上，点“配置脚本”，然后到共享服务器上以管理员身份运行生成的脚本。

4. 班班通映射 Z: 盘

发送 map_z 可让学生机或班班通电脑映射共享盘 Z:。共享参数来自教师端 config.ini 的 [netshare]：

配置项 说明
share_ip SMB 共享服务器 IP。留空时默认使用教师机 IP。
share_name 学生端要映射的共享名。写 hostname 时，客户端会自动替换为本机计算机名。
share_user 访问共享使用的账号。写 hostname 时，客户端会自动替换为本机计算机名。
share_pwd 访问共享使用的密码。

常见配置有两种：

场景 推荐配置
每台班班通访问自己的同名共享 share_name=hostname，share_user=student，share_pwd=学生端账户密码
每台班班通使用同名账号访问自己的同名共享 share_name=hostname，share_user=hostname，share_pwd=教师端访问密码或统一密码

客户端收到 map_z 后，会先删除旧的 Z: 连接，再连接：

\\share_ip\share_name

并映射为 Z:。如果 share_name 或 share_user 写成 hostname，客户端会自动替换为本机名，从而实现一台班班通对应一个共享目录。

如果共享盘根目录存在 autorun.cmd，学生机映射成功后会自动运行它。此功能适合发放统一脚本，但要先在少量测试机验证。

5. 文件分发

文件分发建议使用教师端界面完成：

  1. 选择目标学生机。
  2. 选择学生机保存路径。
  3. 选择要分发的文件。
  4. 点击开始传输，等待完成提示。

同一文件可以一次分发给多台客户端；网页上传按队列依次处理，桌面文件、VHD 和 SYS 传输之间会检查当前任务是否忙碌。开始批量分发前，应先向一台客户端测试保存路径和文件权限。任务开始后会固定本次接收设备，随后改变列表选择不会改变停止通知的范围。

项目 要求或限制
目标范围 可选择一台、多台或全部在线客户端；批量前先单机验证。
保存路径 默认“桌面”，可下拉选桌面、下载、文档、系统、C盘、D盘、W盘、X盘，也可输入自定义路径。桌面/下载/文档解析为客户机当前登录用户的对应目录，不固定为 Administrator；“系统”指 Windows 目录。自定义路径须可写；A:/B: 可能触发 PE/VHD 专用磁盘准备流程。
文件名 普通桌面和 Web 上传均保留原始文件名；发送前备份目标目录中需要保留的同名文件。
速度 优先使用“自动”；也可按 MB/s 限速。“全速”不限速，慢网卡、慢磁盘或混合速率网络可能因丢包重传而更慢。
网络 服务端和客户端必须使用正确网卡；交换机、网络隔离或防火墙不能阻止文件分发。
并发 同一程序实例运行一个发送会话；与 SYS/VHD/网页传输冲突，或上次停止通知尚未发完时，请稍后重试。
结果 以最终完成提示为准；进度未完成时请继续等待。如有掉线或拒收提示，检查对应电脑并核对收到的文件。

传输过程中不要重启客户端、关闭服务端或切换网络。失败时检查支持文件是否齐全、目标路径是否可写、当前 server_ip 是否选择了正确网卡，并请网络管理员检查交换机的文件分发限制。

有些目标已存在一致文件时可跳过，有些缺少文件时继续接收，不应把一台已有文件当作全部完成。最终仍需看各目标结果。失败状态会把日志中的十六进制设备地址换算为 IP 尾号，例如 0xC0A8056F 显示“传输失败 IP尾号：111，请检查uftp.log”；多个子网可能尾号相同，完整地址和原因以日志为准。

遇到慢速或反复补包，可先把有线百兆网络限到 5～8 MB/s 试传；千兆网络从 20～40 MB/s 起逐步增加。这些是排查起点，不是速度保证。少数旧机接收慢时，可将其单独分发。混合网络中，自动模式会照顾较慢的接收端。

6. 壁纸

命令 作用 示例
wallpaper_图片名 设置指定壁纸 wallpaper_abc.jpg
wallpaper_分钟数 按间隔轮换壁纸 wallpaper_10

壁纸文件建议放在：

share\wallpaper

如需给某台学生机单独设置壁纸，可放在：

share\学生机名\wallpaper

客户端会优先查找本机专属目录，再查找公共 wallpaper 目录。

十一、SOP 看板和信息发布

SOP 发布功能用于把 PDF、Word、Excel、PPT、图片、视频等资料统一生成网页，让客户端通过浏览器全屏展示。它既适合工厂 SOP 作业指导书、产线看板，也适合学校班班通资料展示、考试须知和公共信息发布。

1. SOP 面板结构

服务端右侧有 “SOP发布” 标签页，主要分为三块：

区域 作用
页面设置 设置标题、工位、显示方式、版本号、备注。
SOP 文件 管理源文件目录，导入源文件，右键或点击“生成”生成展示页。
生成的展示页 预览、发布、批量发布或删除已生成网页。

页面设置说明：

项目 说明
标题 默认使用源文件名；多选源文件时默认使用“首个文件名等N项”。选中文件后可手工修改。
工位 推荐填写 通用、计算机名或计算机名前缀。客户端执行 sop_auto 时会按本机名匹配。
显示 填充、适应、铺满。图片和视频按浏览器 object-fit 生效，PDF 会尽量使用浏览器 PDF 查看参数。
版本 默认格式为 年月日_时分，切换文件时自动刷新；如果用户手工改过版本号，会以手工输入为准。
备注 可填写班组、岗位、注意事项等，会显示在展示页底部浮层。

工位 建议这样使用：

工位写法 作用
通用 所有客户端都可使用的默认页面。
PC-01 只优先匹配名为 PC-01 的客户端。
A线、g1、CNC 匹配对应计算机名前缀的一组客户端。

界面中的 自动 是生成时的辅助值：只选中一台客户端时会取该计算机名，选中多台时优先取当前前缀，无法判断时会落到 通用。

2. 源文件和转换

默认源文件目录是：

share\sop

如果需要把 SOP 源文件放到其它磁盘或共享目录，可以在 config.ini 的 [sop] 中设置 path；为空时使用默认目录。规模较大的工厂建议用一级子文件夹做分类，例如：

share\sop\装配
share\sop\焊接
share\sop\质检

SOP 面板中的“分类”下拉框会自动读取这些一级子文件夹。选择某个分类后，源文件列表和展示页列表只显示该分类内容；选择“全部”则显示全部内容。导入文件时，如果当前选择了具体分类，文件会自动复制到对应分类目录。

支持的源文件包括：

类型 说明
PDF 直接用于生成展示页。
Word / Excel / PPT 服务端用 LibreOffice 转换为 PDF 后展示。
图片 直接生成网页展示。
视频 直接生成网页，客户端浏览器全屏播放；轮播到视频时优先尝试有声自动播放，播放完成后切换下一项。

Office 文件转换建议在服务端安装 LibreOffice。安装后可以把 Word、Excel、PPT 等文件稳定转换为可发布的展示页面；未安装时，PDF、图片和视频仍可使用，但 Office 文件可能无法生成展示页。

SOP 源文件列表支持多选。一次选择多个 PDF、Office、图片或视频后点击“生成”，会生成一个轮播展示页。图片、PDF 等普通内容按 [sop] 中 fbr 设置的秒数自动切换；轮换到视频时会自动播放，视频播放结束后立即切换到下一项。Office 转 PDF 会在后台执行，转换期间服务端界面仍可操作。

3. 生成和发布

常用流程：

  1. 在 SOP 文件列表中选择一个或多个源文件。
  2. 检查或修改标题、工位、显示方式、版本、备注。
  3. 点击“生成”，或在源文件列表右键“生成展示页”。
  4. 在生成的展示页列表中右键“预览选中”，服务端浏览器会打开预览。
  5. 选择客户端后右键“发布选中”；如果未选中客户端，则发送给全部在线客户端。
  6. 使用“批量发布”时，服务端会按客户端计算机名和每个展示页的工位自动匹配，给不同客户端发送最合适的页面。

生成的展示页保存在：

share\sop_view

文件名示例：

工位_源文件名_编号.html

因为文件名已经包含工位和源文件名，列表中主要显示“网页文件、标题、版本、备注”。标题可以和源文件名不同，适合用更清楚的现场展示标题。

4. 客户端浏览器要求

客户端收到 SOP 发布命令后，会优先尝试使用 Chrome、Edge 或系统默认浏览器全屏打开页面。

推荐客户端安装 Chrome 或 Edge，以获得稳定的全屏展示效果。已设为默认浏览器的 CentBrowser、360Chrome、QQBrowser 等常见浏览器也可以尝试使用；其它浏览器可能无法自动全屏，此时可手工按 F11。

紧急退出：如果服务端断电、网络异常或无法发送 sop_close，可在客户端 SOP 页面右上角版本/工位区域连续点击 5 次，客户端会本地关闭 SOP 看板浏览器。

5. SOP 命令

SOP 命令可在历史命令、tasks.csv 的 command 类型、config.ini 的 autorun 中使用。

命令 作用 使用场景
sop_auto 按客户端计算机名自动匹配最新展示页 批量发布、定时发布、开机自动展示。
sop_show_网页文件名.html 打开指定展示页 所有客户端显示同一页面。
sop_close 关闭客户端 SOP 看板浏览器 结束展示或切换场景。

示例：

sop_auto
sop_show_通用_安全须知_ab12cd34.html
sop_close

从服务端历史命令发送 sop_auto 或 sop_show_... 时，服务端会自动启动 SOP 静态服务并生成索引。使用 notice_tasks.csv 同步任务时，服务端也会同时确保 SOP 静态服务已启动。

6. 定时 SOP 发布

可以在 tasks.csv 中定时执行 SOP 命令，例如：

id,target,cycle,time,type,content
201,*,Everyday,08:00,command,sop_auto
202,A线*,Everyday,10:00,command,sop_show_A线_安全操作_ab12cd34.html
203,*,Everyday,18:00,command,sop_close

这样客户端到点后会自动打开或关闭 SOP 看板。sop_auto 更适合不同工位显示不同页面；sop_show_网页文件名.html 更适合全体统一显示同一个页面。

7. 删除展示页

生成的展示页列表右键“删除选中”时有三种选择：

选择 含义
是 删除生成的展示页，并同时删除上面的 SOP 源文件。
否 只删除生成的展示页，不删除源文件。
取消 不删除任何文件。

删除源文件前请确认该文件没有被其它展示页或其它用途使用。

十二、定时通知、铃声、音频和视频任务

当前版本的 notice_tasks.csv 不只支持走马灯公告，也支持学校铃声、后台音频、全屏视频和定时命令。教师端首次运行时会自动在 share 目录生成示例文件和三个媒体目录：

share\tasks.csv
share\bell
share\audio
share\video

编辑好 tasks.csv 后，向学生机发送：

notice_tasks.csv

客户端会从教师端下载任务表，并每 5 秒检查一次是否有任务到点。任务按分钟执行，同一个 id 在同一天只执行一次；如果需要当天重新触发同一内容，请改一个新的 id 后重新发送 notice_tasks.csv。

1. tasks.csv 字段

tasks.csv 推荐用 GBK、UTF-8 with BOM 或 UTF-8 保存，客户端都会尝试读取。字段如下：

id,target,cycle,time,type,content
字段 说明 示例
id 任务编号，同一天去重用 101
target 目标学生机名，* 表示全体，支持通配符 *、PC-01、g1*
cycle 日期或星期 Everyday、Mon|Tue|Wed|Thu|Fri、2026-06-12、now
time 执行时间 08:00、17:30、now
type 任务类型 数字、command、bell、audio、video
content 公告内容、命令、网址或媒体文件名 上课铃.mp3、shutdown、https://www.baidu.com

星期使用英文缩写：Mon、Tue、Wed、Thu、Fri、Sat、Sun。日期可写 2026-06-12，也兼容 2026-6-12。

2. 任务类型

类型 作用 content 写法
数字 走马灯公告，数字表示滚动次数 全体立即到操场集合
command 执行客户端命令或打开网址 internet_disable、https://www.baidu.com
bell 播放铃声，后台播放，不显示窗口 上课铃.mp3
audio 播放音频，后台播放，不显示窗口 英语听力.mp3
video 播放视频，置顶全屏播放 考试须知.mp4

媒体文件只写文件名即可，不需要写 bell/上课铃.mp3 这种路径。客户端会自动按类型查找：

类型 实际目录
bell share\bell
audio share\audio
video share\video

如果确实需要，也可以在 content 中写 HTTP 地址或相对路径；日常使用建议只写文件名，最不容易出错。

3. 示例 tasks.csv

id,target,cycle,time,type,content
101,g1*,Mon|Tue|Wed|Thu|Fri,07:20,2,同学们早安，请开始早读
102,*,Everyday,08:00,bell,上课铃.mp3
103,*,Everyday,10:00,bell,下课铃.mp3
104,*,Everyday,10:20,audio,英语听力.mp3
105,*,Everyday,14:00,video,考试须知.mp4
106,*,Everyday,15:00,command,https://www.baidu.com
107,*,Everyday,15:30,command,sop_auto
108,*,Everyday,17:50,command,internet_disable
109,PC-01,2026-01-01,10:00,1,这是给PC-01的专属提醒
110,*,now,now,3,全体立即到操场集合
111,*,Fri,17:00,command,shutdown
112,*,Disabled,10:00,command,run_课堂资料.pdf

第 112 行是默认停用的下载打开示例，Disabled 不会触发。把 课堂资料.pdf 放在服务端 share 目录，按需要修改目标、日期或星期及时间，再发送 notice_tasks.csv 同步任务表；到点后学生端会下载并按文件关联打开。也可将内容改为 run_client.exe，用于定时更新客户端。任务表中的 run_ 需要新版客户端；更新旧客户端请先使用下面第十八章中的在线升级方法。

对应文件放置示例：

share\bell\上课铃.mp3
share\bell\下课铃.mp3
share\audio\英语听力.mp3
share\video\考试须知.mp4

停止由通知任务启动的音频或视频，可发送：

notice_stop_media

十三、临时公告

命令 作用 示例
notice_now_次数_内容 立即显示走马灯公告 notice_now_3_全体到操场集合
notice_HH:MM_次数_内容 添加一次性定时走马灯公告 notice_17:30_2_请整理桌面
notice_tasks.csv 同步任务表 notice_tasks.csv
notice_stop_media 停止通知任务启动的媒体播放 notice_stop_media

临时公告不写入 tasks.csv，适合当堂提醒。固定作息、铃声、听力播放、考试视频建议使用 tasks.csv。

十四、时间同步、PXE 和远程启动盘

命令 作用 示例
ntp_时间服务器 同步学生机时间 ntp_ntp1.tencent.com
ntp 与当前服务端校时；未启用本机时间服务时先临时开启 ntp
pxe 设置学生机下次从网络启动 pxe
iscsi_服务器IP 连接远程启动盘 iscsi_192.168.0.1
iscsi_unmount 断开远程启动盘 iscsi_unmount

临时统一校时： 直接发送 NTP，若本机时间服务尚未启动，先临时开启并添加允许本地子网访问 UDP 123 的 Windows 防火墙规则，再发送校时命令。不会把 NTPserver = 1 写入配置，本次临时服务随服务端退出而结束；启动或防火墙配置失败时停止此次发送并提示原因。学生机以服务端电脑的系统时间为准，请先校准服务端时间。两版均支持，不需要互联网。

每次启动都提供时间服务： 在 config.ini 的 [Settings] 中设置 NTPserver = 1，重启服务端生效；默认 0 不自动开启。改回 0 并重启后移除该专用规则。第三方防火墙或跨网段访问需另外放行，端口被其它服务占用时需先处理冲突。NTP_IP或域名 使用指定时间服务器；指定外部地址不会为了它启动本机 NTP。

PXE、iSCSI、VHD 相关功能属于维护功能。课堂中不要随意发送，执行前确认目标机器、网络和启动文件都正确。

在 VHD 库设置个人盘和公共盘目标

在 VHD 库右键一个 VHD/VHDX，选择 设置为 iSCSI 目标。可逐个添加多个文件，已有目标继续保留；这项操作不改无盘启动菜单，也不自动开启 PXE。

PXE 部署条件和模式

启动 PXE 前，在服务端网络参数中选择与机房相连的服务 IP，确认网卡已连接，并准备好相应的 BIOS/UEFI 启动文件、启动菜单和系统镜像。所需文件应放在服务端程序同级目录或管理员指定的 PXE 文件目录。

设置 效果 使用限制
proxy_dhcp = 0 完整地址分配模式 网络中不能同时运行其它地址分配服务；适合独立测试网或已停用其它地址分配服务的机房。
proxy_dhcp = 1 Proxy 模式，仅补充启动信息，IP 由现有 DHCP 分配 适合已有路由器或校园 DHCP 的网络；必须保证该 DHCP 能给客户机分配地址。

启动文件应按电脑类型选择：传统 BIOS 使用 BIOS 启动文件，UEFI 电脑使用对应位数的 UEFI 启动文件。较大的系统镜像应优先使用高速下载方式。部分旧电脑只能使用兼容模式，速度可能明显变慢；如出现 Start PXE over IPv4、文件找不到或下载超时，应先确认电脑启动类型、启动文件名称、地址分配模式和服务 IP，再更换启动方式。

建议先用一台 BIOS 和一台 UEFI 电脑试机，确认可以进入菜单后再批量启动。校园网已有地址分配服务时不要随意开启完整地址分配模式；PXE 只应在受控内网使用，不要用于公网。

多服务端的 PXE 自动避让

开启 PXE 前会先进行约 1.5 秒的局域网探测，包括勾选“下次自启”后的自动开启。若同网段另一台新版 BSCX 已开启或正在启动 PXE，本机取消此次启动，状态栏显示对方 IP；日常教学仍可使用，“下次自启”的勾选保持不变。对方停止 PXE 后，可以在本机重新点击开启。

已有服务优先；多台同时申请启动时按 IP 数值顺序择一，通常由较小 IP 的服务端启动。运行中仍会少量发送状态通知，发现重复开启时自动避让。互斥独立于“只管本班”，DHCP、Proxy 两种模式都参与。

各服务端都需使用支持此功能的新版，并允许局域网 UDP 58902 通信。旧版 BSCX、第三方 PXE 服务及被防火墙或网络隔离的服务端不能靠此机制可靠发现，仍需人工协调；普通路由器的 DHCP 服务不等同于 PXE 服务。该功能不负责自动接管另一台的无盘目标或启动菜单。

本地 VHD 的一次性网络启动

将与机器 UEFI 位数相符的 ipxe.efi 放在客户端程序同级目录，安装或 inject 时会复制到安装目录。随后执行 vhd_fix，会把它部署到本地引导分区的 A:\EFI\Boot\ipxe.efi 并加入 iPXE 菜单。已有 VHD 菜单时，发送 pxe 或 ipxe 也会尝试补齐这一启动项，包括修正旧菜单中的文件位置。

普通 Windows 优先沿用固件网络启动；本地 VHD 系统及装有本地 VHD 的 PE 使用菜单中的 iPXE 项，5 秒后重启。进入 PE、无盘或返回本地 VHD 后，新版客户端会恢复原来的系统默认项；连续设置临时启动仍保留最初的系统项，无盘系统不会因此套用本地静态 IP。若网络启动未成功、目标系统未运行新版客户端，就尚未执行恢复，可在本地菜单选择系统或 PE。此方式仍要求可用的网络启动服务，并受 UEFI 位数、网卡驱动和安全启动设置约束。

仅在把 iPXE 设为默认项时，menu.lst 的 timeout 临时改为 3 秒，以便网络启动失败时手工选其它系统。恢复原默认项、切换保留/还原模式、进入父本维护及执行 vhd_fix 时均恢复 0 秒；菜单等待时间与上述 5 秒重启提示是两回事。

旧电脑的 EFI 兼容开关

MAIN 的 PXE 区域提供 DHCP、Proxy、EFI兼容 控件，下方为“下次自启”和“PXE网启”。旧 UEFI 机器在 DHCP 模式下显示“IP 已分配”，却停留在 Start PXE over IPv4 或返回本地系统、没有下载启动文件时，可勾选“EFI兼容”后重新尝试网启。

PXE 已开启时，修改启动文件、DHCP/Proxy 模式或 EFI 兼容选项，保存成功即应用，无须手工关闭再开启。模式切换可能短暂重建内部监听，失败时提示并恢复原设置；已经下载或进入启动菜单的客户机不会自动重启，需重新发起网启才使用新设置。完整 DHCP 分配会优先复用该 MAC 的可用历史地址，探测到地址已被其它设备占用时跳过；探测可能被设备或网络屏蔽，不能代替合理划分地址池。Proxy 模式的 IP 仍由现有 DHCP 管理。

该开关对应 config.ini 的 [Settings] 中 pxe_uefi_dhcp_compat = 1；默认 0，正常启动的环境保持默认即可。它只调整完整 DHCP 模式中 UEFI 初始地址应答的启动信息，不改变 Legacy BIOS 或 Proxy 模式。已有 DHCP 的网络仍应选 Proxy；不要为了尝试这个开关直接增加第二个 DHCP。新版同时包含旧固件所需的 ProxyDHCP 应答兼容处理。

十五、系统冻结和解冻

命令 作用 注意事项
freeze 进入还原保护状态 下次启动后通常会还原。
thaw 进入保留更改状态 维护、安装软件时使用。

如果学生机使用 VHD 启动，freeze 和 thaw 会切换 VHD 菜单中的还原/保留启动项，通常会配合重启生效。

十六、VHD 维护命令

VHD 命令只建议维护人员使用。执行前确认客户端供电稳定、VHD 文件有备份且磁盘空间充足；执行中不要关机、拔盘或重复发送同一维护命令。

系统名通常来自 VHD 文件名前缀。例如 win10.vhdx 的系统名是 win10，win11.vhdx 的系统名是 win11。

命令 作用 示例
vhd_fix 检查全部 VHD 系统，清理失去对应父本/更新层的无效文件，补齐可启动版本和备份并刷新菜单 vhd_fix
vhd_父本名 直接启动父本进行维护；确认进入后删除该父本全部旧更新层、启动层和备份 vhd_win10
vhd_freespace 查询 VHD 数据分区剩余空间 vhd_freespace
vhd_restore / vhd_keep 保持当前运行的系统和版本，只切换还原/保留模式；PE 中按默认启动项处理 vhd_keep
vhd_restore_父本名 / vhd_keep_父本名 选择该父本的最新版本，以指定模式启动 vhd_restore_win10
vhd_restore_父本名_new / vhd_keep_父本名_new 基于该父本新建当前日期时间的更新层、启动层及备份，设为指定模式；时间精确到分钟 vhd_keep_win10_new
vhd_restore_父本名_日期或时间 / vhd_keep_父本名_日期或时间 从菜单中匹配指定版本；可用月日、时分或更完整的日期时间 vhd_keep_win10_1026、vhd_keep_win10_10260902
vhd_restore_父本名_roll / vhd_keep_父本名_roll 在该父本所有版本中按菜单顺序轮换，使用指定模式 vhd_restore_win10_roll
vhd_merge_父本名 将实际修改时间最新的启动层合并至更新层，按当前时间改名，重建启动层及备份、刷新菜单并清理旧启动层及备份 vhd_merge_win10
vhd_clean_all 清理所有系统的旧版本 vhd_clean_all
vhd_clean_系统名 清理指定系统的旧版本 vhd_clean_win10
vhd_clean_系统名_版本关键字 删除指定系统中匹配版本关键字的文件 vhd_clean_win10_260531
vhd_wim_镜像名 下次启动到指定维护镜像 vhd_wim_winpe

VHD 注意事项：

  1. 裸命令 vhd_keep / vhd_restore 只改变当前运行版本的模式，PE 中按菜单默认版本处理；加上父本名时改为选择该父本的最新版本。本地 VHD 系统的“解冻系统”按钮等同于裸 vhd_keep，“冻结系统”按钮等同于裸 vhd_restore，不会跳到该父本的其它版本；普通实体 Windows 仍使用原有系统保护功能。切换成功后会提示并约 5 秒后重启；如果已是同一启动项和模式则不重复重启。
  2. 时间示例：_1509 匹配 15:09，_1026 匹配 10 月 26 日，_10260902 匹配 10 月 26 日 09:02；也支持 _261026_0902 这样的完整版本日期。四位数字可能同时符合月日和时分，多个匹配项取最新版本，要精确指定请填写更完整的日期时间。同一分钟有多个版本时按版本编号区分。
  3. 指定父本名不存在时提示“没有对应的父本名系统”，不修改菜单。父本存在但指定时间没有匹配项时，保留当前运行的系统和版本，PE 中按默认启动项处理，只切换还原/保留模式并提示；当前项不是 VHD 或缺少对应模式时不强行切换。
  4. _new 从父本创建新版本，不继承现有更新层或启动层内的软件修改；按命令中的 restore / keep 设置下次默认模式，不自动重启。正在使用同一父本的另一个启动版本时，可尝试从只读父本创建独立新版本；系统不允许共享访问、直接从父本运行或无法确认启动链时，会提示进入 PE 并停止，不强行卸载父本。运行其它系统时也要求目标新版本未被占用。旧的前置 roll 写法和带父本名的 vhd_fix 命令不再使用，服务端会迁移配置中的旧历史及自动命令；任务表和自编脚本请按新格式修改。裸 vhd_fix 继续用于整体修复。
  5. vhd_merge_系统名 选择实际修改时间最新的可启动版本，不按文件名中的日期判断。执行前应确认最近使用的版本就是需要保留的状态。
  6. 合并成功且新启动层与备份生成后，清理旧启动层及其 BAK。此前遗留的孤立启动层也可通过 vhd_fix 清理；占用文件不会强制删除，遇到提示可进入 PE 后重试。合并期间不可关机、拔盘或重复发送命令。
  7. vhd_clean 会删除旧版本文件，删除后不能直接恢复；vhd_clean_all 影响所有系统。
  8. VHD 必须放在软件指定的 VHD 目录中，相关文件需可读写且未被其它程序占用。磁盘加密、空间不足、权限或盘符冲突都可能导致失败。
  9. 不要清理、合并或修改当前正在使用的 VHD。无法确认是否占用时，统一进入 WinPE 后操作。
  10. 维护失败时先查看客户端提示和服务端日志，不要马上连续重发命令；确认文件状态和备份完整后再继续。

VHD/SMB 的库列表在点击“刷新”或重新选择目录后会重新扫描；父本只读保护、备份状态和挂载状态检查保留。扫描中请等待状态更新，避免连续点击刷新。制作 iSCSI 启动镜像及单独优化离线 Windows 见第二十六章。

从 VHD 库重新分发系统或 PE

  1. 选择客户机，在库中选择 VHD/VHDX 或 WIM 文件，点击“开始分发”或右键发送。替换学生机当前正在运行的父本，应先进入 PE。
  2. 客户机优先复用已有 VHD 分区。识别会核对同一块硬盘上的分区位置和文件系统；A、B、W 中只保留一个正确卷标，或格式化后仍保留原特殊分区类型，均可识别，不会仅因卷标丢失就重新分区。A 应为 FAT32，B、W 应为 NTFS；盘符冲突或结构不符时不会当作合格布局直接使用。
  3. 确需重新分区时，客户机显示 15 秒可取消警告。若已经存在同名父本，则单独提示将清除该父本及其全部更新层、启动层、还原备份；15 秒未取消才继续。其它父本及其版本保留。取消或准备失败的机器会跳过，不参加此次传输。 倒计时期间，可在服务端选中要取消的客户机，点击 清理窗口，等同于在这些机器上点击取消，服务端将跳过它们的后续分发。不选客户机时，按当前管理范围执行：勾选“只管本班”时为本班，否则为当前网段。此功能需客户机及时收到命令；倒计时结束、已经开始的磁盘写入无法通过关闭提示窗口撤销。
  4. 文件完整传输成功后，客户机自动执行 vhd_fix 的修复流程：补齐 VHD 更新层、启动层、还原备份及引导菜单；WIM 文件也会加入 PE 菜单。传输失败或文件不完整时不自动修复，可解决问题后重新分发。
  5. PE 启动时读到的菜单名称/IP 配置会在本次运行期间保留；即使随后格式化或重建分区，修复时也会恢复这些配置，原默认系统的配置作为新系统的通用配置。若在读到配置之前就已格式化 A 盘，或清空后重启导致记录丢失，则无法凭空恢复，应重新广播改名、设置 IP。

请等待客户机提示修复完成后再重启。父本替换会丢失旧版本中的软件和学生数据，确认前先做好备份；本流程需使用配套新版服务端和客户端。

直接维护父本，再重建版本

这项操作用于直接修改本地父本，会清除该父本的旧版本。父本系统和 PE 中均需运行支持此功能的新版客户端；只更新当前差分系统中的客户端，不会同时更新父本里的客户端。使用前确认本地 WINPE 菜单可以正常启动，并保留需要的数据。

  1. 服务端选中目标机，发送 vhd_win10（将 win10 换成父本名）。客户端显示 15 秒警告；点击取消、关闭警告或使用服务端“清理窗口”，均取消后续操作。
  2. 倒计时结束，取消父本只读保护并设置下次直接启动父本，提示 5 秒后重启。此时还未删除旧版本。
  3. 客户端确认本次确实从父本启动后，删除该父本全部旧更新层、启动层及还原备份，其它父本保留；名称和 IP 仍采用该父本保存在菜单中的配置。系统信息显示“父本维护”，右上角常显“结束维护”按钮。
  4. 安装、更新所需软件。维护期间可发送 vhd_freespace 查询空间、pxe / ipxe 临时网络启动，或 vhd_另一父本名 切换到另一父本维护（同样有可取消的 15 秒警告）。普通保留/还原切换、合并、新建版本、清理等操作仍需先结束维护。点击“结束维护”，或发送 vhd_wim_winpe 返回 PE。
  5. PE 中的客户端识别到父本维护任务后，自动清理遗留旧层并执行 vhd_fix，把父本重新设为只读，创建新更新层、启动层和备份并刷新菜单。如果连续切换维护过多个父本，进入 PE 后会一并重建，并优先将进入 PE 前的父本新版本设为下次默认还原启动。临时网络启动不会清除待完成的维护任务。完成后自行重启回系统；若重建失败，按提示处理后在 PE 重发 vhd_fix。

修改后的父本不能再配用原来的旧更新层。 新更新层也不能分发给仍使用旧父本的机器。需要保留旧版本或继续向全机房同传更新层时，仍使用原来的更新层维护、合并流程。不要把 vhd_父本名 放入开机自动命令，以免反复进入维护。

在线 VHD 与 PE 中的操作范围

这里的“当前版本”以实际正在运行的系统为准；修改下次默认启动项，不会解除当前版本的保护。拒绝操作时会显示数秒原因提示。

客户端沿用系统信息中识别的父本和启动版本。升级客户端后，原有父本、更新层和启动层可继续使用，不需要重新制作。PE 中只有父本时，执行 vhd_fix 会创建初始更新层、启动层及还原备份；如有步骤失败，会提示原因，请勿把失败结果当成部署完成。

操作 正在运行本地 VHD PE 环境
分发同名父本，或覆盖当前更新层、启动层、还原备份 拒绝接收，需进入 PE 文件未挂载、未占用时允许；替换父本前有倒计时
分发同父本的另一个日期更新层 该版本未占用时允许；完整接收后自动修复，保留当前启动链 允许并自动修复
分发其它父本或其更新层 目标未占用时允许，并检查父子关系 允许，并检查父子关系
仅分发 winpe.wim 等 PE 镜像 允许；接收完成后更新引导菜单，不改动 VHD 启动链 允许，并更新引导菜单
vhd_keep_父本_new / vhd_restore_父本_new 尝试只读共享父本新建独立版本；共享失败则提示进入 PE 父本完整、空间充足且未被其它程序占用时允许
vhd_keep/restore 及指定父本、日期、roll 修改启动菜单；不改写正在运行的磁盘内容 按菜单选择下次启动项
vhd_merge_父本 仅允许合并未运行、未挂载的目标版本；正在使用的版本拒绝合并 目标文件未占用时允许
vhd_clean / vhd_fix 跳过当前启动链和占用文件，可处理其它闲置版本 处理未占用的版本

更新层必须来自同一份原始父本。 只把两个父本改成相同文件名并不代表兼容。父本标识不一致时会停止修复；请补齐正确父本。修复更新层的关联只修改该更新层，不改写它所引用的父本。

十七、SYS 硬盘分区同传命令

SYS 同传用于在 WinPE 环境下，把一台源电脑的硬盘分区和文件数据快速分发到同机房其它 PE 电脑。该功能可能重建、格式化或覆盖目标分区，属于高风险维护功能，只建议管理员在机房维护或批量装机时使用。

1. 使用条件

  1. 源机和目标机都应进入 WinPE，并运行客户端 client.exe。
  2. 服务端发送 sys_ 命令时，必须且只能选中一台在线源机。
  3. 源机计算机名必须以 PE 开头。
  4. 其它在线且计算机名以 PE 开头的客户端会作为目标机；在线但不是 PE 前缀的机器不会收到 SYS 同传指令。
  5. PE 中客户端同级目录必须放置 udp-sender.exe、udp-receiver.exe、wimlib-imagex.exe、libwim-15.dll。
  6. 这些文件只需放在 PE 客户端同级目录，不需要安装到普通 Windows 系统。
  7. 建议同批测试同型号、同容量或接近容量的硬盘，确保供电、网线和交换机稳定。

2. 支持命令

分区号使用 DiskPart 中显示的分区号，通常从 1 开始，不会自动排除 EFI、MSR 等特殊分区。若指定的是不可捕获分区，任务会失败并在服务端状态栏和 server.log 中提示。

命令格式 作用 示例
sys_disk磁盘号_分区号_keep 传输指定磁盘的指定分区，不重建目标分区表 sys_disk0_5_keep 表示传输 DiskPart 磁盘 0 的分区 5。
sys_disk磁盘号_分区号 先按源机指定磁盘结构重建目标磁盘，再传输指定分区 sys_disk2_1 表示传输 DiskPart 磁盘 2 的分区 1。
sys_disk磁盘号_all_keep 传输指定磁盘的全部可传分区，不重建目标分区表 sys_disk1_all_keep。
sys_disk磁盘号_all 先复制源机指定磁盘分区结构，再逐个传输全部可传分区 sys_disk1_all。
sys_stop 停止当前 SYS 同传任务 只通知当前 SYS 会话的源机和目标机。

3. 执行流程

  1. 在服务端只选中一台 PE* 源机，输入并发送 SYS 命令。
  2. 服务端弹出二次确认；确认后向源机请求磁盘分区清单。
  3. 源机扫描指定磁盘，返回分区结构和可传分区信息。
  4. 服务端通知所有在线 PE* 目标机准备硬盘；目标机会排除 USB/SD、当前运行盘、系统/启动盘、脱机盘和只读盘，多块容量接近的候选盘无法可靠判断时会拒绝自动选择。
  5. 目标机按命令决定是否重建分区表、格式化目标分区并分配盘符。非 _keep 的单分区命令也会清空并重建整块目标硬盘，只回填命令指定的分区。
  6. 所有准备完成后，服务端按分区逐项开始同传；目标机准备完成后才会开始写入。
  7. 目标机接收完成后，程序会继续执行必要的磁盘和启动检查。
  8. 全部分区完成后，目标机会尝试进行必要的引导修复，并恢复临时盘符和恢复分区属性。

SYS 同传只传文件系统中的有效数据，并过滤 pagefile、休眠文件等不需要复制的临时文件。MSR、EFI 等特殊分区不会作为普通数据分区传输，但在重建分区结构时会按源机布局创建。

4. 速度和状态显示

SYS 同传不使用普通文件分发的速度滑条。传输过程中服务端显示总体进度，源机和目标机显示本机状态。

如果某台目标机长时间无法完成，服务端可能将其从本次任务中移除，让其它目标机继续。服务端状态写入 server.log，客户端详细记录写入同级 syscast_logs\<任务号>.log。排障时请同时查看两边日志。

5. 注意事项

  1. SYS 同传统一要求在 PE 下使用，不建议在正在运行的 Windows 系统中热备份系统分区。
  2. 目标分区会被格式化或覆盖，发送前必须确认目标范围。
  3. 如果目标机只有一块硬盘，会优先使用该硬盘；如果有多块硬盘，客户端会尽量选择与源硬盘容量和型号最接近的非 USB 硬盘。
  4. 目标机数量较多或网络不稳定时，建议按硬件批次分组同传，避免个别慢机器拖慢整批任务。
  5. 首次部署应先选择少量测试机验证分区号、目标硬盘选择和引导修复结果。
  6. 如果单目标正常、多目标异常偏慢或失败，优先检查交换机是否允许多机分发、网络隔离策略、网卡驱动和防火墙。
  7. 任务失败后先查看服务端状态栏和 server.log，不要连续重复发送同一 SYS 命令。
  8. _keep 会在格式化前检查目标分区是否存在且容量足够；传输 Windows 分区时还会检查 GPT/MBR 风格和 EFI/活动启动分区是否匹配。
  9. 自动重建暂不支持含扩展分区或逻辑分区的 MBR 布局，这类硬盘请使用 _keep 并先在少量测试机验证。

十八、安装、升级和客户端退出

命令 参数格式 作用与行为
inject 无参数 未安装客户端：安装客户端但不设置可选项；已安装客户端：清除之前设置的服务端地址、标签、屏幕查看和断网锁定选项。
inject_serverip=IP 例如 inject_serverip=192.168.11.1 安装/更新客户端，并指定客户端优先联系的服务端地址。
inject_label=0/1 例如 inject_label=0 0 隐藏右上角计算机标签，1 显示。
inject_monitor=0/1 例如 inject_monitor=0 0 禁用屏幕查看，1 允许屏幕查看。
inject_netlock=0/1 例如 inject_netlock=0 0 不因断网自动黑屏锁定，1 启用断网锁定。
组合参数 inject_serverip=192.168.11.1,label=0,monitor=0,netlock=0 一次写入多个选项。也兼容 inject,serverip=...、ip=...、server_ip=... 写法。
close 无参数 正常退出客户端和守护逻辑，适合升级前使用。

注入设置会保存为客户端的长期选项，设置和清除都需要管理员权限。对未安装系统执行带参数的注入时，会先安装客户端，再保存请求的初始设置；普通 Windows 和 WinPE/离线系统均可注入，但必须在相应环境以管理员身份执行。裸 inject 在未安装机器上不设置服务端地址、标签等选项，在已安装机器上用于清除这些选项。组合示例：inject_serverip=192.168.11.1,monitor=0。

首次安装的十秒倒计时窗口还提供隐藏标签、禁用抓屏、禁用断网锁定的勾选项。它们只影响本机初始配置；批量部署应使用上述 inject_* 参数统一设置。在线升级使用下面的 run_client.exe；需要手工替换文件时，先发送 close，再替换文件，避免强行覆盖正在运行的客户端。

在线下载、运行与客户端升级

把需要分发的文件放进服务端 share 目录，选中在线目标后发送 run_文件名。例如 run_课堂资料.pdf 下载后按关联打开，run_工具.exe 下载后运行；子目录可写为 run_工具/工具.exe。程序只下载指定文件，依赖多个同目录文件的软件应先制作成独立安装包。下载使用现有 HTTP 文件服务（TCP 58885），无需另建服务；手动发送受维护权限保护。此操作面向当前管理范围内已登记的目标，没有选择时发送给该范围全部已登记设备，离线机器不会排队执行。

普通 Windows 在线升级： 将配套新版 client.exe 放入 share，发送 run_client.exe。下载并校验完整文件后，再替换安装目录中的客户端并启动新版，保留原注入设置；下载或校验失败时原客户端继续运行。替换或启动发生异常会尝试恢复旧文件并重新启动。收到升级命令前不必先发 close。

inject 保持原有行为，不触发网络下载：已安装客户端收到裸 inject 时清除原注入选项，带参数时按要求写入配置；PE 中继续使用 PE 客户端同目录的文件进行离线注入。在线下载升级统一使用 run_client.exe，升级文件须放在服务端 share 中。

手动向旧 Windows 客户端发送 run_... 时，服务端使用 Windows 自带 PowerShell 完成下载和校验，因此可用于升级尚不识别 run_ 的旧客户端；下载的 client.exe 必须是包含在线升级功能的配套新版客户端。新版 PE 客户端及定时任务使用已有下载功能，不要求 PE 安装 PowerShell。notice_now_次数_文字 仍用于走马灯提示，不会下载或运行文件。

VNC 安装： 将准备好的自动安装包命名为 tightvnc.exe，放在客户端程序同级目录。安装、更新客户端或执行 inject（包括带参数的注入）时，先检查目标安装目录：已有 tightvnc.exe 就跳过 VNC 的复制和安装，不比较版本，也不重复安排下次登录安装；没有此文件时才复制，正常 Windows 随即运行一次，PE 下则安排离线系统下次管理员登录时运行一次。没有同级安装包也会自动跳过，不影响客户端安装和注入。客户端平时开机运行不会重复安装 VNC；如需重装或升级 VNC，请手工运行所需安装包。多个离线系统并存时，应先确认目标分区；VHD 系统需先挂载。服务端地址、标签、屏幕查看等选项仍按上述注入命令的参数处理。

十九、自定义命令

除了内置命令，也可以输入程序路径、脚本路径或网址。例如：

输入 作用
C:\Tools\setup.exe 在学生机运行指定程序。
C:\Scripts\init.cmd 在学生机运行指定脚本。
https://www.baidu.com 用默认浏览器打开网页。
sop_auto 按工位自动打开 SOP 看板。

自定义命令风险较高。维护人员应先选择一台测试机验证，再批量发送。

二十、config.ini 常用配置

1. Settings

配置项 说明
rows、cols 广播改名时的行列数量。
prefix 批量命名默认前缀。
server_ip 教师机当前管理 IP；多网卡时必须填写实际连通学生机的地址。GUI 修改后需重新启动相关服务。
start_ip 批量改 IP 起始地址。
subnet、gateway、dns1、dns2 批量改 IP 使用的网络参数。
auto_start_pxe 是否启动时自动开启 PXE。
proxy_dhcp 0 为完整地址分配模式，1 为使用现有地址分配服务；见 PXE 章节。
pxe_uefi_dhcp_compat 0 默认，1 为旧 UEFI 的 DHCP 启动应答兼容；对应 MAIN 的“EFI兼容”，仅影响完整 DHCP 模式。
pxe_http_port PXE 高速文件下载服务设置，通常保持默认值。
pxe_bios_file、pxe_uefi32_file、pxe_uefi64_file BIOS、32 位 UEFI、64 位 UEFI 的启动文件名。
pxe_ipxe_menu PXE 启动菜单文件名，默认 autoexec.ipxe。
usb_disabled 是否默认禁用 U 盘存储。
NTPserver 0 默认不随启动开启时间服务；1 每次启动开启。临时发送 NTP 自动开启本次服务，不修改此值。
webdav_user、webdav_password 个人磁盘账号密码。
screen_audio_mode 屏幕演示和独立语音的声音来源，见“屏幕演示、语音和键鼠广播”。
screen_force_software 1 强制屏幕画面使用 libx264 软件编码并跳过硬件编码探测；0 自动选择硬件或软件编码。
screen_multicast_ttl 屏幕演示和批量传输的网络范围；普通机房保持默认，跨网段时由网络管理员调整。
screen_res、input_args、encoder_args、screen_audio_encoder_args 屏幕演示画面、声音和设备的高级设置；正常使用时保持默认。
monitor_page_limit 画面监控单页设备上限；数量过大时会降低刷新速度。
web_enabled 班班通版 Web 开关，0 默认关闭，改为 1 才启动 Web。机房版无此功能。
web_bind、web_port Web 监听地址和端口，默认 0.0.0.0:58443；生产环境建议绑定内网地址并配防火墙。
web_tls_required 0 适合受控内网管理，1 启用安全访问；手机麦克风和摄像头通常要求安全访问。
web_ice_servers、web_ice_username、web_ice_password 跨网络使用实时声音和视频时的高级设置；校园内网一般保持默认。
web_cert、web_key 安全访问所用证书文件；不用时留空，由学校网络管理员配置。

2. sop

配置项 说明
org SOP 展示页左上角单位/公司名。为空时只显示 SOP。
notes SOP 备注历史，由界面自动维护。
fbr SOP 多文件轮播间隔，单位为秒，默认 15。视频不按固定秒数切走，而是播放完成后切换。
path SOP 源文件目录。为空时默认为程序所在目录下的 share\sop；填写其它绝对路径时使用指定目录。

3. netshare

配置 map_z 使用的共享盘参数：share_ip、share_name、share_user、share_pwd。班班通版首次建立 Web 数据库时，share_pwd 还作为管理员和自动教师账户的初始密码；部署后应立即修改 Web 管理员密码。

4. VHD

vhdpath 指定教师端 VHD 文件库目录。默认通常为 share 目录。

5. VHD 网络启动

配置项 说明
autorun 是否自动生成并发布 VHD 网络启动菜单。
mode 菜单生成模式，常用 classroom。
policy 默认启动策略，如 reset。
source VHD 网络启动源文件目录；留空使用程序目录。
runtime_dir、runtime_root VHD 网络启动文件的保存目录。
generation、cache_mb 高级运行参数；没有明确需要时保持默认。

6. Commands

配置项 说明
autorun 通用命令，所有系统上线时都会发送；原有配置继续有效。
autorun_normal 仅普通本地 Windows 系统上线时追加发送。
autorun_pe 仅 PE 系统上线时追加发送。
autorun_vhd 仅本地 VHD 系统上线时追加发送。
autorun_diskless 仅 iPXE/iSCSI 无盘系统上线时追加发送。
history 最近实际发送的 80 条不同命令；内置示例独立保留，不占历史名额。

这些设置可用于自动签到、校时、同步任务表、打开 SOP 看板等。维护类命令仍要求先解锁服务端维护权限；不要放入未经确认的磁盘操作或重启命令，避免上线后误操作或反复重启。

按系统分类示例（空白项不发命令；配置项名称使用下面的小写写法）：

[Commands]
autorun =
autorun_normal = sop_auto
autorun_pe =
autorun_vhd = sop_auto; ntp
autorun_diskless = ntp

只有真正适合全部系统的命令才放进 autorun。客户端登录或重连时，先同步课堂状态，再按“通用命令 → 对应系统专用命令”的顺序发送，完全相同的命令只发一次。专用命令只会发给该客户机，普通心跳不会重复触发；同一系统的重复登录请求间隔不足 10 秒时合并处理，切换系统类别后可重新触发。修改配置后重启服务端生效。

多个命令可用分号分隔，也兼容逗号。命令本身含逗号、分号时请用 JSON 数组，| 不作分类或分隔符。例如：

[Commands]
autorun_vhd = ["notice_tasks.csv", "sop_auto"]

分类依据是客户机列表中的系统信息，而不是计算机名：X:\Windows… 为 PE，带“无盘”为无盘系统，Win10_261004_0930 这类“系统名_版本日期”为本地 VHD，C:\Windows10 这类信息按普通 Windows 处理。若本地 VHD 未能读取启动菜单、只上报 C:\Windows10，服务端无法与普通 Windows 区分；系统信息为空或无法识别时仅发送通用命令。

手工下发签到命令仍会更新本次服务端运行期间的通用自动签到。仅希望特定系统自动签到时，在对应项填写 checkin_班级名；专用自动签到不会加入通用列表。避免在通用与专用项中设置不同班级的签到命令。

7. EXAM

[EXAM]
port = 58444

这是独立考试服务的 TCP 端口，与班班通 Web 管控的 58443 分开。考试时长和可交卷时长在 EXAM 页面设置。更改端口前应先收卷并关闭旧考试服务，再重新启动服务端；防火墙需允许学生网段访问实际考试端口。

二十一、网络和安全注意事项

网络和服务要求

  1. 服务端和客户端应在同一学校管理网，或通过学校批准的 VPN 互通。多网卡服务器请在界面中选择实际连接机房的服务 IP；客户端应使用能收到服务端广播的有效网卡。
  2. Windows 防火墙和安全软件必须允许 BSCX 的局域网控制、屏幕查看、文件分发、个人磁盘和 PXE 服务。更换网卡、无线网络或安全策略后，应重新检查。
  3. 屏幕演示、文件分发和 SYS 同传需要交换机允许多机传输；如果单机正常而多机失败，请联系网络管理员检查交换机隔离、组播和流量限制。
  4. 完整地址分配模式只能在没有其它地址分配服务的独立网络中启用；校园网已有地址分配服务时选择“使用现有地址分配服务”，并先用一台电脑验证。
  5. shutdown、reboot、vhd_merge、vhd_clean、pxe、inject、diskflt_*、sys_ 硬盘同传和自定义命令属于高风险操作，发送前确认目标范围。
  6. 没有选中学生机时，普通命令按当前管理范围发送；“只管本班”关闭时可全网广播。SYS 命令例外，必须且只能选中一台 PE* 源机。
  7. 媒体播放需要客户端同级目录存在 ffplay.exe；SOP 展示需要客户端有可用浏览器，推荐 Chrome 或 Edge。
  8. 发现学生机离线时，先检查电源、网线、IP、客户端进程、防火墙和交换机隔离，再考虑重启或重新安装。
  9. 远程查看密码需与客户端 VNC 服务保持一致。远程查看、控制和文件服务只应开放给可信管理网络。

二十二、常见问题

问题 处理方法
客户端不出现在列表中 检查服务端与客户端网络是否互通、是否以管理员身份运行、防火墙或安全软件是否允许程序通信，以及客户端是否正在运行。
发送命令无反应 先选择一台测试机发送 pc_id 或 screen_lock，确认通信正常；再检查是否误选了离线机器。
签到后没有 H 盘 确认服务端个人磁盘功能已开启，H: 未被其它程序占用；旧系统需备用连接时由管理员手工配置 rclone.exe。
H 盘没有显示学生姓名 确认已经签到、个人磁盘连接正常；如需重新签到，先主动取消当前签到。同班重复命令不会再弹框。
铃声/音频/视频不播放 确认媒体文件放在正确目录，文件名与 tasks.csv 一致，学生端有 ffplay.exe，并重新发送 notice_tasks.csv。
tasks.csv 到点不执行 检查 id 是否当天已执行过、cycle 和 time 是否匹配、目标名是否匹配学生机名。
视频播放后想停止 发送 notice_stop_media。
SOP 页面打不开 确认服务端 SOP 静态服务已启动；从历史命令发送 sop_auto 或重新发送 notice_tasks.csv 会自动启动。
SOP 自动匹配不正确 检查展示页的“工位”是否为 通用、计算机名或正确前缀；必要时用 sop_show_网页文件名.html 指定页面。
SOP 浏览器没有全屏 推荐安装 Chrome 或 Edge；如果用其它默认浏览器，客户端会尽量发送 F11，但不同浏览器支持程度不同。
Office 文件无法生成展示页 服务端安装 LibreOffice 后重试；当前版本默认使用 LibreOffice 命令行把 Office 转 PDF。
屏幕演示无声音 检查 screen_audio_mode，确认教师机存在可用的系统声音或麦克风采集设备。
画面监控没有预览 确认客户端在线且允许屏幕查看，防火墙或安全软件允许程序通信；设备较多时等待一次轮巡刷新。
SYS 同传命令无法启动 确认只选中一台在线源机，源机名以 PE 开头，目标机也已在 PE 下运行客户端且名称以 PE 开头。
SYS 同传中途失败或速度不稳定 查看 server.log 中的 [SYSCAST] 记录；检查 PE 目录下四个 SYS 工具是否齐全，必要时按硬件批次分组同传。
升级客户端失败 确认 share\client.exe 是配套新版客户端、目标在线且能访问服务端 TCP 58885。普通 Windows 需有 PowerShell；下载错误记录在学生机 %TEMP%\bscx-run-error.log。手工替换前再发送 close，不要强行覆盖正在运行的文件。
老电脑 EFI PXE 已分配 IP 却返回本地系统 核对 UEFI 启动文件和网卡地址；完整 DHCP 模式下可尝试“EFI兼容”，详见第十四章。
多网卡偶发 10065 / 10038 网络错误 核对所选服务 IP 和网段。新版忽略常见临时不可达，失效套接字会尝试重建，其他错误限频记录；持续无法通信时仍需检查网卡和防火墙。
维护密码或 iSCSI 设置窗口在显示桌面后消失 新版在相关模态窗口随主窗口隐藏时取消本次对话，恢复主窗口后重新打开即可；尚未确认的操作不会继续。

二十三、命令速查表

下表汇总常用命令。命令一般不区分大小写，但参数、路径和文件名应按实际内容完整填写。命令已发送不代表操作已经成功，磁盘维护、外部程序和文件传输应以客户端提示、任务状态和实际结果为准。

命令 参数与环境 结果及主要限制
cleanup 普通 Windows 桌面 关闭客户端可识别的普通窗口，不应理解为结束全部进程。
screen_lock / screen_unlock 交互式桌面 黑屏锁定/解除；断网自动锁定另由 NetLock 控制。
internet_disable / internet_undisable 管理员权限 限制/恢复客户端外网访问；不能替代专业网络安全设备。
usb_disable / usb_enable 管理员权限 禁用/恢复 USB 存储驱动；键鼠不受影响，已挂载 U 盘可能需重插。
pc_id / label_toggle 交互式桌面 切换右上角计算机名/签到标签。
reboot / shutdown 管理员权限 立即重启/关机，无保存提醒。
close 客户端正在运行 正常退出客户端，适合升级。
dhcp 管理员权限、有效网卡 将客户端网卡改为 DHCP；过程中会离线，错误网卡选择需本机恢复。
pxe 支持 UEFI/BIOS 网启、管理员权限 设置下次 PXE 启动；需服务端 PXE 已正确开启。
start_demonstrate,地址 / stop_demonstrate 屏幕演示支持文件齐全、网络正常 开始/停止接收服务端屏幕；通常直接使用“屏幕演示”按钮。
start_kms / stop_kms 只选一台键鼠来源机 开始/停止来源机广播；stop_kms_from_client、stop_input_receive 为停止兼容命令。
stop_uftpd UFTP 接收端运行中 停止接收，不回滚已经写入的文件。
ntp / ntp_服务器 时间服务器可访问、管理员权限 无参数时与当前服务端校时，必要时临时开启本机 NTP，不保存开启配置；有参数时使用指定服务器，例如 ntp_ntp1.tencent.com。
wallpaper_文件名 文件在公共或本机专属壁纸目录 下载并设为壁纸，例如 wallpaper_abc.jpg。
wallpaper_分钟 壁纸目录中有图片 按分钟轮换，例如 wallpaper_10。
notice_now_次数_文本 交互式桌面 立即走马灯，例如 notice_now_3_集合。
notice_HH:MM_次数_文本 客户端持续运行 添加本次运行内的临时定时通知，不写 tasks.csv。
notice_tasks.csv 客户端可以访问服务端任务文件 下载并加载任务表，同时准备所需媒体。
notice_stop_media ffplay.exe 可用 停止通知系统启动的铃声、音频和视频。
checkin_班级名 个人磁盘服务可用、客户端已登录桌面 显示签到并尝试连接学生个人 H: 盘。
map_z 共享参数已正确配置 映射共享盘 Z:；账号、权限和共享名必须正确。
iscsi_IP / iscsi_unmount Windows iSCSI 组件、管理员权限 连接/断开 iSCSI；不要在有未写入数据时卸载。
sop_auto SOP 展示服务和浏览器可用 按计算机名或工位匹配页面并显示。
sop_show_页面名 / sop_close 页面已生成发布 指定显示/关闭 SOP 页面。
freeze / thaw 管理员权限；普通盘、VHD、无盘行为不同 启用/解除保护，常需重启；PE/无盘中不会直接执行普通磁盘保护。
diskflt_install / diskflt_uninstall 驱动文件齐全、管理员权限 安装/卸载 HDiskflt；测试签名和 Secure Boot 有风险。
inject / inject_* 管理员权限；普通 Windows 或 WinPE 安装、升级或修改客户端选项，完整参数见第十八章。
run_文件名 服务端 share 中有对应文件；手动发送需维护权限 下载后运行程序或按关联打开文件；run_client.exe 更新客户端并保留注入设置。
vhd_fix VHD 目录和空间正常 检查全部系统、补齐启动层与备份，清理无对应上层的无效文件。
vhd_restore_父本_new / vhd_keep_父本_new 父本可只读访问、空间充足 基于父本新建当前时间的独立版本，按命令设置默认模式；在线共享失败时提示进入 PE。
vhd_freespace VHD 数据盘可识别 把剩余空间作为状态反馈，不修改 VHD。
vhd_restore / vhd_keep 当前运行本地 VHD，或 PE 中默认项为 VHD 只切换当前版本的还原/保留模式，与 VHD 系统的冻结/解冻按钮一致。
vhd_restore_父本 / vhd_keep_父本 对应系统和菜单项存在 选择指定父本的最新版本及还原/保留模式。
vhd_restore_父本_时间 / vhd_keep_父本_时间 对应父本存在 匹配日期时间，如 1026、10260902；无匹配时切换当前版本模式。
vhd_restore_父本_roll / vhd_keep_父本_roll 有多个版本 在该父本所有版本中轮换并切换到指定模式。
vhd_wim_镜像名 镜像和引导文件存在 设置一次性维护 WIM/PE 启动。
vhd_merge_父本 最近修改的可启动版本未占用且已有备份 合并最近使用的版本并创建当前时间的新版本；属于不可逆高风险维护。
vhd_clean_all / vhd_clean_父本[_版本] 文件未占用且已有备份 删除旧版本；范围由参数决定。
sys_diskN_P[_keep] 源/目标均为 PE*，四个 SYS 工具齐全 指定磁盘/分区同传；无 _keep 会重建整盘布局。
sys_diskN_all[_keep] 同上 同传所有可传分区；all 无 _keep 风险最高。
sys_stop SYS 会话存在 停止当前源机和目标机的会话。
路径、程序、脚本、网址或批处理指令 客户端账号有执行权限 在客户端打开或执行指定内容，可能改变系统；必须先在单台测试机验证。

二十四、班班通版 Web 管控功能

本章只适用于班班通版服务端 server.exe 和班班通版客户端 client.exe。普通机房版没有网页管控入口，但不影响桌面控制台的其它功能。网页功能默认关闭。

1. 开启和访问

在 config.ini 的 [Settings] 中设置：

web_enabled = 1
web_bind = 192.168.1.10
web_port = 58443
web_tls_required = 0

保存后重启班班通版服务端 server.exe，然后在浏览器访问 http://服务器IP:58443/。web_bind 建议填写学校管理网卡地址。网页访问应限制在校园内网或学校 VPN，防火墙只允许管理人员所在网络访问。

web_tls_required = 0 适合内网的命令和设备管理。手机实时麦克风、摄像头和视频功能通常要求使用 HTTPS，并允许浏览器访问麦克风和摄像头；需要校外访问时，应由学校网络管理员提供安全的 HTTPS 和 VPN 入口，不要直接公开客户端控制服务。

2. 账户、设备和权限

首次使用时，管理员账号为 admin，初始密码请向部署管理员确认，登录后立即修改。每台已登记设备对应一个教师账户，初始密码由管理员告知。设备增加或删除后，请在网页账户管理中核对教室名称、教师账户及权限。

管理员选择单台设备后，可以查看并修改该设备的教师登录名和明文密码，也可以修改自己的密码；“全部设备”用于统一控制和授权。教师登录后只能操作自己负责的设备，只能修改自己的密码。设备离线时，网页会提示控制命令可能无法执行；网络唤醒可以对离线设备发送，但是否成功取决于主板、网卡、BIOS 和网络环境。

给教师设置操作权限：

  1. 管理员登录网页，在“控制设备”中选择单台设备，或选择“全部设备”。
  2. 在“教师操作权限”中勾选该设备允许教师使用的功能和内置命令，然后保存。
  3. 单台设置仅影响这台设备；“全部设备”会把当前勾选结果统一应用到所有已登记设备。原权限不一致时，面板先显示共同开放项，保存会覆盖各台差异。
  4. 初次使用、未设置权限及以后新登记的设备，默认开放全部教师权限，包括自定义命令。对全体的设置不会自动变成未来新设备的默认限制，新增设备后需再次设置。
  5. 保存不强制注销教师，也不主动中断现有视频或对讲。教师下次登录按新权限显示按钮；即使旧页面仍有按钮，服务端也会按最新权限校验后续操作。
可授权项目 说明
立即走马灯、定时走马灯 分别控制即时通知和定时通知。
屏幕查看、摄像头查看 可以分别授权；仅查看时不自动开放声音或麦克风。
语音喊话 / 对讲 含收听；有此权限才能单独语音或选择“同时对讲”。
文件传输、录像保存 分别授权；关闭查看权限与关闭录像权限用途不同。
教师内置命令 仅限下表范围，各项可独立开关。管理员保留完整内置命令列表。
输入自定义命令 独立开关；关闭后教师不能手工输入程序、网址或其他命令，接口也会拒绝。开放后能执行的操作可能超出内置列表，应按实际需要授权。
教师可用内置命令 对应操作
黑屏锁定、解除锁定 screen_lock、screen_unlock，两个动作分别授权。
禁用外网、开启外网 internet_disable、internet_undisable。
禁用 U 盘、开启 U 盘 usb_disable、usb_enable，不是关闭所有 USB 键鼠。
标签开关 pc_id，切换设备编号或签到姓名标签。
重启、关机、网络唤醒 分别授权；唤醒还需要硬件和网络支持。
清理窗口 cleanup。

例如只允许班主任发通知、查看教室画面，可以开放走马灯和相应查看权限，关闭自定义命令、对讲、文件传输、录像以及不需要的内置命令。同一教师管理多台设备时，每台按自己的授权校验。等待执行的定时走马灯和文件队列也会重新检查权限；已送达的通知和文件无法撤回。

权限保存在 web_control.db，重启后保留。桌面控制台的维护密码、SMB 访问账户和网页教师权限是不同的设置入口；修改网页权限不会修改 SMB 文件夹权限。

3. 网页操作

选择单台设备后，管理员或获得相应授权的教师可以使用：

功能 使用方法和限制
走马灯/通知 输入内容后立即发送，也可以设置发送时间。
锁屏/解锁 控制所选设备的屏幕；设备离线时不会自动补发。
远程命令 教师只显示获准的上述内置命令；另有自定义命令权限时，才可手工输入批处理、程序路径或网址。
网络唤醒 设备关机或待机时尝试开机；主板、网卡和网络必须支持远程唤醒。
文件发送 先上传到服务端，再发送到所选设备；默认保存到 C:\，可指定其它已存在且可写的路径。状态会显示排队、准备、传输、完成或失败。
屏幕查看 只能查看单台设备，默认显示屏幕画面，不要求安装摄像头。客户端必须在线并允许屏幕查看。
摄像头查看 单台设备可切换摄像头；设备必须安装并启用摄像头，没有摄像头时无法显示。
手机语音对讲 选择单台设备后，允许手机浏览器使用麦克风即可讲话；手机通常需要 HTTPS。
录像 可把当前视频会话录制并保存到服务端的 share\web_recordings 目录，需预留足够磁盘空间并按学校制度清理。

管理员选择“全部设备”时，不显示单台教师登录名和密码，也不显示单设备视频区域；走马灯、锁屏、远程命令、语音和文件发送面向全部在线设备，教师权限设置则作用于全部已登记设备。教师只能切换其获准管理的设备。上传文件按队列处理，多个大文件会依次发送；浏览器显示“完成”后仍建议检查目标文件是否存在。

4. 设备和规模要求

班班通客户端应运行在有人登录的 Windows 桌面中，屏幕查看才有画面；摄像头查看要求设备有可用摄像头，语音对讲要求手机和设备都允许音频访问。屏幕查看采用低频画面刷新，适合日常巡检；需要连续流畅画面时，网络和电脑负载会明显增加。

普通命令、心跳和少量单设备视频适合约 100 台设备的校园部署。100 台同时进行视频、语音、录像和文件发送不作性能保证，实际能力取决于服务端电脑、网络带宽、浏览器数量和设备性能。部署前应按学校实际设备数量做压力测试，并分时执行大批量文件或媒体任务。

5. 网页安全要求

  1. 网页只开放给学校内网、VPN 或受控的安全入口，不建议直接暴露到互联网。
  2. share_pwd 和网页管理员密码不能长期使用示例值；配置文件和录像目录应限制普通用户访问。
  3. 远程命令可能执行关机、重启、磁盘维护或自定义脚本。管理员发送前必须确认设备范围，教师账户只分配实际负责的教室。
  4. 录像、麦克风和上传文件可能包含学生影像、声音或个人资料，应按学校制度设置访问权限和保存期限。

二十五、答题卡考试、阅卷、统计与课堂互动

两版均支持。考试采用“原试卷页面 + 电子答题卡”方式：老师可以直接使用极域 ASTP 试卷，或导入 PDF、Word、图片后配置答题卡。客观题按标准答案自动评分；简答、手写题由教师按答题要点人工评分，当前版本未接入 AI 阅卷。

1. 安装考试组件

将独立考试包中的 exam 文件夹复制到服务端同级目录：

部署目录\
  server.exe
  config.ini
  exam\  （保留考试包内的全部配套文件）

服务端、客户端及考试包请使用同一发布包中的配套版本。学生机无需单独安装考试包。

导入 Word 试卷时，请在教师机安装 Microsoft Word 或 LibreOffice；也可以先将 Word 另存为 PDF。学生机需要可用浏览器，推荐 Edge、Chrome 或 Firefox。

考试服务默认使用 TCP 58444，班班通网页管控使用 58443，两者互相独立。学生机须能访问服务端所选管理 IP 的考试端口。服务启动时会尝试添加仅允许本地子网的考试端口防火墙规则；使用自定义防火墙时须允许相应端口。

制卷平台访问： 在教师机点 EXAM 的“制卷平台”，直接打开教师网页；局域网其它电脑可打开 http://教师机IP:58444/teacher，输入服务端 [netshare] 的 share_pwd 登录，登录有效期 8 小时，可主动退出。空密码不开放远程登录；修改密码后重启考试服务或服务端生效。该密码授予试卷、评卷、学生名单和教学记录的管理权限，请只交给可信教师，不向学生公开。

本机打开网页时仍使用本机文件对话框。其它电脑访问时，从浏览器上传该电脑上的试卷或收卷文件，保存、另存为通过浏览器下载到该电脑；修改评分还会保存到教师机的收卷档案。教师网页不提供远程浏览教师机磁盘的入口。

2. 一次考试的操作顺序

服务端 EXAM 上方为两行考试控件和一行课堂互动控件，下面复用考试/互动列表，底部为一行简短状态；窗口放大后三行一起扩展：

班级 [临时班级 ▼]   选卷    时长 [30] 分    可交卷 [15] 分
开考    收卷    评卷    下发    制卷平台
题型 [签到 ▼]   时长/答案/人数 [ ]   开始 公布    归档/导出 结束
                  考试 / 互动列表
                    状态提示

操作流程：选择班级并签到（可选）→ 制卷平台制卷并保存 → 选卷 → 设置两个时长 → 开考 → 收卷 → 评卷 → 下发。已经有试卷时直接选卷；纯客观题考试可直接使用自动评分结果。讲评结束后再次点击“收卷”，关闭成绩展示并恢复初始页面。

步骤 操作和效果
制卷平台 打开教师网页，导入或编辑试卷，保存为 .paper；也可维护学生名单、查询教学记录。
选卷 用文件浏览框选择任意位置的 .paper 或 .astp；原始 PDF、Word、图片需先在制卷网页配置答题卡。
时长 自动采用试卷预置值，可改为本场时长，范围 1～1440 分钟，不修改原试卷默认值。
可交卷 每名学生登录后至少答题多少分钟才可主动交卷；默认是考试时长的一半，步进 0.5 分钟，0 表示不限制，不得超过考试时长。手工修改后不再随时长自动调整。
开考 主设备列表有选择时安排所选设备；没有选择时安排当前管理范围内的已知设备，包括离线设备。
收卷 任何状态下确认后清空当前试卷、考试列表、状态及成绩，恢复默认时长并停止刷新、补发。有进行中考试时在后台收卷保存，随后通知管理范围内设备关闭试卷/成绩展示。已保存的试卷、答卷、评分保留。
评卷 浏览选择本次或以前的 .exam，在教师网页评卷、统计。
下发 浏览选择 .exam，把个人答卷和成绩发送到当前范围内的在线设备；可以选择以前的考试，不需要重新开考。

EXAM 不列出试卷库。教师网页提供“制作试卷、评卷、统计分析、学生名单、教学记录”；开考、收卷和结果分发统一在服务端操作。

班级名单、实名签到与教学记录

导入名单： 在“制卷平台 → 学生名单”下载模板，将 Excel 名单另存为 CSV 后导入，也可粘贴表格。字段为学号、姓名、性别、班级。可按班查看、编辑、添加、删除学生，或删除整班、清空名单。学号按文本保存。同班姓名必须唯一；遇到重名请由老师将姓名改为“张三甲、张三乙”等固定标识，并告知学生以后使用该姓名签到。名单核对不能代替证件或现场身份核查。

开始上课： 班级框默认“临时班级”。选择正式班级后，题型选择“签到”，时长可选 5、10、15 分钟，默认 5 分钟，点第三行“开始”。学生机弹出置顶、不可最小化的签到窗口，提示“请准确输入你的真实姓名”，并可反馈键盘、鼠标或显示器故障。正式班级按名单姓名核对，不以学号签到；同名标识按老师提供的名单填写。

老师可随时查看已到、未到和故障反馈，结束时列出未到姓名。已签到设备短暂掉线后恢复姓名和个人磁盘；同一学生以最后一次成功签到的设备为准，原设备解除身份。需要换机重签时，选中目标电脑再开始签到。更换班级须确认，会解除上一班的签到和个人磁盘连接；考试进行中不能换班。

命令签到： checkin_七年级1班 如果班级在名单库中，就选择该班并开始签到；如果班级不存在，班级框显示“七年级1班（临）”，按临时名单签到。个人文件仍在 share\七年级1班\姓名，不会统一放进“临时班级”目录。未指定班级名时，个人文件和签到 CSV 保存在 share\临时签到。

临时班转正式班： 签到完成后点“归档”，确认创建班级并保存本次签到；未指定班级时填写新班名，已指定临时班名则使用该名称。新学号按实际签到先后从 1、2、3… 编号，性别默认 男，可在网页名单里修改。成功后班级名去掉“（临）”。本节课保留个人文件的原目录，避免搬动已打开文件；下一次上课使用正式班级目录。

按需归档： 正式班的签到和课堂互动只有点击“归档”才计入长期教学记录；未归档的签到仍在对应共享目录生成 CSV。临时班的互动按钮为“导出”，用于保存本轮 CSV；临时签到点“归档”时也可选择只导出、不建班。已开始的正式班考试及评分更新会进入班级教学记录，单纯选卷不会生成一场考试记录。临时班的考试和互动可继续使用原来的文件、CSV 流程。

查询与汇总： “制卷平台 → 教学记录”可按班级、学生、时间和类型查询签到、互动、考试及学生汇总，导出明细或汇总 CSV 供 Excel 处理。签到保留当时的计算机名、MAC、IP、签到时间和设备反馈，便于追查；后来的心跳改名不会改写已保存快照。可删除不需保留的整场记录，已有收卷文件和个人文件不会随之删除。日常请备份教学数据和收卷文件；更换教师机前保留原有教学资料。

教师端重启后恢复签到

签到过程会保留本节课的运行记录，正式班和临时班都适用。教师端意外退出后，保留原考试数据和共享目录重启；启动恢复时，若有创建于最近 2 小时内、尚未结束的签到课次，并且当前管理范围内的在线设备 MAC 或上报签到姓名与之匹配，会自动选回最近匹配的课次，恢复班级、签到显示和个人磁盘服务。已经签过到的设备按记录恢复，未完成者按原签到期限继续处理，重启不重新赠送一轮签到时间。

请等待客户机重新上线。没有匹配的在线设备、课次超过两小时、或已经主动结束/换班时，不自动恢复，教师可重新选择班级开始签到。此功能用于同一教师端短时中断，不能代替长期“归档”，也不能把任意个人文件夹当作学生已到的证明。数据库与个人文件均应保留。

课堂互动：举手、点名、判断、选择和填空

老师口述题目或通过大屏、屏幕广播展示题目，在 EXAM 第三行选择题型、设置答案或人数，然后点“开始”，无需制作试卷。教师端、学生端及考试组件须使用配套的 4.3 版本。签到的使用方法见上一节。

先确定范围： 主客户机列表有选择时，只面向选中的在线设备；未选中时，面向当前管理范围内的在线设备。“只管本班”开启后仅包含本班成员，PE 和临时 PXE 设备不参与。本轮名单在开始时确定；后来上线的新设备需重新发起一轮，本轮已有设备短暂掉线后可恢复互动。

题型 教师设置 学生操作和结果
举手 选择“举手”，点“开始”；答案框不使用。 姓名或计算机名标签下出现“举手”按钮，再点可取消。客户机名前显示手势与顺序号，EXAM 列表按收到举手的先后排列，最先举手者高亮。取消后重新举手获得新编号。
点名 答案框自动变为人数，默认 1人；可选或手工输入 2、3人 等，再点“开始”。 抽中者右上角显示“有请 张三”（未签到时显示计算机名），闪烁约 4 秒，客户机列表同步标记。连续点名优先抽未抽到的人，全部抽过后进入下一轮；结束或开始其它题型后重新计算。
判断 预设 √ 或 ×；选“不设”时仅统计。 学生点击 √ 或 × 作答，公布前可改选。
选择 从全部 15 种组合中选择正确答案，也可手工输入；单字母为单选，多字母自动采用多选。 多选时学生可连续点击 A～D，再点已选项可取消。公布前可修改；必须与正确答案完全一致才判对，漏选、多选均判错，顺序不影响结果。
填空 在答案框输入文字；多个可接受答案用空格或 [#] 分隔。留空时仅收集回答，不判对错。 学生输入文字后点“提交”或按回车，公布前可修改并重新提交。公布后与任一预设答案完全匹配即判对，忽略首尾空格，区分英文大小写。

选择题预设完整组合为：A、B、C、D、AB、AC、AD、BC、BD、CD、ABC、ABD、ACD、BCD、ABCD。例如预设 AC，学生选 A+C 为正确，只有 A 或选 A+B+C 均为错误。“不设”用于无标准答案的单选调查；没有单独的“多选”答案项。

填空示例：北京 北平 或 北京[#]北平 都接受“北京”和“北平”。答案本身含空格时使用 [#]，例如 New York[#]纽约；这时内部空格保留。多个预设值是同一填空的不同可接受答案，不是要求学生依次填写多个空。每个答案和学生输入最多 200 字，教师预设总长最多 1000 字。

公布与统计： 判断、选择、填空点“公布”后锁定本轮作答；有预设答案时两端显示对错。客户机列表显示简短标记，填空完整回答显示在 EXAM 列表；点击列标题可排序。底部显示参与、已答、未答及选项人数和比例，公布后补充对错人数。选项比例以已答人数为分母，多选时比例合计可能超过 100%。举手顺序按服务端实际收到的时间统计，受网络延迟影响。“待客户端确认 / 未确认”表示尚未收到响应，请检查连接和版本。

归档 / 导出： 正式班点“归档”，保存本轮结果供以后按学生、班级查询；临时班点“导出”保存 CSV，包括未回答设备，顺序与 EXAM 列表一致。表格包含时间、题型、计算机名、签到姓名、MAC、IP、状态、回答、对错、预设答案及举手顺序。CSV 可直接用 Excel 打开；未公布或未设标准答案时，对错栏留空。归档或导出不会结束或锁定互动；请在“结束”、另开一轮、选卷或退出软件前保存需要的结果。

班班通人数统计示例： 管理员选择各班在线设备，题型选“填空”，预设答案留空，点“开始”；通知各班班主任填写实到人数，如 42 或 0，然后提交。管理员核对已答、未答情况后点“导出”，用 Excel 对“回答”列求和，并用计算机名或签到姓名对应班级。收集意见同样操作，班主任填写文字即可，每条最多 200 字。仅本轮开始时纳入的在线设备列入导出表，未参与本轮的班级需另行核对。

结束： 互动行的“结束”清除本轮状态和学生端互动控件，保留已打开试卷；签到模式时结束签到。“收卷”负责考试收卷、试卷和成绩画面清理。互动结果不写入考试收卷文件，正式班点击“归档”后单独保存为教学记录。选卷、开始考试或分发成绩会结束当前互动；考试进行时互动整行禁用，收卷后恢复。

学生端持续约 90 秒联系不到本轮服务端时，会自动撤下互动控件。互动期间若要调整“只管本班”的范围，先点互动“结束”。

3. 每台机器从登录成功起独立计时

点考试行“开考”仅安排发卷。正式班考试复用已核对的签到身份，未签到者先按名单姓名核对；临时班保留原有姓名登记方式，学号可留空，留空时使用计算机名。停留在登记页面时不计时，成功登录即开始个人计时。

例如时长 30 分钟，甲 9:00 登录则 9:30 收卷，乙 9:08 登录则 9:38 收卷。已安排但晚开机的电脑，上线后收到试卷，也从成功登录开始计时。登录后的断网、刷新、退出重开不会暂停或重新计算时间。

老师可在考试过程中再次点考试行“开考”，按当前主设备列表的选择范围重新发送同一场试卷：漏进的设备可再收到入口，新加入设备从登录起计时，已参加设备保留原答案和截止时间，已收卷设备不会重新开考。要组织下一场考试，先收卷，再选卷开考。

EXAM 列表显示设备/姓名、个人状态和剩余时间、已答题数、对错及已评分小计/待阅数量。每台到时自动交卷；所有安排设备均完成后自动结束场次。仍有未上线或未登录设备时，整场可能继续等待，老师可点“收卷”结束。

只打开了试卷但不想考试、考试已自动结束，或分发讲评结束后，也可点“收卷”恢复“未打开试卷”，旧的刷新或发卷任务不会重新填回列表。请使用配套客户端，以便关闭成绩展示；仅关闭本软件管理的考试浏览器/窗口，不关闭学生的其它浏览器或 SOP。正在进行的课堂互动使用第三行“结束”单独清理。

清场遇到考试服务、保存路径或通知错误时，仍会清空面板，并弹出未完成项；此时不能视为收卷保存或学生关窗已经成功，请排除错误后再点“收卷”重试。已有答卷和评分不会删除。断网设备无法立即接收关闭通知，可恢复连接后再次点击；已成功收卷的考试，客户端恢复连接后也会从考试服务取得已收卷状态并退出。

4. 学生作答、交卷和防退出

学生页顶部只保留姓名、试卷与计时信息和交卷按钮，主体显示试卷和答题卡；可按题号定位。未达到可交卷时长时交卷按钮不可用，服务端也会拒绝提前提交。达到时长后主动交卷需连续确认两次；自动到时和教师强制收卷不需要学生确认。

考试全屏窗口由客户端维护置顶，并在考试窗口内拦截 Esc、F11、Alt+F4、Ctrl+W 等常见退出键；每 10 秒检查并尝试唤回已关闭或失去前台的窗口。重新打开同场考试会恢复身份、答案和原计时。考试控制依赖客户端、浏览器和系统桌面环境，不能屏蔽系统安全快捷键或管理员强行结束进程。

交卷确认、个人到时或强制收卷后，客户端通常约 3 秒内退出考试专用浏览器及其子进程；如果使用的默认浏览器不能创建独立进程，则只关闭识别出的考试窗口，避免结束学生原有页面。查看已下发结果时不锁定窗口，也不自动退出浏览器。

5. 制作和编辑试卷

  1. 点“制卷平台”，在网页选“导入 PDF / Word / 图片 / ASTP”，或“打开试卷文件”。导入 PDF、Word、图片只生成页面，不会自动识别题目和标准答案，须继续配置答题卡。
  2. 填写名称、默认时长；需要时用“追加试卷页”加入其他页面。
  3. 在“批量生成答题卡”选择题型、数量、每题分值，再添加题目。分值以 0.5 分调整；分组名留空会生成“一、选择题（共 10 题，每题 2 分）”等标题。
  4. 核对每题题号、分组、分值和标准答案；选择题可设置选项数量、单选/多选及漏选给分规则。简答、手写题填写参考答案或答题要点，供人工阅卷。
  5. 新题号按位置错开；可点“错开题号位置”，也可在右侧选中题目后点击原卷页面手工定位。需要时重新连续编号，或打印空白答题卡。
  6. 保存试卷，推荐 .paper；“另存为”可选其他位置。开考时会保存本场试卷快照，随后编辑原卷不改变已经开始的考试。
题型 设置及评分规则
单选 / 多选 答案如 A、A,C；默认选项集合完全一致得满分，顺序无关。可选择漏选按比例给分、错选零分。
判断 在界面选择正确或错误。
填空 各空以 | 分隔，同一空允许的不同答案以 [#] 分隔，如 at[#]AT | on[#]ON；按所列答案匹配，不推测同义词。
简答、手写 / 绘图 按教师答题要点人工评分，可填写评语。
缺少标准答案的客观题 标为人工评分；开考前应检查，不能将“待阅”当成已经判错。

6. 极域 ASTP 兼容范围

支持极域 V6.0 的 PTSA v3 答题卡试卷，保留页面、题号、分组、位置、分值和答案。已验证“模拟一.astp”（5 页、44 题、150 分）、“模拟五.astp”（6 页、45 题、45 分）及极域示例答题卡；模拟五第 42～45 题缺标准答案，导入后需人工阅卷。

可以导入和导出 .astp。极域选择题默认允许多选，可在本模块重新调整。BSCX 的单选限制、漏选给分等扩展评分设置建议保存为 .paper；导出 ASTP 时不能保证这些扩展规则仍完整保留。其他 ASTP 格式版本不支持。导入后请使用配套的 BSCX 教师端和学生端组织考试，不支持导入极域历史收卷记录。

7. 阅卷、统计和分发历史结果

收卷后点“评卷”，选择 .exam。网页“评卷”中选学生答卷，对照参考答案填写人工分数和评语，点“保存人工评分”；上一份、下一份用于连续评阅。保存会写回当前收卷文件，需保留未修改的版本时先“另存为”。

客观题已有自动成绩；主观题未评分时显示“待阅”，可以先分发自动评分结果。结果发布后仍可补评，已经打开的结果页会更新。最终统计仅计入已交卷且完成评分的答卷，缺考、待阅和零分分别处理。统计页提供分数分布、平均分、中位数、及格率（总分的 60%）、逐题正确率、得分率、未答人数和选项人数，可导出成绩/逐题 CSV 或打印为 PDF。

分发旧场次结果前，建议先发送本班签到，让学生使用与考试时一致的姓名；再在主设备列表选择范围，点“下发”选择对应 .exam。匹配规则如下：

  1. 有签到姓名且只匹配到一份历史答卷时，按姓名分发，学生换座也能收到本人的答卷。
  2. 同名答卷有多份时，只在这些同名答卷中再按 MAC 匹配；仍不能唯一匹配则跳过并提示教师，不随意分配。
  3. 没有签到名或该姓名没有答卷时，按原考试设备 MAC 匹配；无匹配则提示处理。

结果页以红色大字显示所得分数，错题、未答题的题号导航、答题区域及试卷标记明显标红，部分得分以橙色区分。当前结果分发只发送给所选范围内的在线设备，晚开机的设备需要老师再次分发。

8. 文件保存、转移和中断恢复

文件或目录 用途和保存方式
试卷名_标识.paper 试卷页面、题目、答案和评分设置；新卷默认保存到服务端同级目录。
年月日_时分秒_试卷名_标识.exam 按收卷时间命名，包含本场试卷快照、学生身份、答案、收卷记录和人工评分；默认也在服务端同级目录。
exam\data 考试组件目录内的数据，包含 exam.sqlite3、试卷资源、学生名单、签到运行状态和教学记录。结束考试并停止考试服务后备份整个目录；只复制 .paper / .exam 不会带走完整班级历史。源码运行时对应 exam_module\data。

打开其他目录的试卷、收卷文件后，保存会写回该文件；也可另存为。.paper 和 .exam 可复制到另一台服务端打开，无需手工配套复制页面图片。不要把含标准答案及全班答卷的文件放入学生可访问的共享目录。

升级与迁移： 新版将数据放在 exam\data，随考试组件一起备份或移动。首次升级时，若此处没有数据库，会尝试从原用户 %LOCALAPPDATA%\BSCX\Exam 中本安装位置对应的旧实例迁入名单、签到、成绩及试卷资源，保留旧目录作为备份；不会把不同实例的库自动混合，也不覆盖已有 exam\data。请先在原安装位置、原 Windows 用户下完成这次迁移，再复制到新电脑；旧考试仍进行中时须先收卷。迁移后还需保留 share 中个人文件和单独保存的试卷/收卷文件，更新考试包时保留原 data，不要整目录删除重装。考试目录须可写，数据不要放入学生可访问的共享目录。

答案实时保存到服务端；断线时浏览器暂存并自动补传，应留意“已保存到服务器”提示。计时以服务端为准，截止后才传来的本地答案不能覆盖已收卷记录。考试中不要清理浏览器数据、还原系统或移动考试模块目录。

考试期间保持服务端运行，才能自动给后来上线的已安排设备发卷。重启服务端后会恢复当前场次安排；退出主窗口时仍保留正在运行的考试服务，已领取试卷的设备继续计时和收卷。连续 90 秒联系不到考试服务时，客户端会暂时解除窗口限制；恢复连接且仍未收卷时继续考试。跨电脑转移考试时，请先收卷并确认 .exam 文件已保存，不要在考试中直接迁移运行目录。

9. 更新软件与考试包

先结束考试并保存答卷，退出服务端，再按新版软件包说明替换主程序及完整 exam 文件夹。涉及学生端更新时同步更换配套客户端。保留 .paper、.exam 和原有配置，先用一台学生机验证开考、收卷及查看结果后再批量更新。

10. 考试常见问题

现象 处理方法
EXAM 提示模块缺失或服务未就绪 检查考试包是否完整、端口 58444 和防火墙是否放行；保留故障提示联系技术支持。首次启动稍等后重试。
学生没有进入试卷 确认设备在本场安排范围、客户端已更新且在线；重新选择它并点考试行“开考”，原答卷和截止时间保留。
登录框还未填写，列表没有倒计时 正常；从学生成功登录才计时。有签到名自动登录时会立即开始。
学生不能主动交卷 检查“可交卷”时长是否达到；教师随时可强制结束整场。
都考完了但仍显示考试中 可能还有已安排但未登录/未上线设备，点“收卷”完成本场并保存文件、恢复初始页面。
试卷已导入却没有题目或正确答案 PDF、Word、图片不做自动题目识别；先配置答题卡。ASTP 缺答案的题目需补全或人工评分。
Word 导入失败 在服务端安装 Word/LibreOffice，或先转 PDF；检查文件本身能否打开。
结果无法匹配或换座后显示异常 核对当前签到名、同名学生与原 MAC、所选考试日期；同名且换座无法唯一匹配时由教师在阅卷页核查。
分数偏低且有“待阅” 先完成人工评分，已评分小计不等于完整最终成绩。

二十六、C 转 VHDX 与离线 Windows 优化

1. 功能选择

以管理员身份运行 C转VHD.cmd，选择功能：

菜单 用途
1：Build VHDX from current Windows C: drive 热克隆当前系统分区，制作动态 VHDX；包含与选项 2 相同的完整组件及临时文件清理，再处理启动和网卡配置。
2：Optimize Windows on a selected partition offline 直接处理指定分区中未运行的 Windows，注入网卡驱动、清理体积和调整 iSCSI 启动配置，不新建 VHDX，不重新分区。
3：Build VHDX from offline Windows in PE (no PowerShell) 在 PE 中选取未运行的 Windows 分区，创建 VHDX、复制系统、离线清理并修复引导；不需要 PowerShell。

选项 1 要求 64 位 Windows 10 1607（Build 14393）及以上、Windows 11 或 Server 2016 及以上，使用 PowerShell；选项 2 也需要 PowerShell 和可用 DISM。选项 3 供没有 PowerShell 的 PE 使用。请保持制作工具包及配套文件完整；离线处理不能选择当前正在运行的 Windows。

C 转 VHD 所需的 imagew.exe 需用户自备，放入 share 目录。

2. 热克隆制作 VHDX

把目标机所需网卡驱动解压到脚本同级 VHD_NIC_DRIVERS，可保留子目录及 INF、SYS、CAT 等配套文件；只放安装 EXE 不能注入。没有驱动时工具依赖镜像已有驱动，换机型仍可能缺少可启动网卡驱动。

选择菜单 1，核对源系统、输出路径、容量及驱动信息后确认。虚拟容量为源系统分区总容量 + 350 MB，并非已用空间加 350 MB；动态文件在实际写入后增长。工具自动安排 EFI 和 Windows 分区，不需要再手工追加 EFI 分区。

这里制作的 VHDX 不包含 20 GB 的 W: 分页分区。W: 是以后自动部署本地 VHD 时，在客户机实体硬盘上创建的独立分区。因此约 30 GB 本地硬盘可能够整盘克隆，却不够当前本地 VHD 部署布局。

输出不能放在正在热克隆的源系统盘；本地输出使用 NTFS，网络输出支持可写的 SMB 共享，映射盘会尽量转换为 UNC。请等待工具报告制作完成，并保留输出文件旁的 .build.txt 制作报告。处理对象是制作出的系统副本。

完成后在服务端 VHD/SMB 的 iSCSI 单机无盘设置中选择制作好的 VHDX，按界面配置目标和启动菜单，再用一台对应网卡的客户端试启动。制作成功不代表所有网卡、存储驱动和固件组合都已验证。

3. 只处理指定 Windows 分区

选择菜单 2，输入列表序号或分区路径，例如 Z:\、Z:\Windows。核对目标确实是待处理的离线 Windows 后确认。工具会使用同一个 VHD_NIC_DRIVERS 目录注入驱动，执行可用的 DISM 组件清理，清理临时目录、更新下载缓存、休眠和分页文件，并处理 iSCSI/网卡启动配置。此模式默认禁用目标分页文件；它直接修改所选系统，不是只分析。

操作前请备份目标系统。完成后保留屏幕提示的备份位置和 offline-optimize-日期时间.txt 处理报告，发生问题时提供给技术支持；工具生成的设置备份不能代替完整系统备份。

4. PE 下将离线 Windows 制作为 VHDX

当前系统热克隆遇到卷影锁定等问题时，可重启进入配套 PE，运行 C转VHD.cmd 选 3。此方式使用 DiskPart 和 PE 自带的离线维护、引导工具，不调用 PowerShell；PE 应包含 DISM、BCDBoot、BCDEdit、REG、FINDSTR 及所需复制组件，不能只有一个精简版 DiskPart。

  1. 确认原 Windows 已关机，选择包含 Windows 目录的实际盘符；PE 中它不一定是 C:。不要选择当前 PE 的 X:。
  2. 指定输出 .vhdx 路径，放在源 Windows 分区以外、容量足够且可写的磁盘。不要放入 PE 内存盘；同名输出已存在时先更名或备份，工具不会直接覆盖。
  3. 容量建议使用提示的安全最小值或更大，依据源分区总容量及 EFI/对齐余量计算，不能只按已用空间填。工具创建 GPT、EFI 和 Windows 分区，复制后扩展 Windows 分区利用预留空间。
  4. 需要补充目标网卡驱动时，将完整驱动放入同级 VHD_NIC_DRIVERS。等待复制、离线清理、引导修复和卸载全部完成，保留输出旁的 .build.txt 报告。

组件清理可能明显慢于复制，尤其在更新较多的 Windows 上。看到“Cleaning the offline image”时先查看当前进度和报告，不因数分钟无新文字就强制关机。源 Windows 分区不作离线优化，清理和启动调整针对制作出的副本。

5. 启动及清理故障排查

现象 处理方法
0x7B / INACCESSIBLE_BOOT_DEVICE 核对目标网卡驱动、iSCSI 目标和权限、网络链路及 iPXE 配置；优先准备目标型号的网卡 INF，再离线处理。
Win11 停留在 booting… 很久，最终可以进入桌面 先区分 iPXE/固件读取阶段与出现 Windows 标志后的启动阶段，检查链路速率、丢包、目标存储读取和安全软件扫描。某些 Win11 镜像明显慢于 Win10，文件大小不能直接推算启动时间；仅更换 iPXE 文件未必改善，不应把等待时间长直接当作 7B 或反复删除系统组件。
wanarp.sys / DRIVER_PORTION_MUST_BE_NONPAGED 保留原镜像，使用最新制作工具的菜单 2 处理副本后，在一台测试机验证；仍失败时提供停止代码和网卡型号。
DISM 0x800f0806 表示目标有待完成的更新。工具跳过组件清理并继续启动优化；不会自动撤销更新。需要清理组件时，先让目标系统完成更新并正常关机后再处理。
离线注册表卸载拒绝访问 关闭其他正在操作该离线系统的工具后重试；仍失败时保留报告，联系技术支持，不连续强制操作。
EFI/Windows 分区挂载超时、盘符已占用 新版会等待挂载并避开已用盘符；仍失败时检查共享稳定性、挂载状态和盘符占用，不手工再建一份 EFI 分区。

遇到蓝屏应记录准确停止代码、失败驱动、网卡型号和制作报告，再判断是驱动还是启动链问题；本工具减少常见故障条件，不保证任意硬件均可无盘启动。

二十七、无盘本地化、整盘克隆与 PE 分区复制

1. 选择适合的本地部署方式

两版均支持。在服务端 VHD 库中选择系统，打开“iPXE-VHD 无盘启动”，在“无盘启动成功后自动处理本地硬盘”中选择一种方式。默认不处理本地硬盘；仅需无盘使用时保持默认。

选项 结果及适用场景
自动无盘部署到本地 VHD 建立本地父本、更新层、启动层、还原副本和菜单，适合继续使用本地 VHD 多系统及还原功能。
自动从无盘更新本地 VHD 指定已有父本名，保留原父本和旧层，建立新日期更新层及启动层，比较复制系统变化。
自动部署到本地 Windows（保留分区） 覆盖本地已有 Windows 分区，保留其他分区；修复本地启动，不生成 VHD 文件。
自动部署到本地 Windows（重新分区） 清空所选硬盘，新建 GPT/EFI、MSR 和与源系统分区等大的 Windows 分区，余量建立数据分区。
自动部署到本地（整盘克隆） 将源虚拟磁盘的全部分区克隆到一块本地硬盘，随后修复 Windows 启动和分页文件。目标原有全部内容会被覆盖。

整盘克隆复制的是虚拟磁盘内的完整分区布局，不是在本地保存一个 VHD 文件。目标容量必须不小于源虚拟磁盘的总容量，不能只看已用空间；复制时会按目标容量调整支持扩展的分区及对齐。需要自动将剩余空间建成独立数据盘时，选择“重新分区”方式。

本地 VHD 的容量要求更高：新布局包含约 300 MiB 引导分区、20 GiB 的 W: 分页分区，以及存放 VHD 的 SYS_DATA。SYS_DATA 至少按源 Windows 分区总容量加约 350 MiB 计算，并预留 2 GiB 启动余量。例如源 C: 约 29.38 GiB 时，整块本地硬盘至少约 52 GiB；约 30 GiB 的硬盘应考虑容量合适的整盘克隆。程序会在清盘前检查容量，不能以动态 VHD 当前文件小或 C: 已用空间少来代替容量要求；更多系统和更新层还需额外空间。

Windows 本地化要求 UEFI 启动和可识别的 GPT/EFI 源或目标布局。客户机应有配套的新版本客户端及部署组件；无盘源系统建议用新版 C 转 VHD 制作。无法确认源盘、目标盘、必要工具或空间条件时会停止并提示。

2. 自动选盘、覆盖范围与命名

VHD 模式优先复用包含指定父本的合格磁盘，其次复用已有完整 VHD 分发布局。需要选盘时，在可用且容量足够的本地硬盘中按原有 Windows 系统盘、NVMe、普通固态、Disk 0 的顺序优选；不选择 iSCSI 源盘、USB 盘、当前运行系统盘或承载运行工具、分页文件的磁盘。库内“发送此文件到学生机”和“开始分发”也会先在服务端提示可能重新分区及数据丢失，确认后才通知客户机准备接收。

已有合格 VHD 布局时不重新分区：同名父本会连同它的旧更新层、启动层和还原副本一起替换；没有同名父本则新增，保留其他系统。更新模式必须找到指定父本，不会自动改为清盘部署。

同名替换前会提示并倒计时，取消后保留原文件。为防复制或引导修复失败导致原系统丢失，会先制作新父本，完成新版本和引导后再清除旧父本及旧层；失败时保留原版本或恢复原文件。因此替换时需要额外的暂存空间。

无盘部署、无盘更新，以及 PE 下通过 iSCSI 部署/更新 VHD，结束时都会自动完成本次版本的 VHD 修复：设置 W 盘分页文件、写入系统名称/IP 配置、修复引导、创建更新层（新部署时）、启动层和还原备份，并更新启动菜单。只有复制和修复均成功才报告部署成功，无需再手工发送一次 vhd_fix。

分区或挂载后会等待磁盘信息刷新，减少慢速电脑误判。新部署遇到确实不完整的 VHD 布局时，会重新显示清盘倒计时，未取消则重新分区；更新模式仍不会清盘。

清盘、替换父本、整盘克隆或覆盖实体分区前，客户端显示目标磁盘型号、容量和 15 秒倒计时，可取消。保留分区只表示保留布局，不表示保留目标分区中的文件。操作前先确认设备范围及目标数据备份，建议首先测试一台。

倒计时尚未结束时，也可由服务端对目标客户机点击 清理窗口，取消这些机器的后续部署并反馈取消状态。该操作不撤销已经完成的步骤，也不是正在写盘时的强制停止按钮。

首次作为无盘 Windows 上线且服务端尚未保存该 MAC 时，按名称前缀及起始 IP 自动命名。例如前缀 Stu、起始 IP .101，则 .101 为 Stu001，.102 为 Stu002。只改机名，保持 DHCP，不重置网卡；等客户机回报新名称再开始自动本地化。已有保存机名的设备沿用保存名称。序号跟随实际获得的 IP，不保证其他 DHCP 服务器按开机时间顺序分配地址。

3. 在 PE 中从 iSCSI 源盘部署

先让客户机进入配套 PE，在服务端选中目标设备，解锁维护权限后发送命令。将示例中的 IP 换成提供 iSCSI 磁盘的服务器地址；Win10 表示本地父本名。

命令示例 作用
iscsi_192.168.0.1 仅连接远程磁盘，保持原来的挂载功能。
iscsi_192.168.0.1_vhd_Win10 新增或替换本地 Win10 VHD 父本，并生成更新层、启动层、还原副本及菜单。
iscsi_192.168.0.1_vhd_update_Win10 更新本地 Win10，原父本及旧版本保留。
iscsi_192.168.0.1_sys 保留布局，将源 Windows 复制到本地已有 Windows 分区。
iscsi_192.168.0.1_sys_new 重新分区部署实体 Windows，剩余空间建立数据分区。
iscsi_192.168.0.1_clone 将整个 iSCSI 源磁盘克隆到优选的本地硬盘，覆盖该盘全部内容。
iscsi_192.168.0.1_1to2 将源盘第 1 分区复制到所选本地硬盘的第 2 分区。
iscsi_192.168.0.1_3to3 将源盘第 3 分区复制到所选本地硬盘的第 3 分区。
iscsi_unmount 断开 iSCSI；部署过程中不可卸载正在使用的源盘。

1to2 中的数字是实际分区编号，不是盘符，也不是硬盘编号，可以按需要改为 3to4 等组合。目标分区必须已经存在且容量不小于源分区；目标原内容会被覆盖，其他分区保持。MSR 保留分区和扩展分区容器不属于可单独复制的数据卷，不能用作此类复制的源或目标。

源分区含可识别的 Windows 时，复制后修复同盘 EFI 引导及 C: 分页文件；此时目标需为合适的 GPT/NTFS Windows 分区，同盘须有可用 EFI 分区。源为普通数据分区时，仅复制分区，不执行 Windows 引导或分页文件修复，也不要求同盘有 EFI。复制 EFI 或恢复分区只是复制其内容，不代表整台电脑自动具备启动、恢复能力；文件系统和分区类型须由所配套的复制组件支持。

这些 PE 部署命令不需要 PowerShell，也不需要额外安装 WMI/Storage 管理组件。PE 需能运行 DiskPart，并具备 iSCSI 服务及 iscsicli；部署 Windows 还需 reg、BCDBoot 和配套复制工具，VHD 模式还需虚拟磁盘支持及原有引导文件。请使用包含上述组件的配套 PE。部署连接会尝试给源盘设置只读属性；部分 PE 或 iSCSI 驱动不支持此属性，确认源盘身份和联机状态后仍可读取克隆，复制只写入选定的本地目标盘。优先选择目标名末段与客户机名相同的 iSCSI 目标，其次选择 public，其它部署目标要求能唯一确认；不会自动选用其它学生的库个人盘。找不到或存在歧义时会停止，不会猜测源盘继续覆盖。

4. 启动、分页文件和完成后的操作

VHD 部署与更新沿用 VHD 引导和菜单修复，分页文件放在 W:。实体 Windows 部署（包括整盘克隆及 Windows 分区复制）恢复 C: 分页文件，由 Windows 自动管理大小。

新部署复制过程中，VHD 暂存在 VHDSYS\.localize-任务编号 中，这是临时目录。复制完成并确认卸载、解除文件占用后，父本移入 VHDSYS 根目录，再生成更新层、启动层和还原副本，修复引导并刷新 menu.lst。请以“本地 VHD 已就绪”为完成标志，不要在复制中手工移动文件。更新模式保留原父本和旧版本，仅处理新的更新层。

实体 Windows 引导修复会重新建立 Windows 启动配置，避免继续合并旧的 Windows 菜单项；不默认格式化整个 EFI 分区，以免误删其他引导文件。该处理不负责删除固件设置中曾经人工建立的启动项。部署后的系统不再额外运行无盘优化或系统清理。

服务端列表和客户端提示显示进度及结果。完成后不自动重启、不自动切换固件启动顺序；确认成功后关机，改为从本地硬盘启动。如果仍优先 PXE，可能再次进入无盘或 PE。

同一成功任务会避免重复部署。失败或取消后不保留永久禁止重试记录，处理原因、重启回到无盘并重新上线后可重试；PE 可重新发送部署命令。同一次客户端运行中不会因心跳反复自动重试清盘。进入本地 Windows/VHD 后，列表恢复网速或签到等普通状态。重新设置任务或再次手工发送会创建新任务，也可能再次覆盖目标。复制中断可能留下不完整系统，实体部署没有 VHD 旧层那样的自动回退能力。

更新本地 VHD 会比较复制变化扇区，但仍可能读取大量源盘数据；不能保证只传输新增软件的数据量，或更新层大小等于新增软件大小。更新结果以源系统为准，不保留目标系统分区独有的软件和资料；需要保留的数据应放在其他分区或个人磁盘。

READY FOR YOUR NEXT CLASS

让下一堂课，从容开始。

先了解，再下载。在熟悉的机房里，试一次更轻松的教学与维护。

开始了解与体验 ↗
CONTACT

和作者聊一聊

产品咨询、班班通版、部署预约或订单问题。

简单验证用于减少自动采集。请勿在公开群聊中发送注册码、订单查询密码或远程控制密码。

软件界面大图