TheArchive/yggdrasil-go
1
0
Fork 0
mirror of https://github.com/yggdrasil-network/yggdrasil-go.git synced 2024-12-22 07:57:31 +00:00
Code Issues Packages Projects Releases Wiki Activity

slightly reorganize readme

Browse Source
This commit is contained in:
Arceliar 2018-01-25 19:06:48 -06:00
parent 6b2937bcd0
commit 0cb7b3872d
1 changed files with 7 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
README.md
View File

@ -20,13 +20,6 @@ You're encouraged to play with it, but I strongly advise against using it for an
Note that you can cross compile by specifying the `$GOOS` and `$GOARCH` environment variables. Note that you can cross compile by specifying the `$GOOS` and `$GOARCH` environment variables.
The build script sets its own `$GOPATH`, so the build environment is self-contained. The build script sets its own `$GOPATH`, so the build environment is self-contained.
This code should work out-of-the-box on most Linux distributions and macOS.
It should also work on recent versions of Windows, but it depends on the OpenVPN NDIS 5 TAP driver (tested with `tap-windows-9.9.2_3`, not that there issues when using NDIS 6 driver as of `tap-windows-9.21.2`).
Be aware that connectivity issues can occur on Windows if multiple IPv6 addresses from the `fd00::/8` prefix are assigned to the TAP interface.
If this happens, then you may need to manually remove the old/unused addresses from the interface (though the code has a workaround in place to do this automatically in some cases).
You can also advertise a route on your LAN, enabling other devices to access the `fd00::/8` network, as shown in the optional example below.
## Running ## Running
To run the program, you'll need permission to create a `tun` device and configure it using `ip`. To run the program, you'll need permission to create a `tun` device and configure it using `ip`.
@ -50,6 +43,13 @@ If you want to use it as an overlay network on top of e.g. the internet, then yo
A [Vyatta-based](https://github.com/neilalexander/vyatta-yggdrasil) router configuration is also available. A [Vyatta-based](https://github.com/neilalexander/vyatta-yggdrasil) router configuration is also available.
The code should work out-of-the-box on most Linux distributions (with `iproute2` installed) and macOS.
It should also work on recent versions of Windows, but it depends on the OpenVPN NDIS 5 TAP driver (tested with `tap-windows-9.9.2_3`, not that there issues when using NDIS 6 driver as of `tap-windows-9.21.2`).
Be aware that connectivity issues can occur on Windows if multiple IPv6 addresses from the `fd00::/8` prefix are assigned to the TAP interface.
If this happens, then you may need to manually remove the old/unused addresses from the interface (though the code has a workaround in place to do this automatically in some cases).
You can also advertise a route on your LAN, enabling other devices to access the `fd00::/8` network, as shown in the optional example below.
## Optional: advertise a prefix locally ## Optional: advertise a prefix locally
Suppose a node has generated the address: `fd00:1111:2222:3333:4444:5555:6666:7777` Suppose a node has generated the address: `fd00:1111:2222:3333:4444:5555:6666:7777`