This project is no longer maintained as I have lost access to my VPN account. If you still need this project, please create your own fork. Thank you.
Introduction
HITSZ Connect Verge is a GUI of ZJU Connect. It is built for users of ZJU Connect/EasyConnect.
Features
- 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)
Installation
You can install HITSZ Connect Verge in two ways: downloading pre-built binaries or building from source.
Method 1: Downloading pre-built binaries
HITSZ Connect Verge provides out-of-the-box experience. You can download the latest version from the release page.
For macOS version, you need to grant access to the application by running:
sudo xattr -rd com.apple.quarantine /Applications/HITSZ\ Connect\ Verge.app
Method 2: Building from source
-
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.
Working with other applications
- 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.
Clash
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'
- You need to enable
TUN Mode in Clash, and enable the Auto Configure Proxy option of this software.
- You need to turn off the
Always use Default Bypass option in the System Proxy settings, and add localhost to the Proxy 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.
Learn more
Remote Desktop
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.
SSH
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>
Learn more
Screenshots
Contributing
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.
Credits
评论