Skip to content

hkuvpn v1.2.0 - the desktop app

Choose a tag to compare

@jialiangZ jialiangZ released this 04 Nov 09:03
· 11 commits to main since this release

Superseded by v1.2.1.
The archive attached to this release carries the unfixed worker: the
release workflow that builds it did not exist yet when this tag was
made. The system could crawl, big transfers could stall, and a connect
could hang. Take v1.2.1 instead — it has all of it fixed.

hkuvpn v1.2.0 — the desktop app

This release is about making hkuvpn usable on a laptop without a
compiler, a container runtime or a terminal window.

The Windows app (new)

HKUVPN-windows-v1.2.0.zip — 5 MB, no installer.

Unpack it anywhere, run bin\get-tools.ps1 once as administrator (it
installs OpenConnect, which brings the Wintun adapter, and downloads
gost; both downloads are checked against pinned SHA-256 hashes), then
start HKUVPN.exe. Type your HKU account and Portal PIN in the window —
they are saved as you type and never leave the machine — press
Connect, approve the UAC prompt, and type the six-digit code from
Microsoft Authenticator when it asks.

START-HERE.md and START-HERE.zh-CN.md in the archive have the full
steps, in English and in Chinese.

What the window gives you that the launcher does not:

  • a status card — the state, the tunnel address, the uptime, the proxy
    endpoints and the learned routes, in one place
  • a Diagnostics panel — the same checks as hkuvpn.ps1 --check, plus a
    live test of the local proxies and the address the traffic leaves with
  • a Routes panel — the learned routes, added and removed by hand
  • a Settings panel — the advanced options of hku.env, and a switch
    to start the app with Windows
  • a log window — the session log with severity tags, a level filter, a
    search field, and copy / export

Closing the window hides the app in the tray and the tunnel keeps
running. Disconnect needs no UAC, and exiting the app never kills a
session.

中文

HKUVPN-windows-v1.2.0.zip 里有桌面 App:解压后以管理员身份运行一次
bin\get-tools.ps1(装 OpenConnect、下载 gost,都有固定的 SHA-256 校验),
再启动 HKUVPN.exe,在窗口里填账号和 Portal PIN,点 Connect,UAC 点允许,
要码时输入 Authenticator 上的 6 位数字。压缩包里的 START-HERE.zh-CN.md
有完整步骤。

窗口里比启动器多出来的东西:状态卡(状态、隧道地址、时长、代理、
学到的路由)、诊断面板(和 --check 相同的检查,外加本地代理的连通性
测试和出口地址)、路由面板(可手动增删)、设置面板(hku.env 的高级
选项和开机自启)、日志窗口(级别标签、级别筛选、搜索、复制、导出)。

Upgrade notes

Nothing to do. The Docker edition works exactly as before, and the
Windows launcher gained nothing — the desktop app is a new, separate
thing that drives the same worker underneath it.

A note on the archive

The .sha256 file next to the archive is the hash of the archive. If it
does not match, do not run it — write an issue instead.