Skip to content

v0.4.0 — 在线规则开箱可用(多镜像 + 防回滚)

Choose a tag to compare

@XavierMu XavierMu released this 09 Nov 11:43
· 8 commits to main since this release

SDUST WebVPN 本地透明代理 v0.4.0

在校外,用校内原始地址直接访问学校资源。浏览器开箱即用,命令行工具可额外接管。

下载

SDUST-WebVPN-0.4.0-portable.zip(便携版)

解压到任意文件夹,双击 SDUST WebVPN.exe 即用。

  • 不需要安装,不需要管理员权限,不需要 Node.js
  • 数据目录跟着 exe 走(state\、.secrets\),删掉整个文件夹就干净卸载
  • 需要 Windows 10 / 11 x64 + WebView2 运行时(Win11 自带;Win10 一般随 Edge 已装)

本版重点:在线规则开箱可用

以前「在线规则」是空的,得自己找一份规则文件填进去;现在装上就自带一份校内清单:

  • 内置公共规则地址,默认订阅 https://github.com/XavierMu/sdust-webvpn-rules,
    程序启动 20 秒后自动同步一次,不用管
  • 多镜像回退:地址框一行一个,按顺序尝试,前一条连不上 / 解析失败 / 内容更旧就换下一条
  • 防回滚:远端版本(version 或 updated)比本地缓存旧时拒绝覆盖并说明原因
    —— 免得 CDN 还在发旧文件时把规则改回去;确实要用旧版可以点「强制同步」
  • 拉不到不会清空:全部地址都失败时保留上一次成功同步的规则,并逐个报出失败原因
  • 地址框改成多行,顺手修掉了「同一个出口试两遍白等 20 秒」的问题
    (站外规则源只直连一次;只有校内地址才值得先走本机代理再回退直连)

「分流规则 → 在线规则…」里能看到当前走的是哪个镜像、同步时间、条目数。
公共规则仓库收 Issue 补站点。

快速开始

  1. 双击 exe → 首次打开弹一次引导
  2. 填账号 → 「保存并登录」
  3. 点「开启系统代理」(第一次会提示装一次根证书)

之后浏览器直接访问校内原始地址即可。

⚠ 要用 git / pip / curl,需要额外两步

Windows 的「系统代理」和 HTTP_PROXY 环境变量是两套东西:浏览器读前者,
git、curl、pip 只认后者。所以要:

  1. 把模式切到**「全局」**(PAC 模式下不写环境变量)
  2. 勾上**「同时设置命令行代理环境变量」**
  3. 重开终端(已开的终端不会继承新变量)

Node.js 原生 fetch 连环境变量也不读,需要 NODE_USE_ENV_PROXY=1(Node 24+)。

能力边界

能用:浏览器访问校内站点、站外直连;勾选环境变量后 git clone/push、
curl、pip、conda、maven 等 HTTP 工具。

用不了(WebVPN 是 clientless 反向代理,没有 TCP 隧道,原理上不可能):
SSH / SFTP、git@ 的 SSH 地址、MySQL / PostgreSQL / Redis、RDP / VNC、
FTP / BT、ping / traceroute(ICMP)、游戏与语音等 UDP 流量。

本版内容

  • 界面 ui/:连接、分流规则(含在线规则弹窗)、账号与证书、统计、日志、关于
  • 内核 src-tauri/src/vpn/:CAS 登录与保活、CONNECT + MITM、本地 CA
    与证书库读写、系统代理 / PAC 接管、DPAPI 凭据加密、黑白名单分流、在线规则多源同步
  • 单测 42 个全部通过(新增 10 个:版本判据、旧配置迁移、地址清洗)

隐私

账号密码用 Windows DPAPI 加密存在 .secrets\creds.dpapi(仅本机此用户可解密),
本地 CA 私钥在 state\ca\。程序没有自建服务器,只和学校 WebVPN 通信;
同步在线规则时会去 GitHub / jsDelivr 拉一个 JSON(不含任何本机信息)。

详见 README。