安装（Linux / 信创）

cc-class 提供 Linux 安装包，支持 amd64（x86_64） 与 arm64（信创：飞腾/鲲鹏等）。同一台机器的教师/学生角色仍按计算机名自动判定（见 自动区分）。

可选安装包：

cc-class_1.0.18_amd64.deb           # x86_64 在线安装（自动拉依赖）
cc-class_1.0.18_arm64.deb           # arm64 / 信创
cc-class_1.0.18_amd64-offline.tar.gz # 离线安装包（含全部依赖 + install.sh）

一、在线安装（机器能上网/有 apt 源）

sudo apt install ./cc-class_1.0.18_amd64.deb

apt 会自动安装运行依赖（xdotool、wmctrl、x11-utils、libxtst6、ffmpeg、libssl3、音频/字体等）。

二、离线安装（机房无 apt 源，推荐）

离线包内含主程序 .deb、全部依赖 .deb 和 install.sh：

tar xzf cc-class_1.0.18_amd64-offline.tar.gz
cd cc-class_1.0.18_amd64-offline
sudo ./install.sh

install.sh 会先用 dpkg 装好 deps/ 里的依赖，再装主程序——全程不需要联网、不需要 apt 源。

卸载

sudo ./install.sh --uninstall，或 sudo apt remove cc-class。

三、安装做了什么

项目	内容
程序目录	/opt/cc-class/（TeacherApp、StudentApp、StudentService、libs/、plugins/、tools/ffmpeg、start_teacher.sh、start_student.sh）
应用菜单	/usr/share/applications/cc-class-teacher.desktop、cc-class-student.desktop
systemd 服务	cc-class-student.service（开机自启，守护学生端） cc-class-teacher.service（手动启动，按需）
udev 规则	99-cc-class-vdchardev.rules：让普通用户可读 /dev/vdchardev，用于角色识别（云桌面计算机名）
桌面图标	由学生守护进程开机时按角色自动处理：教师机建教师图标、学生机不建图标
Wayland	自动改 GDM 为 Xorg（见下）

关于 Wayland → Xorg（务必了解）

Ubuntu 22.04/24.04 默认使用 Wayland 会话，而 Wayland 下屏幕广播（截屏）和远程控制（XTest 注入）都无法工作——这是所有电子教室类软件的通病。

因此安装包会自动把 GDM 配置为禁用 Wayland（/etc/gdm3/custom.conf 写入 WaylandEnable=false，原文件备份为 *.cc-class-orig，卸载时还原）。

需要重启或重新登录才生效

修改 GDM 配置后，请注销并重新登录，在登录界面确保进入 Xorg 会话（或直接重启机器）。否则教师端会提示"检测到 Wayland，广播/远控不可用"。

四、运行

• 学生机：装完即由 cc-class-student.service 自动运行，无需手动操作。

• 教师机：双击桌面 cc-class 教师端 图标，或：

  systemctl start cc-class-teacher        # 用服务方式启动
  # 或者直接运行
  /opt/cc-class/start_teacher.sh

  首次启动会让您选择教学频道，然后进入主界面。

手动管理服务

systemctl status  cc-class-student     # 查看学生端守护状态
systemctl restart cc-class-student     # 重启（改名后重新判定角色）
journalctl -u cc-class-student -e      # 看日志

学生守护进程的角色判定日志（含识别到的计算机名、教师/学生）写在 /tmp/cc-class-service.log，排错时很有用。

五、信创 / arm64 说明

arm64 安装方式与 amd64 完全相同，使用 cc-class_1.0.18_arm64.deb 或对应的离线包即可。依赖项已为 arm64 预置在离线包 deps/arm64/ 中。

下一步 👉 教师端使用指南 ｜ 学生端使用指南