Skip to content

Commit 3e9aba7

Browse files
committed
add local domain fallback
1 parent b201f49 commit 3e9aba7

File tree

1 file changed

+13
-1
lines changed

1 file changed

+13
-1
lines changed

src/content/docs/cloudflare-one/connections/connect-networks/private-net/cloudflared/connect-private-hostname.mdx

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,11 @@ Configure Gateway to resolve the private hostname using your internal DNS resolv
9898

9999
### 5. Route traffic through WARP
100100

101-
In your [device profiles](/cloudflare-one/connections/connect-devices/warp/configure-warp/device-profiles/), [configure Split Tunnels](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels/) so that the following IPs route through the WARP tunnel:
101+
This section details routing requirements for WARP client deployments. For information about WARP Connector and other connectivity methods, refer to [Supported on-ramps](#device-connectivity).
102+
103+
#### Split Tunnels
104+
105+
In your WARP [device profiles](/cloudflare-one/connections/connect-devices/warp/configure-warp/device-profiles/), configure [Split Tunnels](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels/) so that the following IPs route through the WARP tunnel:
102106

103107
- <GlossaryTooltip term="initial resolved IP">Initial resolved IP</GlossaryTooltip> CGNAT range:
104108
<Render file="gateway/egress-selector-cgnat-ips" />
@@ -107,6 +111,10 @@ In your [device profiles](/cloudflare-one/connections/connect-devices/warp/confi
107111

108112
For more details on configuring Split Tunnels, refer to [Route private network IPs through WARP](/cloudflare-one/connections/connect-networks/private-net/cloudflared/connect-cidr/#3-route-private-network-ips-through-warp).
109113

114+
#### Local Domain Fallback
115+
116+
By default, the WARP client uses the local DNS resolver on the device to resolve common local domains (such as `.internal` and `local`). These top-level domains are on your [Local Domain Fallback](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/local-domains/) list and bypass the Gateway resolver. To resolve a private hostname with Gateway, [delete its domain](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/local-domains/#delete-a-domain) from Local Domain Fallback.
117+
110118
### 6. (Recommended) Filter network traffic with Gateway
111119

112120
<Render file="tunnel/filter-network-traffic" />
@@ -174,6 +182,10 @@ If you [enabled the Gateway proxy](#enable-the-gateway-proxy), you can view the
174182

175183
### Troubleshooting
176184

185+
:::note
186+
Routing issues are the most common type of misconfiguration. Make sure to check WARP Split Tunnels and Local Domain Fallback as described in [Step 5](#5-route-traffic-through-warp).
187+
:::
188+
177189
For a step-by-step troubleshooting procedure, refer to [Troubleshoot private network connectivity](/cloudflare-one/connections/connect-networks/troubleshoot-tunnels/private-networks/).
178190

179191
## Supported on-ramps/off-ramps

0 commit comments

Comments
 (0)