Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/proxysh/ShadowVPN
https://github.com/proxysh/ShadowVPN
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/proxysh/ShadowVPN
- Owner: proxysh
- License: gpl-3.0
- Created: 2017-02-18T18:39:49.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2017-02-21T20:54:50.000Z (almost 8 years ago)
- Last Synced: 2024-08-02T12:23:50.792Z (4 months ago)
- Language: C
- Size: 406 KB
- Stars: 7
- Watchers: 3
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES
- License: COPYING
Awesome Lists containing this project
- awesome-starred - proxysh/ShadowVPN - (others)
README
ShadowVPN
=========[![Build Status]][Travis CI]
[中文说明][Chinese Readme]
ShadowVPN is a fast, safe VPN based on libsodium. Designed for low end
devices, i.e. OpenWRT routers.For more details, [check here][Compare].
ShadowVPN is currently beta and have much work to do. If you want a stable version,
please come by here a few months later.Install
-------#### Debian & Ubuntu
For Debian 7 and Ubuntu 12+, add the following line to `/etc/apt/sources.list`
deb http://shadowvpn.org/debian wheezy main
Then
apt-get update && apt-get install shadowvpn
service shadowvpn restart#### Unix
Currently Linux, FreeBSD and OS X are supported.
Download a [release] and build. Do not clone the repo, since it's not stable.
Make sure to set `--sysconfdir=/etc`. You'll find conf files under `/etc`.# For Debian-based Linux
sudo apt-get update
sudo apt-get install build-essential automake libtool git -y
./configure --enable-static --sysconfdir=/etc
make && sudo make install#### OpenWRT
Download bundled [ShadowVPN with LuCI], or just [download ShadowVPN] itself,
Or build ShadowVPN yourself: cd into [SDK] root, then
pushd package
git clone https://github.com/proxysh/ShadowVPN.git
popd
make menuconfig # select Network/ShadowVPN
make V=s
scp bin/xxx/ShadowVPN-xxx-xxx.ipk [email protected]
# then log in your box and use opkg to install that ipk file#### iOS
See [iOS]
#### Android
See [Android]
#### Windows
See [Build for Windows].
Configuration
-------------- You can find all the conf files under `/etc/shadowvpn`.
- For the client, edit `client.conf`.
- For the server, edit `server.conf`.
- Update `server` and `password` in those files.
- The script file specified by `up` will be executed after VPN is up.
- The script file specified by `down` will be executed after VPN is down.
- If you need to specify routing rules, modify those scripts. You'll see a
placeholder at the end of those scripts.
- If you are using Windows, the IP address of TUN/TAP device `tunip` is
required to be specified in the conf file.
- You can [configure multiple users](https://github.com/proxysh/ShadowVPN/wiki/Configure-Multiple-Users)Usage
-----Server:
sudo shadowvpn -c /etc/shadowvpn/server.conf -s start
sudo shadowvpn -c /etc/shadowvpn/server.conf -s stopIf you installed using apt-get, you can use `sudo service shadowvpn start` instead.
Client:
sudo shadowvpn -c /etc/shadowvpn/client.conf -s start
sudo shadowvpn -c /etc/shadowvpn/client.conf -s stopClient(OpenWRT):
/etc/init.d/shadowvpn start
/etc/init.d/shadowvpn stopYou can also read [LuCI Configuration].
Wiki
----You can find all the documentation in the wiki:
https://github.com/proxysh/ShadowVPN/wikiLicense
-------This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.You should have received a copy of the GNU General Public License
along with this program. If not, see .Bugs and Issues
----------------- [FAQ]
- [Issue Tracker]
- [Mailing list][Android]: https://github.com/proxysh/ShadowVPNAndroid
[Build Status]: https://travis-ci.org/clowwindy/ShadowVPN.svg?branch=master
[Build deb Package]: https://github.com/proxysh/ShadowVPN/wiki/Building-deb-Package
[Build for Windows]: https://github.com/proxysh/ShadowVPN/wiki/Build-for-Windows
[Compare]: https://github.com/proxysh/ShadowVPN/wiki/Compared-to-Shadowsocks-and-OpenVPN
[Chinese Readme]: https://github.com/proxysh/ShadowVPN/wiki/ShadowVPN-%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E
[download ShadowVPN]: https://github.com/proxysh/ShadowVPN/releases
[FAQ]: https://github.com/proxysh/ShadowVPN/wiki/FAQ
[iOS]: https://github.com/proxysh/ShadowVPNiOS
[Issue Tracker]: https://github.com/proxysh/ShadowVPN/issues?state=open
[LuCI Configuration]: https://github.com/proxysh/ShadowVPN/wiki/Configure-Via-LuCI-on-OpenWRT
[Mailing list]: http://groups.google.com/group/shadowsocks
[release]: https://github.com/proxysh/ShadowVPN/releases
[SDK]: http://wiki.openwrt.org/doc/howto/obtain.firmware.sdk
[ShadowVPN with LuCI]: https://github.com/aa65535/openwrt-shadowvpn
[Travis CI]: https://travis-ci.org/clowwindy/ShadowVPN