与管理静态 IP 列表和路由不同,您可以使用其主机名(例如 wiki.internal.local)将用户连接到私有 HTTP 和非 HTTP 应用程序。当应用程序具有未知或临时 IP 时(这通常发生在第三方云提供商预配基础设施时),私有主机名路由特别有用。
请求
wiki.internal.local- DNS 查询
- 主机名路由
将流量转发到您的私有网络,或将其出口到公共 Internet
- 私有主机
wiki.internal.local·10.0.0.50
用户请求私有主机名时,Cloudflare Gateway 会分配一个初始解析 IP,通过隧道将流量路由到正确的私有 IP 地址。默认情况下,这个 IP 来自 Cloudflare 拥有的公共 IPv4 地址段(172.64.128.0/20),而非运营商级 NAT(CGNAT)地址空间,因此不会触发 Google Chrome 的本地网络访问限制。如果该地址段与现有网络冲突,也可以配置自定义地址段。如需深入了解架构和数据包流向,请参阅公告博客文章 ↗。
下表总结了与私有主机名路由兼容的 Cloudflare One 产品。请参阅表格图例以获取解读指南。
✅ 产品可正常工作,无注意事项
🚧 产品可使用,但有一些注意事项
❌ 产品无法使用
终端用户可以使用以下流量入口连接到私有主机名:
| On-ramp 方法 | 兼容性 |
|---|---|
| Cloudflare One 客户端 | ✅ |
| PAC 文件 | ✅ |
| 浏览器隔离(Browser Isolation) | ✅ |
| Cloudflare Mesh | ✅ |
| Cloudflare WAN | 🚧1 |
功能可用性
| 客户端模式 |
|---|
| 流量和 DNS 模式 |
| 系统 | 可用性 | 最低客户端版本 |
|---|---|---|
| Windows | ✅ | 2025.4.929.0 |
| macOS | ✅ | 2025.4.929.0 |
| Linux | ✅ | 2025.4.929.0 |
| iOS | ✅ | 1.11 |
| Android | ✅ | 2.4.2 |
| ChromeOS | ✅ | 2.4.2 |
私有主机名路由适用于以下出口。其他流量出口需要基于 IP 的路由。
| 连接器 | 兼容性 | 最低版本 |
|---|---|---|
| cloudflared | ✅ | 2025.7.0 |
| Cloudflare Mesh | ✅ | 2026.6.822.0(Linux) |
| Cloudflare WAN | ❌ |
本节介绍如何使用 cloudflared 启用对私有主机名应用程序的远程访问。
在连接到私有主机名之前,您必须启用 Gateway 代理。
- 转到 Traffic policies(流量策略)> Traffic settings(流量设置)。
- 在 代理和检查 中,开启 允许 Secure Web Gateway 代理流量。
- 选择 TCP。
- 选择 UDP(将流量代理到内部 DNS 解析器所必需)。
- (推荐)要代理
ping和traceroute等诊断工具的流量,请选择 ICMP。你可能还需要更新系统,以允许 ICMP 流量通过cloudflared。
-
向您的
cloudflare_api_token↗ 添加以下权限:Zero Trust Write
-
使用
cloudflare_zero_trust_device_settings↗ 资源启用 TCP 和/或 UDP 代理:resource "cloudflare_zero_trust_device_settings "global_warp_settings" { account_id = var.cloudflare_account_id gateway_proxy_enabled = true gateway_udp_proxy_enabled = true }
现在,Cloudflare 将代理来自已注册设备的流量,但拆分隧道设置中排除的流量除外。有关 Gateway 如何转发流量的详细信息,请参阅 Gateway 代理。
您的设备还必须将以下流量转发到 Cloudflare:
- 初始解析 IP:
- IPv4:
172.64.128.0/20 - IPv6:
2606:4700:0cf1:4000::/64
这是默认范围。如果与现有网络冲突,你可以配置自定义 IPv4 初始解析 IP 范围。
- IPv4:
- 针对您私有主机名的 DNS 查询
具体配置步骤取决于你的设备接入方式:
Cloudflare One 客户端
在您的 WARP 设备配置文件中,配置分流隧道(Split Tunnels),使 初始解析的 IP 通过 WARP 隧道进行路由。配置取决于您的分流隧道模式:
- 排除模式:从您的分流隧道列表中删除
100.64.0.0/10。我们建议重新添加未明确用于 Cloudflare One 服务的 IP 范围。这可以减少与可能使用 CGNAT 地址空间的现有私有网络配置发生冲突的风险。 - 包含模式:为以下 IP 地址添加分流隧道条目:
- IPv4:
172.64.128.0/20 - IPv6:
2606:4700:0cf1:4000::/64
这是默认范围。如果与现有网络冲突,你可以配置自定义 IPv4 初始解析 IP 范围。
- IPv4:
- 排除模式:从您的分流隧道列表中删除
- 在本地域回退(Local Domain Fallback)中,删除您私有主机名的顶级域。这将配置 WARP 将 DNS 查询发送到 Cloudflare Gateway 进行解析。
Cloudflare Mesh
要让 Mesh 节点而非 cloudflared 隧道接收发往主机名的流量,请向该节点添加主机名路由。上文列出的 初始解析 IP 必须在 Mesh 节点和客户端设备配置文件中通过 Cloudflare 路由。对于私有主机名,该节点还必须能够解析主机名(通过本地 hosts 文件或 Gateway 解析器策略)。请参阅主机名路由。
Cloudflare WAN
- 确保上述列出的初始解析 IP通过 Cloudflare WAN 路由到 Cloudflare。
- 将您 Cloudflare WAN 网络的 DNS 解析器指向 Cloudflare Gateway。
-
登录 Cloudflare 仪表板,转到 Networking(网络) > Tunnels(隧道)。
前往 Tunnels(隧道) ↗ -
选择 Create a tunnel(创建隧道)。
-
为您的隧道输入名称。我们建议选择能够反映您希望通过此隧道连接的资源类型的名称(例如,
enterprise-VPC-01)。 -
选择 Create Tunnel(创建隧道)。
-
选择您的操作系统,然后复制安装命令并在您的源服务器的终端上运行。
-
等待隧道连接。连接建立后,选择 Continue(继续)。
-
连接隧道后,转到隧道的 Routes(路由) 选项卡并选择 Add route(添加路由),然后选择 Private hostname(私有主机名)。
-
输入代表您应用程序的完全限定域名 (FQDN)(例如,
wiki.internal.local)。主机名格式限制
- 字符限制:必须少于 255 个字符。
- 支持的通配符:允许使用单个通配符(
*),且它必须代表一个完整的 DNS 标签。 示例:*.internal.local - 不支持的通配符:不支持以下通配符格式:
- 部分通配符,例如
*-dev.internal.local或dev-*.internal.local。 - 中间的通配符,例如
foo*bar.internal.local或foo.*.internal.local。 - 主机名中的多个通配符,例如
*.*.internal.local。
- 部分通配符,例如
- 通配符修剪:前导通配符(
*)会被修剪掉,并假定有一个隐式的点(.)。例如,*.internal.local会保存为internal.local,但会匹配通配符级别的所有子域名(涵盖foo.internal.local,但不涵盖foo.bar.internal.local)。 - 点修剪:允许前导点和尾随点(
.),但会被修剪掉。
-
选择 Save(保存)。
当 Gateway 收到对您私有主机名的请求时,它必须将该主机名解析为私有 IP 地址。根据您的网络拓扑,有两种配置方法。
默认情况下,cloudflared 使用在其主机上配置的私有 DNS 解析器(例如 Linux 上的 /etc/resolv.conf)。
如果运行 cloudflared 的机器已经能够使用本地系统解析器将 wiki.internal.local 解析为私有 IP,就无需进一步配置。你可以直接跳到步骤 3。
如果您需要让 cloudflared 使用不同于主机默认解析器的特定内部 DNS 服务器,则必须通过 IP/CIDR 路由将该 DNS 服务器显式连接到 Cloudflare。您还需要配置 Gateway 解析器策略,将查询路由到这个特定的私有 DNS 服务器。
-
要为 DNS 服务器创建 IP/CIDR 路由:
-
转到 Networking(网络) > Routes(路由)。
前往 Routes(路由) ↗ -
选择 Add CIDR route(添加 CIDR 路由)。
-
输入您内部 DNS 解析器的私有 IP 地址。
-
选择连接到该 DNS 服务器所在网络的 Cloudflare Tunnel。
-
选择 Create(创建)。
-
-
要创建解析器策略:
- 转到 Traffic policies(流量策略) > Resolver policies。
- 选择 Create a policy(创建策略)。
- 创建匹配私有主机名的表达式:
选择器 运算符 值 主机 属于 wiki.internal.local - 在 Configure custom DNS resolvers 下,输入您内部 DNS 服务器的私有 IP 地址。
- 从下拉菜单中,选择
- Private路由选项以及分配给您在上一步中选择的隧道的虚拟网络。 - 选择 Create a policy(创建策略)。
默认情况下,注册到您的 Zero Trust 组织的所有设备都可以通过 Cloudflare Tunnel 连接到您的私有网络。您可以配置 Gateway 来检查您的网络流量,并根据用户身份和设备安全状况来阻止或允许访问。要了解有关策略设计的更多信息,请参阅保护您的第一个应用程序。
为防止 Cloudflare One Client 用户访问您的整个私有网络,我们建议为您的私有 IP 空间创建一个兜底 Gateway 阻止策略。然后,您可以在此基础上叠加更高优先级的允许策略(在 Access 或 Gateway 中),以授予用户对特定应用程序或 IP 的访问权限。
您可以为您的私有主机名创建 Access 自托管应用程序,并在此应用程序中配置 Access 策略。此选项允许您将用户访问与您的 SaaS 及其他 Web 应用程序一起进行管理。
如果你更愿意使用传统防火墙模型保护应用,可以使用 SNI 或 SNI Domain 选择器构建 Gateway 网络策略。要增加一层保护,请添加 Gateway DNS 策略,允许或阻止解析 Host 或 Domain。
网络策略示例
以下示例由两个策略组成:第一个策略允许特定用户访问您的应用程序,第二个策略阻止所有其他流量。
- 允许公司员工
| 选择器 | 运算符 | 值 | 逻辑 | 操作 |
|---|---|---|---|---|
| SNI | in | wiki.internal.local |
且 (And) | 允许 (Allow) |
| 用户电子邮件 (User Email) | matches regex | .*@example.com |
- 通配阻止策略
| 选择器 | 运算符 | 值 | 操作 |
|---|---|---|---|
| 目标 IP (Destination IP) | in | 10.0.0.0/8 |
阻止 (Block) |
DNS 策略示例
| 选择器 | 运算符 | 值 | 逻辑 | 操作 |
|---|---|---|---|---|
| 主机 (Host) | in | wiki.internal.local |
且 (And) | 允许 (Allow) |
| 用户电子邮件 (User Email) | matches regex | .*@example.com |
终端用户现在可以通过访问其私有主机名来访问该应用程序。例如,要连接到私有 Web 应用程序,请打开浏览器并访问 wiki.internal.local。
如果您无法连接,请验证以下内容:
-
确认 DNS 解析 - 在设备上,确认您可以成功解析私有主机名:
nslookup wiki.internal.localServer: 127.0.2.2 Address: 127.0.2.2#53 Non-authoritative answer: Name: wiki.internal.local Address: 172.64.128.48查询应使用 WARP 的 DNS 代理进行解析,并返回 Gateway 初始解析 IP。如果查询解析失败或返回不同的 IP,请检查本地域回退配置和 Gateway 解析器策略。
-
检查 Gateway 日志 - 查看您的 Gateway 网络日志以查看连接是否被策略阻止。
-
验证隧道状态 - 通过检查隧道状态确认您的隧道健康且已连接。
测试与初始解析 IP 的连接 - 当您使用私有主机名连接到应用程序时,设备应与初始解析 IP建立连接:
curl -v4 http://wiki.internal.local* Trying 172.64.128.48:80... * Connected to wiki.internal.local (172.64.128.48) port 80 ...如果请求失败,请确认初始解析 IP 通过 WARP 隧道路由。您还可以检查您的隧道日志以确认请求已路由到应用程序's 私有 IP。
-
检查证书错误 - 如果私有 HTTPS 应用返回错误 526,则 Gateway 无法验证源站证书。请创建匹配该应用的 Gateway HTTP Allow 策略,并将不受信任的证书操作设置为 Pass through。
从 Chrome 142 ↗ 起,本地网络访问(LNA)会限制网站向本地 IP 地址发出的请求。LNA 在 Chromium 引擎层面实现,因此会影响所有基于 Chromium 的浏览器(例如 Microsoft Edge、Brave 和 Opera),不只是 Google Chrome。如果账户的 Gateway 初始解析 IP 范围仍来自运营商级 NAT(CGNAT)地址空间(100.64.0.0/10),就可能受到影响,例如旧版默认范围 100.80.0.0/16,或在 CGNAT 空间中配置的自定义范围。这些浏览器会将此类地址归类为本地网络地址。当从公共 IP 加载的网站向解析为此空间内初始解析 IP 的域名发起子请求时,浏览器会将其视为从公共网络到本地网络的请求,并提示用户允许访问本地网络上的设备。用户接受提示前,浏览器会阻止向这些域名发出的请求。
当出口策略匹配广泛使用的域名(例如 cloudfront.net 或 github.com),导致公共页面的子请求解析到 CGNAT 空间时,通常会发生这种情况。
使用当前默认初始解析 IP 范围(172.64.128.0/20)的账户不受影响,因为此范围属于 Cloudflare 公共地址空间,而非 CGNAT。如果账户在默认范围变更前创建,或配置了自定义 CGNAT 空间范围,请参阅配置初始解析 IP,迁移到非 CGNAT 范围,无需依赖以下浏览器变通方法。
以下变通方法使用 Google Chrome 企业策略。如果组织管理其他基于 Chromium 的浏览器,请查阅该浏览器的企业策略文档,寻找等效控制项。
如果受影响的请求源自 iframe 内部(例如嵌入在第三方门户中的应用程序),则 iframe 必须声明 local-network-access 权限,以便在父框架中显示浏览器提示:
- Chrome 142-144:在 iframe 元素上使用
allow="local-network-access"属性。 - Chrome 145+:该权限被拆分为
allow="local-network"和allow="loopback-network"。
如果 iframe 是嵌套的,则链中的每个 iframe 都必须包含相应的属性。由于第三方应用程序控制着它们自己的 iframe 属性,这可能无法由最终用户进行配置。
为避免此问题,请选择以下选项之一:
- 覆盖 IP 地址空间分类(Chrome 146+):使用
LocalNetworkAccessIpAddressSpaceOverrides↗ Chrome 企业策略,将 CGNAT 空间中的初始解析 IP 范围(例如100.80.0.0/16)重新归类为公共地址。这是最有针对性的修复方式,因为它只更改初始解析 IP 范围的分类,而不会完全禁用安全检查。 - Chrome 140+(允许特定 URL):使用
LocalNetworkAccessAllowedForUrls↗ Chrome 企业版策略使特定网站免受本地网络访问检查。请注意,https://*是停用所有 URL 检查的有效条目。 - Chrome 146+(允许特定 URL):使用
LocalNetworkAllowedForUrls↗ Chrome 企业版策略,从 Chrome 146 开始,该策略会替换LocalNetworkAccessAllowedForUrls。 - Chrome 142-152(选择退出本地网络访问限制):使用
LocalNetworkAccessRestrictionsTemporaryOptOut↗ Chrome 企业版策略完全退出本地网络访问限制。这是一项临时策略,将在 Chrome 152 之后移除。 - 停用 Chrome 功能标志:转到
chrome://flags,然后将 Local Network Access Checks 标志设置为 Disabled。此方法适用于个人用户,但不适用于企业级部署。