Important
EasyConnect has been deprecated in HITSZ since May 6th, 2025 (or earlier), and related API accessed from ZJU Connect and HITSZ Connect Verge is disabled. If your faculty can still use EasyConnect, this project will still work for you, enjoy it.
If you cannot use EasyConnect/this project, the official replacement is aTrust, which is still disgusting for me. If you are from HITSZ, you can access aTrust from https://trust.hitsz.edu.cn
I will recommend you to have a look at docker-easyconnect, which mentions its compatibility with aTrust. Although I haven't tested it.
HITSZ Connect Verge is a GUI of ZJU Connect. It is built for users of ZJU Connect/EasyConnect.
- Fast and green compared to EasyConnect.
- Built with PySide6, easy to build and maintain.
- Multi-platform support, with native optimization for the macOS version.
- Works with other applications like Clash, Remote Desktop, and SSH. (See Working with other applications)
- Supports custom server address/DNS/HTTP/SOCKS5 proxy port, and keep-alive settings. (If you need additional parameters, please submit an issue/PR)
You can install HITSZ Connect Verge in two ways: downloading pre-built binaries or building from source.
Note
- If you are a student of HITSZ, username and password are the same as the ones you use to log in to the Unified Identity Authentic Platform.
- If the download speed is slow, you can try using gh-proxy to download.
HITSZ Connect Verge provides out-of-the-box experience. You can download the latest version from the release page.
Important
For macOS version, you need to grant access to the application by running:
sudo xattr -rd com.apple.quarantine /Applications/HITSZ\ Connect\ Verge.app
-
Clone the repository:
git clone https://github.com/kowyo/hitsz-connect-verge.git cd hitsz-connect-verge
-
Install dependencies:
-
Install uv
-
Sync the environment:
uv sync
-
-
Run the application:
macOS/Linux
source .venv/bin/activate uv run app/main.py
Windows (Powershell)
.\.venv\Scripts\activate.ps1 uv run .\app\main.py
-
(Optional) Build the binaries:
Please refer to our GitHub Actions workflow for more information.
- Server: vpn.hitsz.edu.cn
- SOCKS5 Proxy: 1080
- HTTP Proxy: 1081
- DNS Server: 10.248.98.30
If you want to learn more about the network configuration, you can visit Mythologyli/zju-connect.
If you want to use Clash at the same time (e.g. watching Youtube and visiting http://jw.hitsz.edu.cn at the same time), you can add the following configuration to your clash configuration file.
For example, if you are using Clash Verge Rev, you can go to 'Profiles' -> Right click on the profile you are using -> 'Edit File' -> Add the following configuration:
# note: do not append this to the end of the file directly, append it separately to the corresponding position
proxies:
# your existing proxies...
- { name: 'HITSZ Connect Verge', type: socks5, server: 127.0.0.1, port: 1080, udp: true }
proxy-groups:
# your existing proxy-groups...
- { name: 校园网, type: select, proxies: ['DIRECT', 'HITSZ Connect Verge']}
rules:
# your existing rules...
- 'DOMAIN,vpn.hitsz.edu.cn,DIRECT'
- 'DOMAIN-SUFFIX,hitsz.edu.cn,校园网'
- 'IP-CIDR,10.0.0.0/8,校园网,no-resolve'
# - 'IP-CIDR,<other_ip>,校园网,no-resolve'
Note
- You need to enable
TUN Mode
in Clash, and enable theAuto Configure Proxy
option of this software. - You need to turn off the
Always use Default Bypass
option in theSystem Proxy
settings, and addlocalhost
to theProxy Bypass
field.s - A useful global extend script is provided if you want to avoid the automatic update of the profiles overwrite your custom rules.
If you want to connect to the remote desktop in the campus network, you can use Parallels Client, and configure the local 1080 port as a proxy.
If you want to use SSH, you can use the following command to establish a connection.
For macOS/Linux users:
ssh -o ProxyCommand="nc -X 5 -x 127.0.0.1:1080 %h %p" <root>@<server> -p <port>
For Windows users, you can use ncat to setup SOCKS 5 proxy. Run the following command after installing ncat:
ssh -o "ProxyCommand=ncat --proxy 127.0.0.1:1080 --proxy-type socks5 %h %p" <root>@<server> -p <port>
Windows | Mac | Linux |
---|---|---|
![]() |
![]() |
![]() |
Contributions are welcome! Feel free to open an issue or submit a pull request. For major changes, please open an issue first to discuss what you would like to change.
Also, any typo is welcome to be fixed.
- chenx-dust/HITsz-Connect-for-Windows: HITsz Edition of ZJU-Connect-for-Windows. Support advanced settings and multi-platform.
- Co-ding-Man/hitsz-connect-for-windows: Out-of-the-box zju-connect simple GUI for Windows, suitable for HITSZ.
-
Mythologyli for the project ZJU Connect.
-
Keldos for designing the macOS version's icon.
-
All the contributors to this project.