Code Monkey home page Code Monkey logo

zjunet's Introduction

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

  • curl

  • 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; curl -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, curl -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 [email protected] 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

zjunet's People

Contributors

zenozeng avatar senorsen avatar tespent avatar determ1ne avatar yejingchen avatar wfwf1997 avatar xqyww123 avatar nayaco avatar dinoallo avatar long0x0 avatar mythologyli avatar megrxu avatar chaosink avatar xietianxi avatar yzhblind avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.