Skip to content

QSCTech/zjunet

Repository files navigation

zjunet

查看中文README

Command Line Scripts for ZJU (VPN / WLAN / DNS)

Features

  • ZJU VPN (l2tp)

  • ZJUWLAN

  • Router support

  • Overlap network dialing (with load balance)

  • Overlap bandwidth of ZJUWLAN and ZJU VPN (1 WLAN + N VPN, Using ZJUWLAN)

  • Automatic DNS setting (in case DNS do not work)

Requirements

  • xl2tpd

  • dig (Different package on different platform)

Installation

If you meet any problem during or after the installation, check Troubleshooting section below in this documentation.

Debian / Ubuntu (deb)

  1. Configure ZJU mirrors from manual. Ubuntu/Debian
  2. Run these command.
curl https://mirrors.zju.edu.cn/openzjunet/zjumirrors.pgp | sudo tee /etc/apt/trusted.gpg.d/zjumirrors.asc
curl https://mirrors.zju.edu.cn/openzjunet/zjunet.list | sudo tee /etc/apt/sources.list.d/zjunet.list
sudo apt-get update
sudo apt-get install zjunet
  1. The installation has completed.
  2. If you are setting up a server, we suggest you run zjunet wlan disable to disable WLAN capability.

Fedora / CentOS (rpm)

  1. Configure ZJU mirrors from manual. Fedora/CentOS

  2. Configure EPEL of ZJU mirrors (Taking CentOS installation as an example)

    1. Run yum install epel-release to install EPEL.
    2. Edit /etc/yum.repos.d/epel.repo , uncomment lines begin with #baseurl= (Remove leading # sign) and comment lines begin with mirrorlist= (Prepend # sign)
    3. Edit /etc/yum.repos.d/epel.repo , replace https://download.fedoraproject.org/pub with https://mirrors.zju.edu.cn .
  3. Run these command.

curl https://mirrors.zju.edu.cn/openzjunet/zjumirrors.pgp | sudo tee /etc/pki/rpm-gpg/RPM-GPG-KEY-ZJUMIRRORS
curl https://mirrors.zju.edu.cn/openzjunet/zjunet.repo | sudo tee /etc/yum.repos.d/zjunet.repo
sudo rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-ZJUMIRRORS
sudo yum install zjunet
  1. The installation has completed.
  2. If you are setting up a server, we suggest you run zjunet wlan disable to disable WLAN capability.

OpenWrt (opk)

Download .opk package from Release Page (onto your router), Run opkg install ./zjunet_<version>_all.opk.

Arch Linux (AUR)

Simply run yay zjunet to build the package from AUR and install it.

Keep in mind that a fresh install without internet connection is almost impossible. Please complete installation before connecting to the intranet.

Other Linux (Build from source code)

xl2tpd -v; dig -v # Check installation of dependencies. There should be 3 version numbers.
# Under proper directory
git clone https://github.com/QSCTech/zjunet.git
cd zjunet
sudo ./install.sh
# If update is necessary, run `git pull` and `sudo ./install.sh`
# If you are setting up a server, we suggest you run `zjunet wlan disable` to disable WLAN capability.

ATTENTION Requirement check will NOT be done running ./install.sh. Please run xl2tpd -v and dig -v to verify the installation.

Troubleshooting

Packet lose

This is a known issue. When overlapping VPN and ZJUWLAN, network packet may be lost. (because of nexthop in routing table).

Contributions to this issue are welcomed. (Maybe using iptables)

ppp0 may disappears on OpenWrt

Set lcp-echo-failure larger in /etc/ppp/options.

See also #39

Other problems?

Please send mail to tech@zjuqsc.com if you have any other problem.

Contribute to this project

QSCers may Push directly without sending Pull Requests。

Please write an Issue if you have worries. Contact maintainer directly if necessary.

PRs from non-QSCers are also welcomed.

Packaging Instruction

(Not finished yet)

Debian

sudo apt-get install build-essential autoconf automake autotools-dev dh-make \
  debhelper devscripts fakeroot xutils lintian pbuilder rpm
cd build
./build.sh
See Also

OpenWrt

See Also

Links