常见问题 FAQ

学生机一直显示"未连接"，连不上教师机

按顺序排查：

1. 同一网段：教师机与学生机是否在同一局域网/同一网段（能互相 ping 通）。
2. 教师端在运行：教师端必须处于运行状态才会广播。
3. 频道一致：学生端默认频道 1，教师端首启选择的频道要与之相同。
4. 端口未被拦：放行 UDP 11100、TCP 11100–11105（Windows 安装包会自动配防火墙；Linux 注意 ufw/安全软件）。
5. 隔离设置：交换机/AP 的"AP 隔离/客户端隔离"会阻断广播，需关闭。

教师端启动后提示"当前计算机名未标记为教师机，不会启动"

说明这台机器的名字没有被判为教师机。请：

• 把计算机名改为含 teacher 或 -t 标记（如 teacher-1、PC001-T），重启后再启动教师端；

• 云桌面环境请改"云桌面计算机名"（优先级高于操作系统主机名），见 自动区分。

• 应急情况下，可用参数跳过检查启动：

  # Linux
  /opt/cc-class/TeacherApp --no-host-check

  # Windows
  & "C:\Program Files\cc-class Electronic Classroom\TeacherApp.exe" --no-host-check

学生机被错判成教师机（或反之）

• 角色只看计算机名。检查名字是否意外带了 -t/teacher 等标记。

• 云桌面环境以"云桌面计算机名"为准，请在云桌面平台核对该机器下发的计算机名。

• Linux 上查看判定日志确认软件识别到的名字：

  cat /tmp/cc-class-service.log     # 含 "Effective computer name=[...], role=TEACHER/STUDENT"

• 改名后重启，守护进程会自动重判角色并重建/清理桌面图标。

Linux 教师端提示"检测到 Wayland，广播/远控不可用"，或广播是黑屏

Wayland 会话下无法截屏和注入鼠标键盘。需切换到 Xorg：

• 安装包已自动写入 WaylandEnable=false，请注销并重新登录，在登录界面进入 Xorg 会话，或重启机器。
• 确认：echo $XDG_SESSION_TYPE 应为 x11。

桌面上没有出现快捷方式

• 学生机本来就不放桌面图标（这是设计），应用菜单里仍可找到入口。
• 教师机若没出现图标：确认这台机器确实被判为教师机；改名后重启让守护进程重建；Linux 上图标会自动设置"受信任"避免 GNOME 的"未信任启动器"问题。

一个机房有多个班同时上课会互相干扰吗？

不会——给每个班的教师机/学生机设置不同的教学频道即可。学生端只连接相同频道的教师机。

最多能连多少台学生机？

试用版最多 5 台。需要更多请在教师端 软件注册（Register Software） 中用"机器码"换取授权码。

学生端关不掉 / 总是自动重启

这是有意为之：后台服务会守护学生端，崩溃或被关闭后自动拉起，保证课堂管控不中断。需要彻底停止请用管理员卸载，或在 Linux 上 systemctl stop cc-class-student。

改了计算机名要重装吗？

不需要。改名后重启即可，软件会按新名字自动重判角色、处理图标与服务。