# NJUConnect: reconstructing the NJU EasyConnect VPN client

> NJUConnect implements a Go client for Nanjing University's EasyConnect VPN service using a custom TLS ClientHello and separate tunnel receive and transmit handshakes. Its code handles web login, token exchange, IP assignment and a SOCKS5 endpoint backed by gVisor networking.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/lyc8503/NJUConnect>
- Primary source: <https://github.com/lyc8503/NJUConnect/blob/ded56b0a89b9880e8def6af8bd53ec3b57247dd4/core/protocol.go>
- Catalog page: <https://awesomerea.org/resources/njuconnect-vpn-protocol-case/>
- Record JSON: <https://awesomerea.org/resources/njuconnect-vpn-protocol-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/njuconnect-vpn-protocol-case/index.md)

## Requirements & limits

- **Prerequisites:** Requires access credentials for Nanjing University's VPN service.
- **Limits:** The client is no longer maintained and does not work with updated EasyConnect servers; it still works with Nanjing University's server.
- **License:** The author withdrew the AGPL-3.0 license; the repository has no license file.

## Primary sources

1. <https://github.com/lyc8503/NJUConnect/blob/ded56b0a89b9880e8def6af8bd53ec3b57247dd4/core/protocol.go>
2. <https://github.com/lyc8503/NJUConnect/blob/ded56b0a89b9880e8def6af8bd53ec3b57247dd4/README.md>
3. <https://github.com/lyc8503/NJUConnect/blob/ded56b0a89b9880e8def6af8bd53ec3b57247dd4/core/EasyConnectClient.go>

## More in Protocols

- [LGTV: reconstructing LG webOS TV control exchanges](https://awesomerea.org/resources/lgtv-js-case/index.md) · Case study
- [Inferno: implementing Dante audio networking](https://awesomerea.org/resources/inferno-dante-protocol-case/index.md) · Case study
- [Wireshark](https://awesomerea.org/resources/wireshark/index.md) · Tool
- [Netzob](https://awesomerea.org/resources/netzob/index.md) · Tool
- [Scapy](https://awesomerea.org/resources/scapy/index.md) · Tool
- [Universal Radio Hacker (URH)](https://awesomerea.org/resources/universal-radio-hacker/index.md) · Tool

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.