Repository navigation
Releases: VictorCartesius/UESTC-WiredAnchor
Releases · VictorCartesius/UESTC-WiredAnchor
Release list
v1.1.0
1.1.0 — 安全加固版
新增
- 登录前校验网关身份:仅当
get_challenge回显的client_ip与本机有线出口源 IP 一致、且challenge形态合法时,才构造并发送密码材料;否则进入Foreign状态,不发送任何凭据。 - 新增
Foreign(非校园网 / 门户,此时工具不会尝试登录)与Cooling(连续重连失败达上限后冷却)状态。 - 新增配置键
MaxReconnectAttempts(默认 5)、CooldownDelay(默认 600 秒)。 - 状态变化日志行新增机器可读标记
[state=<状态>];Manage.ps1 -Action Status新增state一行。
变更
- 重连失败达上限后进入冷却;仅当在有线接口上再次确认网关身份后才恢复登录尝试。
main\下代码文件统一为字节级纯 ASCII ,便于在不同语言设置的机器上运行。- 更新
README.md与SECURITY.md。
已知限制
- 网关响应未设读取上限;"门户劫持"与"真实掉线"区分能力不足;认证链路为明文 HTTP(见 README §11 / §12)。
兼容性
- Windows 10 / 11 + Windows PowerShell 5.1,无第三方依赖。
- 不破坏 1.0.0 的对外契约(命令行动作集、环境变量名、日志位置与格式)。
升级方式
- 覆盖
main\目录后执行一次powershell -ExecutionPolicy Bypass -File .\main\Manage.ps1 -Action Stop,再-Action Start(或重新登录 Windows)使新逻辑生效。
v1.0.0
1.0.0 — 首个版本
UESTC-WiredAnchor 的首个发布版:校园网有线接入的自动认证与掉线自动重连。
功能
- 自动登录:与官方网页 JavaScript 实现等价(
get_challenge→ 本地加密 → 提交认证),无需浏览器。 - Keep-Alive 自动重连:探测外网,掉线后自动重新认证;失败按指数退避(4 → 8 → … → 60 秒,封顶)。
- 仅管理有线网络:读取系统实际使用的出口源 IP,仅当它属于有线网卡时接管;使用 Wi-Fi 时进入
Idle,不介入。 - 开机自启:
Run(免管理员)或计划任务Task(登录触发、无窗口);Auto自动回退。 - 统一管理界面
Manage.ps1:状态 / 配置 / 凭据 / 区域 / 自启 / 启停 / 日志。 - 无窗口启动:经
Start-Hidden.vbs以窗口样式 0 启动,关闭终端不影响运行。 - 日志:按天写入
main\logs\YYYY-MM-DD.log,仅记录状态变化;默认保留 30 天;探测响应有界读取。
状态机
Online(外网可达)· Offline(网关可达但外网不通 → 重连)· Detached(网关不可达,只等待)· Idle(出口非有线,不介入)
环境
Windows 10 / 11 + Windows PowerShell 5.1,无第三方依赖。
快速开始
Get-ChildItem .\main -Recurse -File | Unblock-File
powershell -ExecutionPolicy Bypass -File .\main\Manage.ps1
# 菜单:3) SetCredential → 5) SetLocate → 6) TestLogin → 7) Install⚠️ 已被 1.1.0 取代,请勿使用
本版本不含登录前的网关身份校验,存在未认证网关真实性前对外发送认证数据的风险,且重试无上限。
请直接使用 v1.1.0 或更高版本。