muon

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

Features

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

Supported platforms

GNU/Linux
macOS

Dependencies

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

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/.

Muon

Install / Use

README