-
Notifications
You must be signed in to change notification settings - Fork 16.2k
docs update #27144
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
angelampcosta
merged 3 commits into
cloudflare:production
from
ncrouch-cflare:load-balancing-tunnel
Dec 16, 2025
Merged
docs update #27144
Changes from all commits
Commits
Show all changes
3 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
73 changes: 73 additions & 0 deletions
73
src/content/docs/load-balancing/private-network/public-to-tunnel.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,73 @@ | ||
| --- | ||
| pcx_content_type: how-to | ||
| title: Set up Private Network Load Balancing for Public traffic to Tunnel | ||
| sidebar: | ||
| order: 2 | ||
| --- | ||
|
|
||
| import { Render, TabItem, Tabs, APIRequest } from "~/components"; | ||
|
|
||
| Consider the following steps to learn how to configure Private Network Load Balancing solution, using [Cloudflare Tunnel](/cloudflare-one/networks/connectors/cloudflare-tunnel/) as the off-ramp to securely connect to your private or internal services. | ||
|
|
||
| ## 1. Configure a Cloudflare tunnel with an assigned virtual network | ||
|
|
||
| The specific configuration steps can vary depending on your infrastructure and services you are looking to connect. If you are not familiar with Cloudflare Tunnel, the pages linked on each step provide more guidance. | ||
|
|
||
| 1. [Create a tunnel](/cloudflare-one/networks/connectors/cloudflare-tunnel/get-started/create-remote-tunnel/#1-create-a-tunnel) to connect your data center to Cloudflare. | ||
| 2. Create a [virtual network](/cloudflare-one/networks/connectors/cloudflare-tunnel/private-net/cloudflared/tunnel-virtual-networks/) and assign it to the tunnel you configured in the previous step. | ||
|
|
||
| <Tabs> <TabItem label="Dashboard"> | ||
|
|
||
| To create a virtual network: | ||
|
|
||
| 1. Within the [Zero Trust dashboard](https://one.dash.cloudflare.com), go to **Settings** > **WARP Client** and find the **Virtual networks** setting. | ||
| 2. Select **Add new** or **Manage** > **Create virtual network** to create virtual networks. | ||
| 3. Define your virtual network name and select **Save**. | ||
|
|
||
| To assign the virtual network to the tunnel: | ||
|
|
||
| 1. Go to **Networks** > **Tunnels**. | ||
| 2. Select the tunnel you created in the previous steps and select **Configure**. | ||
| 3. Under **Private Network**, select **Add a private network**. | ||
| 4. Specify an IP range under **CIDR** and select the virtual network under **Additional settings**. | ||
| 5. Select **Save private network**. | ||
|
|
||
| </TabItem> <TabItem label="cli"> | ||
|
|
||
| To create a virtual network: | ||
|
|
||
| ```sh | ||
| cloudflared tunnel vnet add <VNET_NAME> | ||
| ``` | ||
|
|
||
| To assign the virtual network to the tunnel: | ||
|
|
||
| ```sh | ||
| cloudflared tunnel route ip add --vnet <VNET_NAME> <IP_RANGE> <TUNNEL_NAME> | ||
| ``` | ||
|
|
||
| </TabItem> </Tabs> | ||
|
|
||
| ## 2. Configure Cloudflare Load Balancing | ||
|
|
||
| Once you have Cloudflare tunnels with associated virtual networks (VNets) configured, the VNets can be specified for each endpoint when you [create or edit a pool](/load-balancing/pools/create-pool/#create-a-pool). This will enable Cloudflare load balancers to use the correct tunnel and securely reach the private IP endpoints. | ||
|
|
||
| The specific configuration will vary depending on your use case. Refer to the following steps to understand the workflow. | ||
|
|
||
| 1. [Create the Load Balancing monitor](/load-balancing/monitors/create-monitor/) according to your needs. | ||
| 2. [Create the pool](/load-balancing/pools/create-pool/) specifying your private IP addresses and corresponding virtual networks. | ||
|
|
||
| :::note | ||
|
|
||
| - Currently, Cloudflare does not support entering the same endpoint IP addresses more than once, even when using different virtual networks. | ||
| - All endpoints with private IPs must have `virtual_network_id` specified. | ||
|
|
||
| ::: | ||
|
|
||
| 3. [Create the load balancer](/load-balancing/load-balancers/create-load-balancer/), specifying the pool and monitor you created in the previous steps, as well as the desired [global traffic steering policies](/load-balancing/understand-basics/traffic-steering/steering-policies/) and [custom rules](/load-balancing/additional-options/load-balancing-rules/). | ||
|
|
||
| :::caution[Spectrum limitations] | ||
|
|
||
| If you will use the load balancer with [Spectrum](/spectrum/), consider the applicable [limitations](/load-balancing/additional-options/spectrum/#limitations) on load balancing and monitoring options. | ||
|
|
||
| ::: | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.