Table of Contents

6relayd IPv6 server and relay configuration

The /etc/config/6relayd configures the 6relayd IPv6 server & relay.

6relayd is a daemon for serving and relaying IPv6 management protocols to configure clients and downstream routers.

6relayd provides server services for RA, stateless DHCPv6, DHCPv6-PD and can be used to relay RA, DHCPv6 and NDP between routed (non-bridged) interfaces in case no delegated prefixes are provided by the upstream router.

Examples

Example #1: Provide Router Discovery and stateless DHCPv6 in server mode and fallback to relaying if there is no public prefix on the master interface.

config server option master 'wan6' option network 'lan guest' option rd 'server' option dhcpv6 'server' option fallback_relay 'rd dhcpv6 ndp'

Example #2: Create a relay for several networks (here wan6 and lan) in proxy mode. This can be used to proxy Router Discovery, DHCPv6 and NDP.

config server option master 'wan6' option network 'lan' option rd 'relay' option dhcpv6 'relay' option ndp 'relay'

Example #3: Provide Router Discovery and stateless DHCPv6 in server mode This can be used as a small radvd and stateless DHCPv6-server replacement.

config server option network 'lan' option rd 'server' option dhcpv6 'server'

Sections

Each section of type 'server defines an instance of 6relayd that will be run.

Services of 6relayd can be used in two modes:

  • server if you want to use 6relayd to only announce the router and / or use it as a stateless DHCPv6 server.
  • relay for all other use cases (e.g. relaying between different interfaces, proxying NDP, acting as a DHCPv6 relay, …).
Name Values Required Default Description
master 1 <logical interface> yes, if services in relay-mode are present Specifies the network which is used as master for relaying
network 1 or more <logical interface> yes Specifies the network on which the 6relayd instance should provide services (first network is master, if section type is relay)
rd [relay,server] no Router Discovery mode of operation (empty = disabled)
dhcpv6 [relay,server] no DHCPv6 mode of operation (empty = disabled)
ndp [relay] no NDP-Proxy mode of operation (empty = disabled)
compat_ula [0,1] no 0 Ensure compatbility with broken devices and deprecate ULA if public prefixes are available.
fallback_relay 1 or more [rd,dhcpv6,ndp] no Services to relay as fallback if there is no public prefix on the wan interface available
always_rewrite_dns [0,1] no 0 Define whether the RD- and DHCPv6-relay will always announce the DNS on the router itself instead of the one provided from the upstream router
rewrite_dns_addr <IPv6-address> no Override the announced DNS-server with the specified address
always_assume_default [0,1] no 0 Define whether the RD-server will assume that IPv6 connectivity is present even if no public addresses are announced.

Back to top

doc/uci/6relayd.txt · Last modified: 2013/04/24 09:24 by steven