东莞理工学院校园网自动化脚本（DGUT-Network）

面向东莞理工学院（DGUT）校园网认证场景的自动登录脚本，支持自动检测未联网、自动抓取会话参数、自动认证、后台循环保活。

免责声明

• 本项目仅用于个人网络运维与学习研究。
• 请遵守学校与网络服务提供方相关规定。
• 使用本项目造成的任何后果由使用者自行承担。

项目简介

这个项目用于解决校园网 portal 认证中的常见问题：

• 认证劫持页面返回 200，导致“只看状态码”的联网检测误判。
• queryString 属于动态会话参数，不能长期硬编码。
• 部分门户环境下 HTTPS/TLS 兼容性较差，默认请求库可能握手失败。

脚本会在检测到未联网或被认证劫持时，自动尝试抓取当前会话 queryString，调用 pageInfo，并提交登录请求（支持 RSA 模式）。

适用范围

• 已针对东莞理工学院（DGUT）校园网流程适配。
• 也可用于其他高校中同类 portal/eportal 认证系统。
• 迁移到其他学校时，通常只需调整：base_url、captive_host、captive_path，必要时补充字段适配。

功能特性

• 识别 portal 劫持的联网检测（不只依赖 HTTP 200）
• 自动抓取当次会话 queryString
• 自动检测有线网卡状态（有线优先）
• 无有线时自动启用 WLAN 并连接指定 SSID（默认 莞工全光无线）
• 自动获取 pageInfo 并按需执行 RSA 登录参数加密
• 支持 YAML 配置 + 环境变量覆盖
• 支持循环模式（--loop）
• 支持 curl_cffi 兼容 TLS 握手
• 支持日志文件输出与轮转
• 支持 Windows 后台无界面启动与开机自启动

上线操作清单（建议按顺序执行）

1. 基础配置

copy config.yaml.example config.yaml

编辑 config.yaml（至少填写）：

• user_id：学号/账号
• password：密码
• base_url：认证门户地址（DGUT 默认已内置）

无线自动切换相关可选项（默认已可用）：

• auto_wifi_recovery: true
• wifi_ssid: "莞工全光无线"
• wifi_connect_wait: 8
• wifi_retry_interval: 60

2. 选择运行方式（py / exe）

A) py 方式（调试方便）

安装依赖（注意必须和 py 同环境）：

py -m pip install requests urllib3 curl_cffi

单次运行：

py campus_login.py

循环运行：

py campus_login.py --loop

B) exe 方式（服务器更稳，不依赖 Python）

.\dist\campus_login.exe --loop

说明：exe 会读取同目录 config.yaml（或 CAMPUS_CONFIG_FILE 指定路径）。

自动启动（管理员模式，开机未登录也启动）

1. py 版 SYSTEM 任务（推荐）

管理员终端执行：

.\install_onstart_system.bat

会创建：

• CampusLoginAutoLoopPy_OnStart_SYSTEM（开机触发）
• CampusLoginAutoLoopPy_Watchdog_SYSTEM（每 5 分钟兜底）

2. exe 版 SYSTEM 任务（可选）

如果你改用 exe 常驻，管理员终端可直接执行：

schtasks /Create /TN "CampusLoginAutoLoopExe_OnStart_SYSTEM" /TR "\"G:\校园网日志\dist\campus_login.exe\" --loop" /SC ONSTART /RU SYSTEM /RL HIGHEST /F
schtasks /Create /TN "CampusLoginAutoLoopExe_Watchdog_SYSTEM" /TR "\"G:\校园网日志\dist\campus_login.exe\" --loop" /SC MINUTE /MO 5 /RU SYSTEM /RL HIGHEST /F

如何确认任务已创建且有效

1. 查任务详情

schtasks /Query /TN "CampusLoginAutoLoopPy_OnStart_SYSTEM" /V /FO LIST
schtasks /Query /TN "CampusLoginAutoLoopPy_Watchdog_SYSTEM" /V /FO LIST

