From 40491e76fc8776fcd21416e1ee16c5be337f6283 Mon Sep 17 00:00:00 2001 From: Viktor Liu <17948409+lixmal@users.noreply.github.com> Date: Wed, 19 Jun 2024 15:50:48 +0200 Subject: [PATCH] Add DNS route docs (#199) --- .../netbird-network-routes-dns-routes.png | Bin 0 -> 71125 bytes ...ng-default-routes-for-internet-traffic.mdx | 4 -- .../routing-traffic-to-private-networks.mdx | 40 +++++++++++++++++- 3 files changed, 38 insertions(+), 6 deletions(-) create mode 100644 public/docs-static/img/how-to-guides/netbird-network-routes-dns-routes.png diff --git a/public/docs-static/img/how-to-guides/netbird-network-routes-dns-routes.png b/public/docs-static/img/how-to-guides/netbird-network-routes-dns-routes.png new file mode 100644 index 0000000000000000000000000000000000000000..eed023bea4bc3b99dd3afef04161d411536d7949 GIT binary patch literal 71125 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

{e<}7b0Os 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 Y{C2BKdCB4lz!g{wp00i_>zopr07ZZc8~^|S literal 0 HcmV?d00001 diff --git a/src/pages/how-to/configuring-default-routes-for-internet-traffic.mdx b/src/pages/how-to/configuring-default-routes-for-internet-traffic.mdx index f1580907..754a3b88 100644 --- a/src/pages/how-to/configuring-default-routes-for-internet-traffic.mdx +++ b/src/pages/how-to/configuring-default-routes-for-internet-traffic.mdx @@ -31,10 +31,6 @@ Peers within the specified distribution group are configured to send their Inter VPN. This setup is activated as soon as the routing peer is connected. -### Supported Clients - -The feature currently supports Linux, macOS, iOS and Windows as client operating systems. - ### Routing Peer Selection Currently, this is exclusively configured through the dashboard and cannot be influenced by the client. diff --git a/src/pages/how-to/routing-traffic-to-private-networks.mdx b/src/pages/how-to/routing-traffic-to-private-networks.mdx index 83c6d53e..3a70de5a 100644 --- a/src/pages/how-to/routing-traffic-to-private-networks.mdx +++ b/src/pages/how-to/routing-traffic-to-private-networks.mdx @@ -26,10 +26,12 @@ In these cases, you can configure network routes assigning routing peers to conn ## Concepts ### Network routes -A network route describes the network you want to connect with your NetBird peers. It has an identifier, a network range, a routing peer, and some parameters available for managing priority and masquerading. +A network route describes the network you want to connect with your NetBird peers. It has an identifier, a network range or list of domains, a routing peer, and some parameters available for managing priority and masquerading. + - Network routes is available for NetBird [v0.9.0](https://github.com/netbirdio/netbird/releases) or later. + Network routes are available in NetBird [v0.9.0](https://github.com/netbirdio/netbird/releases) or later. + #### Network identifiers and ranges Network identifiers are names for each network you want to route traffic from your peers, and ranges are IP ranges declared in CIDR notation which refers to an external network. The combination of identifiers and these ranges makes a single network. #### Routing peer @@ -49,8 +51,41 @@ Nodes connected to routing peers will choose one of them to route packets to ext Masquerade hides other NetBird network IPs behind the routing peer local address when accessing the target Network range. This option allows access to your private networks without configuring routes on your local routers or other devices. If you don't enable this option, you must configure a route to your NetBird network in your external network infrastructure. + +### DNS Routes +An alternative to specifying a network range directly is to use DNS routes. Instead of adding the network directly, you can add multiple domains in a route that will be dynamically resolved on the client. The resolved IP addresses for these domains will be added as routes. For example, a network administrator can ensure that traffic to `website.com` or `api.website.com` is routed through a specific machine. So they configure DNS routes for these domains instead of specifying the IP ranges. + +By default, DNS routes are resolved every 60 seconds. You can adjust this interval using the `--dns-router-interval` flag: + + +```bash +netbird up --dns-router-interval 30s +``` + +Additionally, a keep routes switch is enabled by default. + +

+ high-level-dia +

+ +When the keep routes switch is on, and a domain no longer resolves to an IP address, the corresponding route will still be maintained (and any new resolved IP addresses will be added). +If the switch is off, the routes will be replaced with the newly resolved IP addresses. + +The purpose of the keep routes functionality is to retain previously resolved routes after IP address updates, in order to maintain stable connections. For example, long-running connections to an IP address that are still valid even if the DNS now resolves to a different IP address (e.g., DNS-based load balancing). + + + + DNS Routes are available for NetBird [v0.28.0](https://github.com/netbirdio/netbird/releases) or later. + + + + Currently, wildcard domains are not supported for DNS routes. + + ### Metric and priority Metric defines prioritization when choosing the main routing peer in a high availability network. Lower metrics have higher priority. +Outside of high availability routes, the metric has no effect. + ### Distribution groups Distribution groups define that peers that belong to these groups set in this field will receive the network route. @@ -58,6 +93,7 @@ Distribution groups define that peers that belong to these groups set in this fi It doesn't remove the need for the routing peer to be connected to these peers + ## Managing network routes A network route describes a network you want to connect with your NetBird peers. It has an identifier, a network range, a routing peer or set of peer groups, and some parameters available for managing priority and masquerading.