Skip to content

angt/glorytun

Repository files navigation

Glorytun

Glorytun is a small, simple and secure multipath UDP tunnel.

Please use the stable branch. Visit the wiki for how-to guides, tutorials, etc.

Features

The key features of Glorytun come directly from mud.

  • Fast and highly secure

    When AES-NI is available, the new and extremely fast AEAD construction AEGIS-256 is used. Otherwise, an automatic fallback to ChaCha20-Poly1305 is done in both peers. All messages are encrypted, authenticated and timestamped to mitigate a large set of attacks. This implies that the client and the server must be synchronized, an offset of 10min is accepted by default. Perfect forward secrecy is also implemented with ECDH over Curve25519. Keys are rotated every hours.

  • Multipath and failover

    Connectivity is now crucial, especially in the SD-WAN world. This feature allows a TCP connection (and all other protocols) to explore and exploit all available links without being disconnected. Aggregation should work on all conventional links. Only very high latency (+500ms) links are not recommended for now. Backup paths are also supported, they will be used only in case of emergency, it is useful when aggregation is not your priority.

  • Traffic shaping

    Shaping is very important in network, it allows to keep a low latency without sacrificing the bandwidth. It also helps the multipath scheduler to make better decisions. Currently it must be configured by hand, but soon Glorytun will do it for you.

  • Path MTU discovery without ICMP

    Bad MTU configuration is a very common problem in the world of VPN. As it is critical, Glorytun will try to setup it correctly by guessing its value. It doesn't rely on Next-hop MTU to avoid ICMP black holes. In asymmetric situations the minimum MTU is selected.

Compatibility

Glorytun only depends on libsodium version >= 1.0.4. Which can be installed on a wide variety of systems.

Linux is the platform of choice but the code is standard so it should be easily ported on other posix systems. It was successfully tested on OpenBSD, FreeBSD and MacOS.

IPv4 and IPv6 are supported. On Linux you can have both at the same time by binding ::.


For feature requests and bug reports, please create an issue.