C cli and library for Tsinghua University network authentication.

Support auth4, auth6 and net, including wired and wireless Tsinghua-5G, Tsinghua and Tsinghua-IPv4.

You can use it as a command line tool or integrate the lib into any application.

Installation on OpenWrt is also available!

# Create a config file
vi ~/.tunet_config
# Fill in your username and password on each line

# Set proper permissions
chmod 600 ~/.tunet_config

# Use it!
tunet -m auth4 -c ~/.tunet_config -r

# or
tunet -m auth4 -u yingr16 -p iampassword -r

Entering your password in command line is extremely inappropriate.

Please use a config file and make sure you are the only one who can access it.

        -u       Tsinghua username
        -p       Tsinghua password (wrap it in single quotes if it contains special characters)
                    Caution: enter password in cli is not recommended
                    Please use config file instead
        -r       Logout first before logging in; useful when network left inactive for too long
        -m       Network choice: [net auth auth4 auth6]
        -c       Credential config file path
                    Username should be in the first line and password in the second
        -h       Usage help

For OpenWrt users, you can download prebuilt binary from releases.

There is no prebuilt binary for newer versions. The following guide only serves as a reference for installation. You need to compile the binary by yourself.

Upload them to your router and use opkg to install packages.

For example, if you are using a mipsel_24kc router and packages are uploaded to /tmp, run:

opkg install /tmp/libtidy_5.7.28-1_mipsel_24kc.ipk
opkg install /tmp/libtunet_4.0.0-1_mipsel_24kc.ipk
opkg install /tmp/tunet_4.0.0-1_mipsel_24kc.ipk

You could add an init script to run tunet on boot.

vi /etc/init.d/tunet

With the following content:

#!/bin/sh /etc/rc.common
# /etc/init.d/tunet

START=99
DELAY=10

start() {
        tunet -m auth4 -c /root/.tunet_config -r
}

boot() {
        [ $DELAY -gt 0 ] && sleep $DELAY
        start
}

chmod +x /etc/init.d/tunet
/etc/init.d/tunet enable

You can also add a cron job to run /etc/init.d/tunet start periodically in case the network somehow become logged out after inactivity.

Currently, tunet is tested on ramips/mt7620 and should work consistently for all targets.

Other platforms will be added gradually and you can always file an issue to request pre-compiled binary for these platforms.

Now you can only build tunet from source for general Linux distributions or macOS.

You need prerequisites like openssl, curl and tidy-html5 so that libcrypto, libcurl and libtidy exist in system PATH.

For example, macOS users should do:

brew install openssl curl tidy-html5
export LDFLAGS="-L/usr/local/opt/openssl/lib -L/usr/local/opt/curl/lib -L/usr/local/opt/tidy-html5/lib"
export CPPFLAGS="-I/usr/local/opt/openssl/include -I/usr/local/opt/curl/include -I/usr/local/opt/tidy-html5/include"

And Linux (Ubuntu) users should do:

sudo apt update
sudo apt install libssl-dev libcurl4-openssl-dev libtidy-dev

Then build and install:

git clone --recursive https://github.com/robertying/tunet-c.git
cd tunet-c
./autogen.sh
./configure --prefix=/usr/local/
make
sudo make install

By default, the binary tunet is installed in $prefix/bin. Change --prefix=/usr/local/ to other directories if you want.

A shared library libtunet in $prefix/lib and a header file tunet.h in $prefix/include are provided as well if you want to integrate it yourself.

See CampusNet-Android for details about NDK integration.

Please file an issue if you encounter any problem or want new features.

Pull requests are mostly welcomed but will be considered carefully.