yggdrasil-network /yggdrasil-go
An experiment in scalable routing as an encrypted IPv6 overlay network
★ 5,579⑂ 365👁 86⑃ 696● 627▤ 47
+0
日增长
5,579
stars
365
forks
86
watchers
696
prs
627
issues
47
releases
README
Yggdrasil Introduction Yggdrasil is an early-stage implementation of a fully end-to-end encrypted IPv6 network. It is lightweight, self-arranging, supported on multiple platforms and allows pretty much any IPv6-capable application to communicate securely with other Yggdrasil nodes. Yggdrasil does not require you to have IPv6 Internet connectivity - it also works over IPv4. Supported Platforms Yggdrasil works on a number of platforms, including Linux, macOS, Ubiquiti EdgeRouter, VyOS, Windows, FreeBSD, OpenBSD and OpenWrt. Please see our Installation page for more information. You may also find other platform-specific wrappers, scripts or tools in the contrib folder. Building If you want to build from source, as opposed to installing one of the pre-built packages: 1. Install Go 2. Clone this repository 2. Run ./build Note that you can cross-compile for other platforms and architectures by specifying the GOOS and GOARCH environment variables, e.g. GOOS=windows ./build or GOOS=linux GOARCH=mipsle ./build. Running Generate configuration To generate static configuration, either generate a HJSON file (human-friendly, complete with comments): ./yggdrasil -genconf /path/to/yggdrasil.conf ... or generate a plain JSON file (which is easy to manipulate programmatically): ./yggdrasil -genconf -json /path/to/yggdrasil.conf You will need to edit the yggdrasil.conf file to add or remove peers, modify other configuration such as listen addresses or multicast addresses, etc. Run Yggdrasil To run with the generated static configuration: ./yggdrasil -useconffile /path/to/yggdrasil.conf To run in auto-configuration mode (which will use sane defaults and random keys at each startup, instead of using a static configuration file): ./yggdrasil -autoconf You will likely need to run Yggdrasil as a privileged user or under sudo, unless you have permission to create TUN/TAP adapters. On Linux this can be done by giving the Yggdrasil binary the CAP_NET_ADMIN capability. Documentation Documentation is available on our website. - Installing Yggdrasil - Configuring Yggdrasil - Frequently asked questions - Version changelog Communities A number of IRC communities exist, including the yggdrasil IRC channel on libera.chat and various others on Yggdrasil-internal IRC networks. License This code is released under the terms of the LGPLv3, but with an added exception that was shamelessly taken from godeb. Under certain circumstances, this exception permits distribution of binaries that are (statically or dynamically) linked with this code, without requiring the distribution of Minimal Corresponding Source or Minimal Application Code. For more details, see: LICENSE.
Top issues
#1106use fake dns and long domain name to replace ipv6 for collision immune20 comments · 2023-11-21#1265Yggdrasil may help Iranian users?19 comments · 2025-06-22#978Constant performance degradation from v0.4.3 to v0.4.4 and v0.4.6 (-20% speed in iperf3 tests)19 comments · 2022-11-06#1022Yggdrasil doesn't take the shortest path when transferring files to/from nodes on the same LAN.17 comments · 2023-02-26#1222Ignoring direct connection to target peer in latest versions (0.5.12 including)16 comments · 2024-12-27#1289A mesh radio/ham app on Yggdrasil(alpha)15 comments · 2025-11-28#1244Basic firewall functionality is a must-have feature15 comments · 2025-04-15#1128RHEL and openSUSE15 comments · 2024-02-04
Discussions
#1415Call for Participation: Decentralized Internet devroom @ FOSDEM & Critical Decentralization Cluster @ 40C30 comments · 2026-11-13#1408Proposal: decentralized service discovery through signed peer announcements0 comments · 2026-10-28#1390yggctl: experimental external operator console (feedback welcome)0 comments · 2026-10-19#1382Yggdrasil article 😁0 comments · 2026-10-12#1378DDoS1 comments · 2026-10-12#1377Policy on genAI/LLM contributing2 comments · 2026-10-09#1376Differences between Yggdrasil and Reticulum1 comments · 2026-10-02#1373Automatic peer checker and config suggestion0 comments · 2026-09-19
Latest release
Version 0.5.15 v0.5.15 2026-10-24Go 1.26 is now required to build Yggdrasil Changed Upgrade dependencies Admin socket reads now have a 1MB limit and a 10 second timeout getNodeInfo now returns the local node's information when no public key is supplied WebSocket connections now have response header and TLS negotiation timeouts Fixed Routing algorithm fixes Improve cost calculations for direct peers of the root and peers with stale or incomplete ancestry Reject incomplete or looping ancestry during parent selection, which could result in a disjoint tree Clean up stale bloom filter bits, avoidi