mirror of
https://github.com/cwinfo/yggdrasil-network.github.io.git
synced 2024-09-20 00:12:32 +00:00
132 lines
4.1 KiB
Markdown
132 lines
4.1 KiB
Markdown
---
|
|
tags: dontlink
|
|
sitemap: true
|
|
---
|
|
|
|
# EdgeRouter
|
|
|
|
Yggdrasil is supported on the Ubiquiti EdgeRouter using the [vyatta-yggdrasil](https://github.com/neilalexander/vyatta-yggdrasil) package.
|
|
|
|
## Notes
|
|
|
|
- Yggdrasil does not survive an upgrade of the EdgeRouter firmware. You must reinstall it after a system upgrade.
|
|
- After reinstalling Yggdrasil, use `load` to reload your configuration and then `commit` to make it effective again. Do not run `save` under any circumstances until after you have reloaded your configuration.
|
|
|
|
## Installation
|
|
|
|
Start by [downloading the latest vyatta-yggdrasil .deb package](https://circleci.com/api/v1.1/project/github/yggdrasil-network/yggdrasil-go/latest/artifacts) and then install it:
|
|
```
|
|
curl -O https://xx-xxxxxxxxx-gh.circle-artifacts.com/x/vyatta-yggdrasil-x.x.xxx-mipsel.deb
|
|
sudo dpkg -i vyatta-yggdrasil-x.x.xxx-mipsel.deb
|
|
```
|
|
|
|
## Generate configuration
|
|
|
|
Configuration for Yggdrasil is generated automatically when you create an interface:
|
|
```
|
|
configure
|
|
set interfaces yggdrasil tun0
|
|
commit
|
|
```
|
|
At this point, Yggdrasil will start running using default configuration, which includes automatic peer discovery of other Yggdrasil nodes on the same network using multicast.
|
|
|
|
## Add peers
|
|
|
|
Add additional peers to your configuration (using `tcp://` or `socks://`):
|
|
```
|
|
configure
|
|
set interfaces yggdrasil tunX peers tcp://hostname.com:12345
|
|
set interfaces yggdrasil tunX peers tcp://a.b.c.d:12345
|
|
set interfaces yggdrasil tunX peers tcp://[a:b:c::d]:12345
|
|
commit
|
|
|
|
run restart yggdrasil tun0
|
|
```
|
|
|
|
## Set multicast
|
|
|
|
Enable or disable multicast peer discovery:
|
|
```
|
|
configure
|
|
set interfaces yggdrasil tun0 multicast true
|
|
set interfaces yggdrasil tun0 multicast false
|
|
commit
|
|
|
|
run restart yggdrasil tun0
|
|
```
|
|
|
|
## Set MTU
|
|
|
|
Set the maximum MTU of the Yggdrasil interface, from 1280-65535:
|
|
```
|
|
configure
|
|
set interfaces yggdrasil tun0 mtu 1500
|
|
commit
|
|
|
|
run restart yggdrasil tun0
|
|
```
|
|
|
|
## Configuration
|
|
|
|
Other changes should be made to `/config/yggdrasil.tun0.conf` by hand. To make effective, restart Yggdrasil:
|
|
```
|
|
restart yggdrasil tun0
|
|
```
|
|
|
|
## Masquerade
|
|
|
|
If you want to allow other IPv6 hosts on your network to communicate through yggdrasil, you can configure an IPv6 masquerade rule. All traffic sent from other hosts on the network through the Yggdrasil interface will be NAT'd.
|
|
|
|
For example:
|
|
```
|
|
configure
|
|
set interfaces yggdrasil tun0 masquerade from xxxx:xxxx:xxxx::/48
|
|
commit
|
|
```
|
|
If you have multiple IPv6 subnets, then they can be configured individually by setting multiple `masquerade from` source ranges. Both private/ULA and public IPv6 subnets are acceptable.
|
|
|
|
## Crash Detection
|
|
|
|
To make sure that the process is restarted if it crashes, schedule the `vyatta-check-yggdrasil` script to run at a regular interval:
|
|
```
|
|
configure
|
|
set system task-scheduler task check-yggdrasil executable path /opt/vyatta/sbin/vyatta-check-yggdrasil
|
|
set system task-scheduler task check-yggdrasil interval 1m
|
|
commit
|
|
```
|
|
|
|
## Default Firewall Config
|
|
|
|
Use this as an example firewall configuration, which will allow outgoing connections but prevent unexpected incoming ones, with the exception of ICMPv6 which will be allowed:
|
|
```
|
|
configure
|
|
|
|
set firewall ipv6-name YGG_IN default-action drop
|
|
set firewall ipv6-name YGG_LOCAL default-action drop
|
|
|
|
set firewall ipv6-name YGG_IN rule 10 action accept
|
|
set firewall ipv6-name YGG_IN rule 10 state established enable
|
|
set firewall ipv6-name YGG_IN rule 10 state related enable
|
|
|
|
set firewall ipv6-name YGG_IN rule 20 action drop
|
|
set firewall ipv6-name YGG_IN rule 20 state invalid enable
|
|
|
|
set firewall ipv6-name YGG_IN rule 30 action accept
|
|
set firewall ipv6-name YGG_IN rule 30 protocol icmpv6
|
|
|
|
set firewall ipv6-name YGG_LOCAL rule 10 action accept
|
|
set firewall ipv6-name YGG_LOCAL rule 10 state established enable
|
|
set firewall ipv6-name YGG_LOCAL rule 10 state related enable
|
|
|
|
set firewall ipv6-name YGG_LOCAL rule 20 action drop
|
|
set firewall ipv6-name YGG_LOCAL rule 20 state invalid enable
|
|
|
|
set firewall ipv6-name YGG_LOCAL rule 30 action accept
|
|
set firewall ipv6-name YGG_LOCAL rule 30 protocol icmpv6
|
|
|
|
set interfaces yggdrasil tun0 firewall in ipv6-name YGG_IN
|
|
set interfaces yggdrasil tun0 firewall local ipv6-name YGG_LOCAL
|
|
|
|
commit
|
|
```
|