Private network routing allows you to proxy HTTP/HTTPS traffic from public hostnames to origins in your private network. When you enable this setting on a DNS record, Cloudflare reaches the origin over your private network connectivity instead of the public Internet.
For end-to-end setup, refer to the guide for your connectivity type: Cloudflare WAN, Cloudflare Tunnel, or Cloudflare Mesh.
Before you enable private network routing, consider the following:
- Private Origins needs to be available on your account and you need a working connection to your private network through Cloudflare WAN (IPsec, GRE, or CNI), Cloudflare Tunnel, or Cloudflare Mesh. The route to the origin must be in your default virtual network.
- If you connect over Cloudflare WAN or Cloudflare Mesh, your account must be on Unified Routing. Contact your account team to enable it. This applies to new and existing accounts. Cloudflare Tunnel does not need Unified Routing.
- Private network routing is available for
A(IPv4) andAAAA(IPv6) records only. Records must be proxied. - If you have multiple
AorAAAArecords on the same name, and at least one of them has private network routing enabled, all records on that name will use private network routing. This is consistent with the proxy status behavior in these cases.
The following private address ranges are automatically detected:
| Range | Description |
|---|---|
10.0.0.0/8 |
Private (RFC 1918 ↗︎) |
172.16.0.0/12 |
Private (RFC 1918 ↗︎) |
192.168.0.0/16 |
Private (RFC 1918 ↗︎) |
fc00::/7 |
Private (RFC 4193 ↗︎) |
100.64.0.0/10 |
CGNAT (RFC 6598 ↗︎) |
When you use an IP address from one of these ranges, the Use private network routing toggle turns on automatically. You can also turn it on manually for public IP addresses that are only reachable through your tunnel.
When Cloudflare reaches an origin over Cloudflare WAN or Cloudflare Mesh, traffic comes from the Cloudflare source IP ranges:
| IP version | Range | Configurable |
|---|---|---|
| IPv4 | 100.64.0.0/12 (default) |
Yes, to another private /12 |
| IPv6 | 2606:4700:cf1:5000::/64 |
No |
Add return routes in your private network that send these ranges back to Cloudflare, and allow them in your origin's firewall. Refer to Configure Cloudflare source IPs.
Behind Cloudflare Tunnel, your origin sees the host running cloudflared as the source instead.
-
In the Cloudflare dashboard, go to the DNS Records page.
Go to Records ↗ -
Select Add record or select Edit on an existing
AorAAAArecord. -
Enter the origin IP address.
-
Verify that Proxy status is enabled (orange cloud).
-
Turn on Use private network routing.
For private IP addresses (for example,
10.0.0.50), the toggle turns on automatically. For public IP addresses used with private infrastructure, turn on the toggle manually. -
Select Save.
To create a record with private routing enabled, use a POST request and set private_routing to true:
Required API token permissions
At least one of the following token permissions is required:DNS Write
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records" \
--request POST \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--json '{
"type": "A",
"name": "app.example.com",
"content": "10.0.0.50",
"proxied": true,
"private_routing": true
}'To enable private routing on an existing record, use a PATCH request:
Required API token permissions
At least one of the following token permissions is required:DNS Write
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records/$DNS_RECORD_ID" \
--request PATCH \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--json '{
"private_routing": true
}'If you use the API to create or edit DNS records with private network routing, consider the following:
| Scenario | private_routing value |
|---|---|
Proxied A/AAAA record with private IP |
Auto-set to true |
Proxied A/AAAA record with public IP |
Defaults to false |
Non-A/AAAA record types |
Field not supported |
Also, if you manually set private_routing: false on a proxied A/AAAA record with private IP, the API will return an error.