zjunet/README.md

# zjunet

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

## Features

- ZJU VPN (l2tp)

- ZJU WLAN

- 路由器支持（written in Bourne Shell）

- 多拨支持（多账户负载均衡）

- ZJUWLAN 与 ZJUVPN 带宽叠加（1 WLAN + N VPN，在 ZJUWLAN 下）

- DNS 自动测试设置（适用于 DNS 坏掉的情况）

## Requirements

- xl2tpd

- curl

## Install

### Debian / Ubuntu

https://github.com/QSCTech/zjunet/releases
下载 deb，双击安装就是。

### Openwrt

https://github.com/QSCTech/zjunet/releases
下载 opk，然后 `opkg install` 就是。

### From source

一般来说 master 分支是稳定的，dev 分支会有破坏性变更。

```bash
git clone https://github.com/QSCTech/zjunet.git
cd zjunet
sudo ./install.sh
```

## Known Issues

### 丢包

在有的机子上会丢包（因为用的是 nexthop ）。
等有空了也许会换成 iptables 来解决这个问题。

### ppp0 may disappear on openwrt

make /etc/ppp/options's lcp-echo-failure larger.

see also https://github.com/QSCTech/zjunet/issues/39

## Openwrt

Install xl2tpd:

https://downloads.openwrt.org/snapshots/trunk/ar71xx/packages/packages/

## Dev

QSCer 可以直接向这个 repo push 而不用发 pull request。
有什么疑虑可以提 issue 问一下，
或者直接来办公室找我(zenozeng)。

master分支就是开发分支。
但是请保证bump version的时候要稳定。

### Build

#### Debian

```bash
sudo apt-get install build-essential autoconf automake autotools-dev dh-make debhelper devscripts fakeroot xutils lintian pbuilder
```

##### see also

- http://www.webupd8.org/2010/01/how-to-create-deb-package-ubuntu-debian.html

- http://tldp.org/HOWTO/html_single/Debian-Binary-Package-Building-HOWTO/

#### Openwrt

##### see also

- http://lists.openmoko.org/pipermail/devel/2008-July/000496.html

## Links

