适用于 Ubuntu 和 Windows 的校园网监测、断线重连、门户自动认证与远程控制软件恢复工具。
校园网经常会出现两种“看起来都像断网”的情况：
- Wi-Fi 信号、网线链路或上级交换机短暂中断，电脑没有及时恢复网络连接。
- 有线或无线仍显示已连接，但校园网认证已经过期，打开网页又要输入账号密码。
这对需要长时间联网、远程连接、下载任务或无人值守电脑尤其麻烦。即使校园网已经恢复，ToDesk、向日葵等远程控制客户端有时仍停留在离线状态。这个项目因此同时处理两层问题：先恢复校园网认证，再刷新已经安装的远程控制客户端。
运行逻辑很简单：
等待指定校园网 → 检查外网 → 登录门户 → 持续断网时恢复网络连接 → 刷新远程控制客户端
认证失败时会逐步延长重试间隔，避免错误密码造成高频请求。
| 系统或门户 | 支持情况 |
|---|---|
| Ubuntu | 20.04、22.04、24.04 |
| Windows | Windows 10、Windows 11 |
| 重庆大学 | 内置 CQU 一键配置 |
| Dr.COM / ePortal | 支持常见登录接口 |
| 深澜 SRUN | 支持 challenge 加密登录流程 |
| 其他简单门户 | 可配置 GET/POST 请求 |
远程控制软件恢复支持以下客户端：
| 客户端 | Ubuntu | Windows | 在线健康检查 |
|---|---|---|---|
| ToDesk | 支持 | 支持 | Linux 检查 GUI、后台服务、本地控制端口、中心认证与真实 TCP 连接 |
| 向日葵 Sunlogin | 支持 | 支持 | 检查进程与已安装的后台服务，网络恢复后刷新 |
| AnyDesk | 支持 | 支持 | 优先使用官方状态命令，并检查进程与后台服务 |
| RustDesk | 支持 | 支持 | 检查进程与已安装的后台服务，网络恢复后刷新 |
| TeamViewer | 支持 | 支持 | 检查进程与已安装的后台服务，网络恢复后刷新 |
安装器会检查常见安装路径、Linux 桌面启动项和 Windows 卸载注册表。只为实际检测到的客户端启用恢复；没有安装上述软件时，不会创建远程恢复服务或计划任务。恢复框架将客户端定义、健康探针和后台服务声明分离，后续可继续增加其他远程控制软件，而不需要重写监控循环。
不同学校的接口并不完全相同，因此除重庆大学外，首次使用可能需要填写学校的登录地址和固定参数。
从 Releases 下载：
- Ubuntu/Linux 建议下载
tar.gz。 - Windows 建议下载
zip。
下载后先解压，再进入解压目录安装。
安装前先手动连接目标校园 Wi-Fi 或校园有线网络。
sudo bash install.sh安装器只枚举当前已连接的物理有线和 Wi-Fi，忽略 VPN、Docker 与其他虚拟网卡。只有一个候选网络时会自动选中；同时存在多个候选时会显示编号供选择，并把当前承担 IPv4 默认路由的网络标为推荐项。安装器只为最终选中的校园网启用自动连接和无限重试。
选定网络后，根据向导输入校园网账号、密码并选择认证类型；重庆大学用户选择 1。
安装器会自动检测当前正在使用的连接和网卡。例如只有一个候选时显示：
检测到唯一网络：cqurobotics5g (Wi-Fi，wlp7s0)
检测到连接：cqurobotics5g
检测到网卡：wlp7s0
有线和 Wi-Fi 同时连接时会显示选择菜单：
检测到多个活动网络，请选择需要校园网自动认证的连接：
1. 有线连接 1 (有线，eno1，当前默认路由（推荐）)
2. Campus-WiFi (Wi-Fi，wlp7s0)
输入编号 [1]:
直接按 Enter 接受推荐项，或输入其他编号明确选择校园网。选择完成后不会再次询问连接名和网卡名，随后出现的校园网账号、密码和认证类型仍需按实际情况填写。
按 Ctrl+C 会显示 KeyboardInterrupt 并中止安装；需要确认默认值时应按 Enter，不要按 Ctrl+C。
安装完成后会创建 campus-autologin.service，立即运行并开机自启。如果 Ubuntu 上连续 5 分钟无法访问公网，服务会刷新 DNS 并通过 NetworkManager 重连安装时选中的物理连接；两次恢复至少间隔 15 分钟，避免网络抖动造成反复开关。
如果安装器检测到支持的远程控制软件，还会为当前桌面用户创建 campus-remote-recovery.service。该用户服务跟随图形会话启动，并在每次拉起客户端前动态导入 DISPLAY、XAUTHORITY 等桌面环境。
如果检测到软件自带的 systemd 后台服务，安装器只为实际存在的服务生成精确到 systemctl restart <服务名> 的受限 sudoers 规则。恢复程序不能借此执行其他管理员命令。
sudo systemctl status campus-autologin --no-pager
sudo journalctl -u campus-autologin -n 50 --no-pager
systemctl --user status campus-remote-recovery --no-pager
journalctl --user -u campus-remote-recovery -n 50 --no-pagersudo bash configure.sh
sudo bash uninstall.sh旧版 CQU v3 配置会在安装时自动识别并导入。
先安装 Python 3.8 或更高版本，并勾选 Add Python to PATH。然后在解压目录打开 PowerShell。
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install.ps1根据向导输入账号、密码并选择认证类型。安装不要求管理员权限。
程序会注册计划任务 CampusNetworkAutoLogin，当前用户登录 Windows 后自动运行。如果检测到支持的远程控制软件，还会注册 CampusRemoteRecovery。
Get-Content "$env:APPDATA\CampusAutoLogin\campus-autologin.log" -Tail 50
Get-Content "$env:APPDATA\CampusAutoLogin\remote-recovery.log" -Tail 50
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\test-once.ps1powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\configure.ps1
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\uninstall.ps1| 向导选项 | 适用情况 | 需要填写 |
|---|---|---|
1 |
重庆大学 CQU | 账号、密码 |
2 |
Dr.COM / ePortal | 登录 API URL，通常以 /eportal/portal/login 结尾 |
3 |
深澜 SRUN | 认证服务器地址和 ac_id |
4 |
简单 GET/POST 门户 | URL、请求字段和成功标志 |
账号需要运营商后缀时，直接输入完整账号，例如 20240001@cmcc。
不知道学校使用哪一种时：
- 保持校园 Wi-Fi 已连接，但先退出校园网认证。
- 浏览器打开学校登录页，按
F12，在Network中保留日志。 - 手动登录一次，查看登录请求 URL：出现
eportal/portal/login通常是 Dr.COM；出现get_challenge和srun_portal通常是 SRUN。
不要公开真实密码、Cookie 或临时 token。配置示例位于 examples 目录。
- 按本项目需求，配置向导输入密码时会直接显示，并再次打印供确认。
- 自动登录必须保存密码。Linux 只允许 root 和专用服务账户读取；Windows 只授权当前用户读取。
- 日志会隐藏账号、密码、URL 编码密码和 Base64 密码。
- HTTPS 门户始终校验证书。若学校只提供 HTTP，密码在传输中不受 TLS 保护，程序会输出警告。
- 远程恢复模块只读取本机安装路径、进程/服务状态和公开运行日志，不读取 ToDesk、向日葵等客户端的账号、密码或设备验证码。
- Ubuntu 为专用校园网服务账户授予 NetworkManager 的网络控制权限，但不授予修改连接配置或其他管理员权限；远程软件权限仍只允许当前桌面用户重启安装器检测到的后台服务。卸载时会一并删除这些规则。
- 本工具只恢复正常校园网认证，不绕过终端数量、计费或访问控制。
恢复模块会连续确认断网和联网，过滤单次探测失败。确认网络恢复后，具备可靠深度健康探针的客户端会先等待自身重连；其他客户端会刷新一次。联网正常期间每 15 秒检查客户端，进程、后台服务或可靠在线信号连续异常后才恢复，避免一次短暂抖动导致误重启。
恢复采用统一的分级流程：
确认公网在线
→ 检查客户端进程和已安装的后台服务
→ 使用可用的厂商状态/中心连接探针
→ 持续异常时重启桌面客户端
→ Ubuntu 上 60 秒内仍不健康时，按 15 分钟冷却重启其后台服务
ToDesk Linux 的深度探针不会只看进程或旧 AuthOk：它还要求本地控制端口存在，并验证日志中当前中心服务器的 TCP 连接确实处于 ESTABLISHED。没有可靠在线接口的客户端不会使用猜测端口，而是在网络恢复时刷新，并持续守护进程和服务。
两次客户端恢复默认至少间隔 180 秒，后台服务重启至少间隔 900 秒，避免网络抖动造成重启风暴或双实例。
安装或服务刚启动时不会重启正在运行的远程客户端，因此不会因为重新安装本项目而主动断开当前远程会话。
Ubuntu 先确认应用的 .desktop 启动项位于标准应用目录，或可执行文件位于常见安装路径。Windows 先确认软件出现在“已安装的应用”中。便携版或自定义安装目录可在项目中提交路径适配；恢复模块不会通过全盘扫描寻找程序。
当前连接名称或网卡与安装时不同。重新运行 configure.sh 或 configure.ps1。
Ubuntu 可先查看活动连接：
nmcli -t -f NAME,TYPE,DEVICE connection show --active网线重插、交换机端口恢复或 DHCP 短暂失败后，NetworkManager 会持续尝试重新激活安装时选中的有线连接。若连接看似存在但公网持续 5 分钟不可用，本服务还会刷新 DNS、关闭再重新激活该连接，然后继续完成门户认证。恢复动作有 15 分钟冷却，不会因瞬时抖动反复开关。
网线未插入或网卡没有物理链路时，软件无法凭空建立连接，但会保持等待并在链路恢复后继续工作。network_recovery_after 和 network_recovery_cooldown 可在配置中调整，单位为秒，默认分别为 300 和 900。
如果安装时有线和 Wi-Fi 同时在线，安装器会让用户明确选择，并默认推荐实际承担 IPv4 默认路由的网卡，而不是固定选择某一种类型。Linux 通常会给有线更低的路由 metric，因此可以保留 Wi-Fi 作为备用。
检查账号后缀、密码、登录 URL 和 ac_id。然后执行单次测试并查看脱敏日志。
验证码、MFA、复杂 SSO、802.1X 和学校修改过的专有协议目前不能自动处理。
核心程序只使用 Python 标准库，不需要安装 requests 等第三方包。协议参考、许可与项目边界见 NOTICE.md。
本地验证命令：
python3 -m unittest discover -s tests -v
python3 -m py_compile campus_autologin.py configure.py remote_recovery.py
bash -n install.sh configure.sh uninstall.sh可以只读查看本机脱敏状态，不会发起认证请求：
python3 campus_autologin.py --config /etc/campus-autologin/config.json --diagnoseconnectivity_policy 默认是 any，任意一个连通性检查成功即视为在线；需要更严格判断时可设置为 all，或设置为 quorum 要求多数检查成功。
Linux 卸载默认保留 /etc/campus-autologin 中的配置和日志，确认不再需要时再执行 sudo bash uninstall.sh --purge。Windows 对应使用 uninstall.ps1 -Purge。
desktop-app-preview 是桌面托盘应用的实验性预览分支，主线仍以跨平台命令行、服务和计划任务为稳定维护目标；桌面应用功能暂不视为 v4 主线 API。