muon

A fast stateless VPN with simple obfuscation, inspired by ShadowVPN and GoHop.

Features

1. Stateless
2. Frequent port hopping every 0.5s to escape traffic monitoring
3. Perform naïve obfuscation by compression and random padding
4. Multipath support

Supported platforms

• GNU/Linux
• macOS

Dependencies

1. libmill

2. libsodium

3. lz4

Pre-builds

Platform	Architecture	URL
GNU/Linux	x86_64	https://s3.pxx.io/snapshot/muon/muon-x86_64
	armv6l	https://s3.pxx.io/snapshot/muon/muon-armv6l
	armv7l	https://s3.pxx.io/snapshot/muon/muon-armv7l
	aarch64	https://s3.pxx.io/snapshot/muon/muon-aarch64

Build

1. Linux/macOS

install GNU Autotools, then:

# build libmill
curl -s -L https://github.com/sustrik/libmill/archive/master.tar.gz | tar -zxf -
mv libmill-master libmill
cd libmill
./autogen.sh
./configure --enable-shared=false --enable-static
make
cd ../

# build libsodium
curl -s -L https://github.com/jedisct1/libsodium/archive/master.tar.gz | tar -zxf -
mv libsodium-master libsodium
cd libsodium
./autogen.sh
./configure --enable-shared=false --enable-static
make
cd ../

# build lz4
curl -s -L https://github.com/lz4/lz4/archive/master.tar.gz | tar -zxf -
mv lz4-master lz4
cd lz4
make -C lib
cd ../

# build muon
autoreconf -if
export CPPFLAGS="-I$(pwd)/lz4/lib -I$(pwd)/libmill -I$(pwd)/libsodium/src/libsodium/include"
export LDFLAGS="-L$(pwd)/lz4/lib -L$(pwd)/libmill/.libs -L$(pwd)/libsodium/src/libsodium/.libs"
./configure --prefix=/usr --sysconfdir=/etc --enable-static
make
make check
sudo make install

on macOS, install via Homebrew is also supported:

brew install --HEAD libmill
brew install libsodium lz4
brew install --HEAD https://raw.githubusercontent.com/puxxustc/muon/master/contrib/homebrew/muon.rb

2. Cross compile

# setup cross compile tool chain:
export PATH="$PATH:/pato/to/cross/compile/toolchain/bin/"

# build libmill
curl -s -L https://github.com/sustrik/libmill/archive/master.tar.gz | tar -zxf -
mv libmill-master libmill
cd libmill
./autogen.sh
./configure --enable-shared=false --enable-static --host=arm-unknown-linux-gnueabihf
make
cd ../

# build libsodium
curl -s -L https://github.com/jedisct1/libsodium/archive/master.tar.gz | tar -zxf -
mv libsodium-master libsodium
cd libsodium
./autogen.sh
./configure --enable-shared=false --enable-static --host=arm-unknown-linux-gnueabihf
make
cd ../

# build lz4
curl -s -L https://github.com/lz4/lz4/archive/master.tar.gz | tar -zxf -
mv lz4-master lz4
cd lz4
CC=arm-unknown-linux-gnueabihf-gcc make -C lib
cd ../

# build muon
autoreconf -if
export CPPFLAGS="-I$(pwd)/lz4/lib -I$(pwd)/libmill -I$(pwd)/libsodium/src/libsodium/include"
export LDFLAGS="-L$(pwd)/lz4/lib -L$(pwd)/libmill/.libs -L$(pwd)/libsodium/src/libsodium/.libs"
./configure --host=arm-unknown-linux-gnueabihf \
    --prefix=/usr --sysconfdir=/etc --enable-static
make

Usage

See man:muon(8).

License

Copyright (C) 2014 - 2017, Xiaoxiao i@pxx.io

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 http://www.gnu.org/licenses/.