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
|
.. _router-advert:
#####################
Router Advertisements
#####################
:abbr:`RAs (Router advertisements)` are described in :rfc:`4861#section-4.6.2`.
They are part of what is known as :abbr:`SLAAC (Stateless Address
Autoconfiguration)`.
Supported interface types:
* bonding
* bridge
* ethernet
* geneve
* l2tpv3
* openvpn
* pseudo-ethernet
* tunnel
* vxlan
* wireguard
* wireless
* wwan
*************
Configuration
*************
.. cfgcmd:: set service router-advert interface <interface> ...
.. stop_vyoslinter
.. csv-table::
:header: "Field", "VyOS Option", "Description"
:widths: 10, 10, 20
"Cur Hop Limit", "hop-limit", "Hop count field of the outgoing RA packets"
"""Managed address configuration"" flag", "managed-flag", "Tell hosts to use the administered stateful protocol (i.e. DHCP) for autoconfiguration"
"""Other configuration"" flag", "other-config-flag", "Tell hosts to use the administered (stateful) protocol (i.e. DHCP) for autoconfiguration of other (non-address) information"
"MTU","link-mtu","Link MTU value placed in RAs, excluded in RAs if unset"
"Router Lifetime","default-lifetime","Lifetime associated with the default router in units of seconds"
"Reachable Time","reachable-time","Time, in milliseconds, that a node assumes a neighbor is reachable after having received a reachability confirmation"
"Retransmit Timer","retrans-timer","Time in milliseconds between retransmitted Neighbor Solicitation messages"
"Default Router Preference","default-preference","Preference associated with the default router"
"Interval", "interval", "Min and max intervals between unsolicited multicast RAs"
"DNSSL", "dnssl", "DNS search list to advertise"
"Name Server", "name-server", "Advertise DNS server per https://tools.ietf.org/html/rfc6106"
.. start_vyoslinter
Advertising a Prefix
--------------------
.. cfgcmd:: set service router-advert interface <interface> prefix <prefix/mask>
.. note:: You can also opt for using `::/64` as prefix for your :abbr:`RAs (Router
Advertisements)`. This will take the IPv6 GUA prefix assigned to the interface,
which comes in handy when using DHCPv6-PD.
.. stop_vyoslinter
.. csv-table::
:header: "VyOS Field", "Description"
:widths: 10,30
"decrement-lifetime", "Lifetime is decremented by the number of seconds since the last RA - use in conjunction with a DHCPv6-PD prefix"
"deprecate-prefix", "Upon shutdown, this option will deprecate the prefix by announcing it in the shutdown RA"
"no-autonomous-flag","Prefix can not be used for stateless address auto-configuration"
"no-on-link-flag","Prefix can not be used for on-link determination"
"preferred-lifetime","Time in seconds that the prefix will remain preferred (default 4 hours)"
"valid-lifetime","Time in seconds that the prefix will remain valid (default: 30 days)"
.. start_vyoslinter
Advertising a NAT64 Prefix
--------------------------
.. cfgcmd:: set service router-advert interface <interface> nat64prefix <prefix/mask>
Enable PREF64 option as outlined in :rfc:`8781`.
NAT64 prefix mask must be one of: /32, /40, /48, /56, /64 or 96.
.. note:: The well known NAT64 prefix is ``64:ff9b::/96``
.. stop_vyoslinter
.. csv-table::
:header: "VyOS Field", "Description"
:widths: 10,30
"valid-lifetime","Time in seconds that the prefix will remain valid (default: 65528 seconds)"
.. start_vyoslinter
Disabling Advertisements
------------------------
To disable advertisements without deleting the configuration:
.. cfgcmd:: set service router-advert interface <interface> no-send-advert
*******
Example
*******
Your LAN connected on eth0 uses prefix ``2001:db8:beef:2::/64`` with the router
beeing ``2001:db8:beef:2::1``
.. code-block:: none
set interfaces ethernet eth0 address 2001:db8:beef:2::1/64
set service router-advert interface eth0 default-preference 'high'
set service router-advert interface eth0 name-server '2001:db8::1'
set service router-advert interface eth0 name-server '2001:db8::2'
set service router-advert interface eth0 other-config-flag
set service router-advert interface eth0 prefix 2001:db8:beef:2::/64
|
