Skip to content

Instantly share code, notes, and snippets.

@CHTJonas
Last active April 26, 2022 00:49
Show Gist options
  • Save CHTJonas/b58d267d189b97af4dd2a2fa6feb7594 to your computer and use it in GitHub Desktop.
Save CHTJonas/b58d267d189b97af4dd2a2fa6feb7594 to your computer and use it in GitHub Desktop.
Tunnelbroker config for UniFi Security Gateway
{
"interfaces": {
"tunnel": {
"tun0": {
"address": [
"YOUR-ALLOCATED-IPV6-PREFIX-FROM-TUNNELBROKER"
],
"description": "Tunnelbroker IPv6 Tunnel",
"encapsulation": "sit",
"firewall": {
"in": {
"ipv6-name": "WANv6_IN"
},
"local": {
"ipv6-name": "WANv6_LOCAL"
},
"out": {
"ipv6-name": "WANv6_OUT"
}
},
"local-ip": "YOUR-ROUTER-PUBLIC-IPV4-ADDRESS",
"multicast": "disable",
"remote-ip": "YOUR-TUNNELBROKER-REMOTE-IPV4-ADDRESS",
"ttl": "255"
}
}
},
"protocols": {
"static": {
"interface-route6": {
"::/0": {
"next-hop-interface": {
"tun0": "''"
}
}
}
}
}
}

UniFi Tunnelbroker Configuration

This GitHub Gist details the manual configuration needed on a UniFi controller to enable IPv6 tunneling with Hurricane Electric's Tunnelbroker service.

Setup

This is what works for me personally. Stuff you'll need to do to adapt this to your ends:

  • Replace "local-ip" with your USG's public IPv4 address.
  • Replace "remote-ip" with the address of your Tunnelbroker tunnel server.
  • Replace "address" with the IPv6 address that your are allocated.

Installation

Follow these instructions and drop your config.gateway.json file in the correct location e.g. /usr/lib/unifi/data/sites/$NAME/.

@Altycoder
Copy link

@CHTJonas I realise that this is quite old now, but how exactly do you now use a tunnel with a USG if you have a dynamic ipv4 address? Do you have an alternative config that you could share?

I'm looking for a way around BT's dynamic /56 ipv6 which for me changes every 2-3 days and is causing a few problems with an android client and Microsoft's company portal app.

@CHTJonas
Copy link
Author

CHTJonas commented Apr 1, 2021

how exactly do you now use a tunnel with a USG if you have a dynamic ipv4 address?

It's a bit tricky. I had to update the config manually whenever my IPv4 address changed which was thankfully not that often. I imagine it would be possible to automate this (maybe a crontab running on the controller that does sed -i on the JSON file and then hits up the API URLs to force AP reprovisions?) but it would be a massive hack.

You also need to make sure the IP address is updated at the Tunnelbroker side which is easy enough to do using curl in a crontab.

@Altycoder
Copy link

ok thanks, there's more to this than I thought, maybe a weekend project....

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment