summaryrefslogtreecommitdiff
path: root/docs/configexamples/tunnelbroker-ipv6.rst
blob: c59f9cc6db8234f783df812d7c5a65a169e58546 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
:lastproofread: 2021-06-29

.. _examples-tunnelbroker-ipv6:

.. stop_vyoslinter

#######################
Tunnelbroker.net (IPv6)
#######################

This guide walks through the setup of https://www.tunnelbroker.net/ for an
IPv6 Tunnel.

Prerequisites
=============

- A public, routable IPv4 address. This does not necessarily need to be static,
  but you will need to update the tunnel endpoint when/if your IP address
  changes, which can be done with a script and a scheduled task.
- Account at https://www.tunnelbroker.net/
- Requested a "Regular Tunnel". You want to choose a location that is closest
  to your physical location for the best response time.

Setup initial tunnel
====================

Set up initial IPv6 tunnel. Replace the field below from the fields on the
tunnel information page.

.. code-block:: none

  conf
  set interfaces tunnel tun0 address Client_IPv6_from_Tunnelbroker    # This will be your VyOS install's public IPv6 address
  set interfaces tunnel tun0 description 'HE.NET IPv6 Tunnel'
  set interfaces tunnel tun0 encapsulation 'sit'
  set interfaces tunnel tun0 local-ip Client_IPv4_from_Tunnelbroker   # This is your public IP
  set interfaces tunnel tun0 mtu '1472'
  set interfaces tunnel tun0 multicast 'disable'
  set interfaces tunnel tun0 remote-ip Server_IPv4_from_Tunnelbroker  # This is the IP of the Tunnelbroker server
  set protocols static interface-route6 ::/0 next-hop-interface tun0  # Tell all traffic to go over this tunnel
  commit

If your WAN connection is over PPPoE, you may need to set the MTU on the above
tunnel lower than 1472.

At this point you should be able to ping an IPv6 address, try pinging Google:

.. code-block:: none

   ping6 -c2 2001:4860:4860::8888

   64 bytes from 2001:4860:4860::8888: icmp_seq=1 ttl=57 time=21.7 ms
   64 bytes from 2001:4860:4860::8888: icmp_seq=2 ttl=57 time=21.1 ms

   --- 2001:4860:4860::8888 ping statistics ---
   2 packets transmitted, 2 received, 0% packet loss, time 1001ms
   rtt min/avg/max/mdev = 21.193/21.459/21.726/0.304 ms

Assuming the pings are successful, you need to add some DNS servers.
Some options:

.. code-block:: none

   set system name-server 2001:4860:4860::8888  # Google
   set system name-server 2001:4860:4860::8844  # Google
   set system name-server 2606:4700:4700::1111  # Cloudflare
   set system name-server 2606:4700:4700::1001  # Cloudflare
   commit

You should now be able to ping something by IPv6 DNS name:

.. code-block:: none

   # ping6 -c2 one.one.one.one
   PING one.one.one.one(one.one.one.one) 56 data bytes
   64 bytes from one.one.one.one: icmp_seq=1 ttl=58 time=16.8 ms
   64 bytes from one.one.one.one: icmp_seq=2 ttl=58 time=17.4 ms

   --- one.one.one.one ping statistics ---
   2 packets transmitted, 2 received, 0% packet loss, time 1001ms
   rtt min/avg/max/mdev = 16.880/17.153/17.426/0.273 ms

Assuming everything works, you can proceed to the client configuration

LAN Configuration
=================

At this point, your VyOS install should have full IPv6, but now your LAN devices
need access.

With Tunnelbroker.net, you have two options:

- Routed /64. This is the default assignment. In IPv6-land, it's good for a
  single "LAN", and is somewhat equivalent to a /24.
  Example: `2001:470:xxxx:xxxx::/64`
- Routed /48. This is something you can request by clicking the "Assign /48"
  link in the Tunnelbroker.net tunnel config. It allows you to have up to 65k
  LANs. Example: `2001:470:xxxx::/48`

Unlike IPv4, IPv6 is really not designed to be broken up smaller than /64. So
if you ever want to have multiple LANs, VLANs, DMZ, etc, you'll want to ignore
the assigned /64, and request the /48 and use that.

Single LAN Setup
================

Single LAN setup where eth1 is your LAN interface. Use the /64 (all the xxxx
should be replaced with the information from your `Routed /64` tunnel):

.. code-block:: none

  set interfaces ethernet eth1 address '2001:470:xxxx:xxxx::1/64'
  set service router-advert interface eth1 name-server '2001:4860:4860::8888'
  set service router-advert interface eth1 name-server '2001:4860:4860::8844'
  set service router-advert interface eth1 prefix 2001:470:xxxx:xxxx::/64 

Please note, 'autonomous-flag' and 'on-link-flag' are enabled by default,
'valid-lifetime' and 'preferred-lifetime' are set to default values of
30 days and 4 hours respectively.

This accomplishes a few things:

- Sets your LAN interface's IP address
- Enables router advertisements. This is an IPv6 alternative for DHCP (though
  DHCPv6 can still be used). With RAs, Your devices will automatically find the
  information they need for routing and DNS.

Multiple LAN/DMZ Setup
======================

In this, you use the `Routed /48` information. This allows you to assign a
different /64 to every interface, LAN, or even device. Or you could break your
network into smaller chunks like /56 or /60.

The format of these addresses:

- `2001:470:xxxx::/48`: The whole subnet. xxxx should come from Tunnelbroker.
- `2001:470:xxxx:1::/64`: A subnet suitable for a LAN
- `2001:470:xxxx:2::/64`: Another subnet
- `2001:470:xxxx:ffff:/64`: The last usable /64 subnet.

In the above examples, 1,2,ffff are all chosen by you. You can use 1-ffff
(1-65535).

So, when your LAN is eth1, your DMZ is eth2, your cameras are on eth3, etc:

.. code-block:: none

  set interfaces ethernet eth1 address '2001:470:xxxx:1::1/64'
  set service router-advert interface eth1 name-server '2001:4860:4860::8888'
  set service router-advert interface eth1 name-server '2001:4860:4860::8844'
  set service router-advert interface eth1 prefix 2001:470:xxxx:1::/64
  
  set interfaces ethernet eth2 address '2001:470:xxxx:2::1/64'
  set service router-advert interface eth2 name-server '2001:4860:4860::8888'
  set service router-advert interface eth2 name-server '2001:4860:4860::8844'
  set service router-advert interface eth2 prefix 2001:470:xxxx:2::/64 

  set interfaces ethernet eth3 address '2001:470:xxxx:3::1/64'
  set service router-advert interface eth3 name-server '2001:4860:4860::8888'
  set service router-advert interface eth3 name-server '2001:4860:4860::8844'
  set service router-advert interface eth3 prefix 2001:470:xxxx:3::/64

Please note, 'autonomous-flag' and 'on-link-flag' are enabled by default,
'valid-lifetime' and 'preferred-lifetime' are set to default values of
30 days and 4 hours respectively.

Firewall
========

Finally, don't forget the :ref:`firewall`. The usage is identical, except for
instead of `set firewall name NAME`, you would use `set firewall ipv6-name
NAME`.

Similarly, to attach the firewall, you would use `set interfaces ethernet eth0
firewall in ipv6-name` or `set zone-policy zone LOCAL from WAN firewall
ipv6-name`.


.. start_vyoslinter