云学堂 学生终端如何配置

# H3C LearningSpace 云学堂：修改业务 IP、教师机 IP，虚拟地址重设，教师端显示网络断开

>
> 现象：已经在管理平台完成虚拟地址重设；**学生终端保存旧服务器 / 教师机 IP，平台修改后不会自动批量下发到终端**；教师端显示网络断开，终端无法接入课堂。
> 关键点：云学堂分两层配置：①物理瘦终端底层 OS 的【云主机服务器地址】；②虚拟机镜像内部【学生教学客户端教师机 IP】，两处都要更新，只改平台 web 页面不会自动同步终端。

## 一、先做连通性基础校验（必做）

1. 教师机关闭 Windows 防火墙、杀毒软件，禁用多余虚拟网卡 / VPN；
2. 教师机 ping **新的云学堂业务 IP（云主机 IP）**，确认网络通；
3. 瘦终端物理控制台（终端开机界面点设置，密码默认`h3c`），查看当前填写的**云主机服务器地址**，确认是否还是旧 IP。

>
> 故障根源：很多终端底层配置依旧写旧 IP，平台改完，终端本地参数不会自动刷新。

## 二、两处配置都要更新（只改 web 平台不生效）

### 第 1 处：物理瘦终端底层（终端系统，连接云主机的地址）

>
> 作用：瘦终端本身连接 LearningSpace 云主机管理平台，**不是虚拟机内部**。
> 批量下发方式：

1. 打开【云学堂教师端管理软件】→【终端管理】→【扫描全部在线终端】
2. 使用**批量统一配置**，填写**新云主机业务 IP**，填写学生终端 IP 网段范围，执行【立即配置】，下发给所有开机在线瘦终端。

>
> ⚠️要求：所有学生瘦终端保持开机上电；教师机防火墙放行；同教室二层网络；跨教室需要分开扫描下发。

- 个别离线终端：只能本地操作：终端开机界面点【设置】输入管理员密码，手动修改云主机服务器 IP，保存重启终端。

### 第 2 处：课程镜像内部（虚拟机里面学生客户端教师机 IP）

>
> 这就是教师端显示网络断开的高频点：**虚拟机镜像内的学生教学客户端保存旧教师机 IP，哪怕瘦终端底层已经更新，进虚拟机上课依旧连不上教师端**。

1. 进入云学堂 web 管理平台，打开对应课程镜像【编辑镜像】；
2. 镜像内启动 Windows，打开右下角云学堂学生客户端，打开客户端设置，输入管理员密码；
3. 将**教师机地址修改为新教师机 IP**；保存镜像、提交更新。

>
> ⚠️旧的已经运行的虚拟机不会自动更新，需要**下课，重新上课加载更新后的镜像模板**，虚拟机内学生端配置才生效。

## 三、管理平台 web 侧检查项（你已经做虚拟地址重设，补充核对）

1. web 管理→【教室】→教室配置：核对教室参数：云主机业务 IP、教师机 IP、虚机网段全部为新 IP；
2. 检查 DHCP 地址池，虚机 IP 池与新网段匹配，无 IP 地址冲突；
3. 查看【终端列表】，确认终端状态，离线终端无法接收批量配置，需要现场处理。

## 四、教师端 “网络断开” 故障专项排查

1. 教师机软件配置：打开教师端软件设置，确认填写的**云主机 IP 为新业务 IP**，不是旧 IP；修改后重启教师教学软件；
2. 教师机网卡：只保留业务网卡，禁用 VPN、虚拟网卡；防火墙放行云学堂端口；
3. 确认教师机与虚拟机虚机网段三层互通，虚机可以 ping 教师机新 IP；
4. 如果修改 IP 后数据库缓存异常：下课全部课堂，关闭教师软件，重新打开，重新加载教室。

## 五、完整操作流程顺序（建议按这个执行）