重点看：

• 作为用户运行: SYSTEM
• 计划任务状态: 已启用
• 上次结果: 0 或 0x0

2. 手动触发一次验证

schtasks /Run /TN "CampusLoginAutoLoopPy_OnStart_SYSTEM"
Start-Sleep -Seconds 5

3. 检查后台进程

Get-CimInstance Win32_Process |
  Where-Object { $_.CommandLine -like "*campus_login.py*" -and $_.CommandLine -like "*--loop*" } |
  Select-Object ProcessId,Name,CommandLine

若为 exe 方案，检查：

Get-CimInstance Win32_Process |
  Where-Object { $_.Name -eq "campus_login.exe" } |
  Select-Object ProcessId,Name,CommandLine

4. 检查日志是否持续刷新

Get-Content -Tail 80 .\campus_login.log
Get-Content -Tail 80 .\runner.log

受限权限模式（无法创建 SYSTEM 任务时）

.\install_autostart_safe.bat

该模式为“登录后启动 + 看门狗”。
若你已经切到 SYSTEM 模式，建议移除 Startup/HKCU 启动项，避免双触发噪音。

自启动项是否需要更新

结论：通常不需要重建任务。
只要计划任务里 要运行的任务 仍指向当前目录下的 start_loop_py_background.vbs（或 campus_login.exe --loop），脚本更新后会自动生效。

需要重建任务的情况：

• 部署目录改了（路径变化）
• 从 py 版切换到 exe 版（或反向切换）
• 任务被系统禁用、损坏或被安全策略删除

健康检查（不断网）

.\check_runtime_no_disconnect.bat

输出文件：

• healthcheck.log（单次自检结果）
• campus_login.log（主循环日志）

常见故障排查

• ModuleNotFoundError: requests：使用 py -m pip install ...，不要单独 pip install
• Access is denied（创建任务）：需管理员权限，且命令在管理员终端执行
• 能跑但看不到进程：Win10 任务管理器看“详细信息”中的 pythonw.exe/pyw.exe
• 多进程担忧：代码含单实例锁，重复触发会自动退出后续实例

新电脑无法自动抓取 queryString

症状（日志常见）：

• 抓取queryString失败
• 未获取到 queryString
• ConnectionError / Max retries exceeded

处理步骤：

1. 浏览器访问 http://neverssl.com（必须 http）触发认证跳转。
2. 复制 index.jsp? 后整段参数，临时写入 config.yaml：

captive_query_string: "这里填完整参数串"
debug_query_fetch: true

3. 先执行一次 py campus_login.py 验证登录链路。
4. 验证通过后可清空 captive_query_string，继续使用自动抓取。

代理绕过（Clash / 系统代理）

如果开了代理，认证流量被代理劫持会导致抓不到 queryString。
建议将以下目标设为直连（DIRECT）：

• login.dgut.edu.cn
• 10.60.0.1
• 1.1.1.1
• 114.114.114.114
• www.baidu.com
• www.bing.com
• www.msftconnecttest.com
• connect.rom.miui.com

示例（Clash 规则片段）：

rules:
  - DOMAIN,login.dgut.edu.cn,DIRECT
  - DOMAIN,www.baidu.com,DIRECT
  - DOMAIN,www.bing.com,DIRECT
  - DOMAIN,www.msftconnecttest.com,DIRECT
  - DOMAIN,connect.rom.miui.com,DIRECT
  - IP-CIDR,10.60.0.1/32,DIRECT,no-resolve
  - IP-CIDR,1.1.1.1/32,DIRECT,no-resolve
  - IP-CIDR,114.114.114.114/32,DIRECT,no-resolve

文档

• 配置项说明：docs/CONFIG.md
• Windows 部署说明：docs/DEPLOYMENT_WINDOWS.md

许可证

本项目使用 Apache License 2.0，见 LICENSE。