- [Array in unix Bourne Shell](http://unix.stackexchange.com/questions/137566/array-in-unix-bourne-shell)

- [How do you tell if a string contains another string in Unix shell scripting?](http://stackoverflow.com/questions/2829613/how-do-you-tell-if-a-string-contains-another-string-in-unix-shell-scripting)
-												add README

											
										
										
											2014-09-18 22:21:10 +08:00
+								# zjunet
 								Command Line Scripts for ZJU (VPN / WLAN / DNS)
-												update README

											
										
										
											2014-09-28 21:42:50 +08:00
+								## Features
-												add README

											
										
										
											2014-09-18 22:21:10 +08:00
-												update README

											
										
										
											2014-09-28 21:42:50 +08:00
+								- ZJU VPN (l2tp)
-												update README

											
										
										
											2014-09-18 22:55:22 +08:00
 								- ZJU WLAN
-												init wlan.sh

											
										
										
											2014-09-19 23:36:35 +08:00
+								- 路由器支持（written in Bourne Shell）
-												update README

											
										
										
											2014-09-18 22:55:22 +08:00
 								- 多拨支持（多账户负载均衡）
-												update README

											
										
										
											2014-09-28 21:42:50 +08:00
+								- ZJUWLAN 与 ZJUVPN 带宽叠加（1 WLAN + N VPN，在 ZJUWLAN 下）
 								- DNS 自动测试设置（适用于 DNS 坏掉的情况）
-												update README

											
										
										
											2014-09-19 23:19:16 +08:00
-												update README

											
										
										
											2014-09-28 21:46:50 +08:00
+								## Requirements
 								- xl2tpd
 								- curl
-												update README

											
										
										
											2014-09-29 20:02:45 +08:00
+								## Install
-												update README

											
										
										
											2014-10-02 13:44:47 +08:00
+								### Debian / Ubuntu
-												use xl2tpd.conf, abandon .zjunet/

											
										
										
											2014-10-15 16:24:20 +08:00
+								https://github.com/QSCTech/zjunet/releases
-												update README

											
										
										
											2014-10-02 13:47:16 +08:00
+								下载 deb，双击安装就是。
-												update README

											
										
										
											2014-10-02 13:44:47 +08:00
 								### Openwrt
-												use xl2tpd.conf, abandon .zjunet/

											
										
										
											2014-10-15 16:24:20 +08:00
+								https://github.com/QSCTech/zjunet/releases
-												update README

											
										
										
											2014-10-02 13:47:16 +08:00
+								下载 opk，然后 `opkg install` 就是。
-												update README

											
										
										
											2014-10-02 13:44:47 +08:00
-												add postinst & prerm for build/openwrt

											
										
										
											2014-09-30 18:11:45 +08:00
+								### From source
-												update README

											
										
										
											2014-10-02 13:47:16 +08:00
+								一般来说 master 分支是稳定的，dev 分支会有破坏性变更。
-												update README

											
										
										
											2014-09-29 20:02:45 +08:00
+								```bash
 								git clone https://github.com/QSCTech/zjunet.git
 								cd zjunet
 								sudo ./install.sh
 								```
-												flush lns, fixes #39

											
										
										
											2014-10-01 04:10:17 +08:00
+								## Known Issues
-												update README

											
										
										
											2014-11-12 20:22:49 +08:00
+								### 丢包
 								在有的机子上会丢包（因为用的是 nexthop ）。
 								等有空了也许会换成 iptables 来解决这个问题。
-												flush lns, fixes #39

											
										
										
											2014-10-01 04:10:17 +08:00
+								### ppp0 may disappear on openwrt
 								make /etc/ppp/options's lcp-echo-failure larger.
 								see also https://github.com/QSCTech/zjunet/issues/39
-												add postinst & prerm for build/openwrt

											
										
										
											2014-09-30 18:11:45 +08:00
+								## Openwrt
 								Install xl2tpd:
 								https://downloads.openwrt.org/snapshots/trunk/ar71xx/packages/packages/
-												update README

											
										
										
											2014-09-29 20:02:45 +08:00
+								## Dev
-												update README

											
										
										
											2014-09-29 18:44:10 +08:00
 								QSCer 可以直接向这个 repo push 而不用发 pull request。
 								有什么疑虑可以提 issue 问一下，
 								或者直接来办公室找我(zenozeng)。
-												update README

											
										
										
											2014-11-12 20:22:49 +08:00
 								master分支就是开发分支。
 								但是请保证bump version的时候要稳定。
-												update README

											
										
										
											2014-09-29 18:44:10 +08:00
-												add opkg-buildpackage

											
										
										
											2014-09-29 21:11:49 +08:00
+								### Build
-												add debian/build

											
										
										
											2014-09-30 15:46:57 +08:00
+								#### Debian
-												add opkg-buildpackage

											
										
										
											2014-09-29 21:11:49 +08:00
 								```bash
 								sudo apt-get install build-essential autoconf automake autotools-dev dh-make debhelper devscripts fakeroot xutils lintian pbuilder
 								```
-												dpkg-deb -Zgzip, fixes #37, fixes #32

											
										
										
											2014-09-30 20:07:18 +08:00
+								##### see also
-												add debian/build

											
										
										
											2014-09-30 15:46:57 +08:00
 								- http://www.webupd8.org/2010/01/how-to-create-deb-package-ubuntu-debian.html
 								- http://tldp.org/HOWTO/html_single/Debian-Binary-Package-Building-HOWTO/
-												add opkg-buildpackage

											
										
										
											2014-09-29 21:11:49 +08:00
-												dpkg-deb -Zgzip, fixes #37, fixes #32

											
										
										
											2014-09-30 20:07:18 +08:00
+								#### Openwrt
 								##### see also
 								- http://lists.openmoko.org/pipermail/devel/2008-July/000496.html
-												update README

											
										
										
											2014-09-19 23:19:16 +08:00
+								## Links
 								- [Array in unix Bourne Shell](http://unix.stackexchange.com/questions/137566/array-in-unix-bourne-shell)
-												wlan.sh (in Bourne Shell)

											
										
										
											2014-09-20 18:13:40 +08:00
 								- [How do you tell if a string contains another string in Unix shell scripting?](http://stackoverflow.com/questions/2829613/how-do-you-tell-if-a-string-contains-another-string-in-unix-shell-scripting)