1. 全部教室下课，结束所有上课会话；
2. web 平台确认：业务 IP、教师机 IP、虚机虚拟地址池全部更新完毕；
3. **编辑课程镜像，更新镜像内部学生客户端教师机 IP，保存镜像**；
4. 全部学生瘦终端保持开机上电；教师端软件执行【批量统一配置】，更新瘦终端底层云主机服务器 IP；
5. 全部瘦终端重启一次；
6. 教师机修改教师端软件内云主机地址，重启教师软件；
7. 重新开课，测试教师‑学生终端连通。

## 六、常见踩坑

1. ❌只修改 web 平台虚拟地址，**没有更新瘦终端底层、镜像内客户端** →终端依旧用旧 IP，教师端网络断开；
2. ❌镜像更新完不下课，直接继续上课：旧虚拟机会话继续使用旧镜像，配置不会刷新；
3. ❌部分终端关机离线：批量配置下发不到离线终端，必须现场手动设置；
4. ❌教师机防火墙拦截，批量配置下发失败，终端参数不变。

## 七、校验命令

1. 在瘦终端设置页面，确认云主机地址为新 IP；
2. 进入学生虚拟机，打开学生端设置，确认教师机 IP 是新 IP；
3. 教师机 cmd ping 虚拟机虚机 IP，虚拟机 ping 教师机 IP，双向连通。

更改云学堂学生终端的IP地址，标准做法是通过教师端软件的“终端部署”功能统一修改并下发，无需逐台手动操作。

以下是具体的操作步骤和关键检查点：

🚀 方法一：通过教师端重新部署（标准操作）

这是最推荐的方法，适用于批量修改学生终端IP的场景。

1. 确保网络连通：首先，确认所有学生终端已开启并连接到网络，且与教师机、管理平台网络互通。

2. 登录教师端：在教师机上打开云学堂教师端软件，登录（默认用户名和密码通常都是admin）。

3. 进入终端部署：在教师端界面右上角找到设置按钮（通常是齿轮图标），在下拉菜单中选择 “终端部署” 菜单项。

4. 配置IP地址段：在弹出的部署对话框中，找到 “学生端起始IP” 设置项。根据你新的网络规划，在这里设置学生终端将要被分配的IP地址范围。

   • 重要：确保新的学生IP网段与教师机IP地址不在同一网段，且教师机IP不能被包含在学生机IP范围内。

   • DHCP选项：如果网络中没有DHCP服务器，需要勾选“当前网段无DHCP服务”。

5. 执行部署：保存设置后，点击执行部署。教师端软件会自动检索网段内的学生机，并为它们分配新的IP地址。

⚙️ 方法二：在管理平台修改地址池（需重启）

你也可以在云学堂的Web管理平台上，修改教室或终端组的IP地址池配置。学生终端在下次重启或重新连接时，通常会从新的地址池中获取IP。具体路径通常是“终端管理”或“教室管理”中找到对应的教室或终端组进行修改。

🖥️ 方法三：手动修改单台终端（特殊情况）

如果仅需修改一两台终端，或者以上方法无效，可以尝试在终端本地修改。但这通常需要终端进入本地系统或底层，操作较为复杂。

🔍 如果终端未收到新IP，请检查以下几点

如果部署后终端IP未改变，可能是网络环境或配置问题：

1. 检查网络连通性：确保学生终端与教师机、管理平台之间网络畅通。可以通过在教师机上ping学生终端IP来测试。

2. 检查广播/组播通信：云学堂终端发现依赖广播或组播协议。需确保：

   • 所有终端和教师机在同一VLAN和同一子网掩码下。

   • 交换机没有开启端口隔离或设置ACL规则拦截UDP端口6000、6001等。

   • 可以临时关闭师生端的系统防火墙和杀毒软件进行测试。

3. 彻底重置学生端（针对旧配置残留）：如果终端是从别的教室转移过来的，可能存在旧配置残留。可以尝试在学生端右键图标，选择“解除禁用”（密码通常为Password@1234），然后手动删除C:\CloudClass目录，重启终端让其自动重建配置。

4. 核对配置文件：检查学生端配置文件CloudClassClient.exe.config中的ServerAddress是否指向了正确的管理平台IP。

5. 确认版本一致性：确保教师端和学生端的软件版本完全一致。