跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

连接私有主机名

最后更新 查看 MarkdownAgent 设置

与管理静态 IP 列表和路由不同,您可以使用其主机名(例如 wiki.internal.local)将用户连接到私有 HTTP 和非 HTTP 应用程序。当应用程序具有未知或临时 IP 时(这通常发生在第三方云提供商预配基础设施时),私有主机名路由特别有用。

  1. 请求 wiki.internal.local

  2. DNS 查询
  3. 返回一个令牌 IP,然后将目标重写为真实 IP。

    172.64.128.0/20
  4. 主机名路由
  5. 将流量转发到您的私有网络,或将其出口到公共 Internet

  6. 私有主机

    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 产品。请参阅表格图例以获取解读指南。

✅ 产品可正常工作,无注意事项
🚧 产品可使用,但有一些注意事项
❌ 产品无法使用

设备连接

终端用户可以使用以下流量入口连接到私有主机名:

功能可用性

客户端模式
流量和 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

Footnotes

  1. 与 ECMP 路由不兼容。要使基于主机名的路由正常工作,DNS 查询和生成的网络流量必须通过相同的 IPsec/GRE 隧道到达 Cloudflare。
    ↩

私有网络连接

私有主机名路由适用于以下出口。其他流量出口需要基于 IP 的路由。

连接器 兼容性 最低版本
cloudflared ✅ 2025.7.0
Cloudflare Mesh ✅ 2026.6.822.0(Linux)
Cloudflare WAN ❌

连接私有主机名

本节介绍如何使用 cloudflared 启用对私有主机名应用程序的远程访问。

前提条件

在连接到私有主机名之前,您必须启用 Gateway 代理。

  1. 转到 Traffic policies(流量策略)> Traffic settings(流量设置)。
  2. 在 代理和检查 中,开启 允许 Secure Web Gateway 代理流量。
  3. 选择 TCP。
  4. 选择 UDP(将流量代理到内部 DNS 解析器所必需)。
  5. (推荐)要代理 ping 和 traceroute 等诊断工具的流量,请选择 ICMP。你可能还需要更新系统,以允许 ICMP 流量通过 cloudflared。
  1. 向您的 cloudflare_api_token ↗ 添加以下权限:

    • Zero Trust Write
  2. 使用 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 范围。

  • 针对您私有主机名的 DNS 查询

具体配置步骤取决于你的设备接入方式:

Cloudflare One 客户端

  1. 在您的 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 范围。

  2. 在本地域回退(Local Domain Fallback)中,删除您私有主机名的顶级域。这将配置 WARP 将 DNS 查询发送到 Cloudflare Gateway 进行解析。

Cloudflare Mesh

要让 Mesh 节点而非 cloudflared 隧道接收发往主机名的流量,请向该节点添加主机名路由。上文列出的 初始解析 IP 必须在 Mesh 节点和客户端设备配置文件中通过 Cloudflare 路由。对于私有主机名,该节点还必须能够解析主机名(通过本地 hosts 文件或 Gateway 解析器策略)。请参阅主机名路由。

Cloudflare WAN

  1. 确保上述列出的初始解析 IP通过 Cloudflare WAN 路由到 Cloudflare。
  2. 将您 Cloudflare WAN 网络的 DNS 解析器指向 Cloudflare Gateway。

1. 将应用程序连接到 Cloudflare

  1. 登录 Cloudflare 仪表板,转到 Networking(网络) > Tunnels(隧道)。

    前往 Tunnels(隧道) ↗
  2. 选择 Create a tunnel(创建隧道)。

  3. 为您的隧道输入名称。我们建议选择能够反映您希望通过此隧道连接的资源类型的名称(例如,enterprise-VPC-01)。

  4. 选择 Create Tunnel(创建隧道)。

  5. 选择您的操作系统,然后复制安装命令并在您的源服务器的终端上运行。

  6. 等待隧道连接。连接建立后,选择 Continue(继续)。

  1. 连接隧道后,转到隧道的 Routes(路由) 选项卡并选择 Add route(添加路由),然后选择 Private hostname(私有主机名)。

  2. 输入代表您应用程序的完全限定域名 (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)。
    • 点修剪:允许前导点和尾随点(.),但会被修剪掉。
  3. 选择 Save(保存)。

2. 配置 DNS 解析

当 Gateway 收到对您私有主机名的请求时,它必须将该主机名解析为私有 IP 地址。根据您的网络拓扑,有两种配置方法。

方案 A:使用系统解析器(默认)

默认情况下,cloudflared 使用在其主机上配置的私有 DNS 解析器(例如 Linux 上的 /etc/resolv.conf)。

如果运行 cloudflared 的机器已经能够使用本地系统解析器将 wiki.internal.local 解析为私有 IP,就无需进一步配置。你可以直接跳到步骤 3。

方案 B:使用特定的私有 DNS 服务器(高级)

如果您需要让 cloudflared 使用不同于主机默认解析器的特定内部 DNS 服务器,则必须通过 IP/CIDR 路由将该 DNS 服务器显式连接到 Cloudflare。您还需要配置 Gateway 解析器策略,将查询路由到这个特定的私有 DNS 服务器。

  1. 要为 DNS 服务器创建 IP/CIDR 路由:

    1. 转到 Networking(网络) > Routes(路由)。

      前往 Routes(路由) ↗
    2. 选择 Add CIDR route(添加 CIDR 路由)。

    3. 输入您内部 DNS 解析器的私有 IP 地址。

    4. 选择连接到该 DNS 服务器所在网络的 Cloudflare Tunnel。

    5. 选择 Create(创建)。

  2. 要创建解析器策略:

    1. 转到 Traffic policies(流量策略) > Resolver policies。
    2. 选择 Create a policy(创建策略)。
    3. 创建匹配私有主机名的表达式:
      选择器运算符值
      主机属于wiki.internal.local
    4. 在 Configure custom DNS resolvers 下,输入您内部 DNS 服务器的私有 IP 地址。
    5. 从下拉菜单中,选择 - Private 路由选项以及分配给您在上一步中选择的隧道的虚拟网络。
    6. 选择 Create a policy(创建策略)。

3. (推荐)使用 Gateway 过滤网络流量

默认情况下,注册到您的 Zero Trust 组织的所有设备都可以通过 Cloudflare Tunnel 连接到您的私有网络。您可以配置 Gateway 来检查您的网络流量,并根据用户身份和设备安全状况来阻止或允许访问。要了解有关策略设计的更多信息,请参阅保护您的第一个应用程序。

为防止 Cloudflare One Client 用户访问您的整个私有网络,我们建议为您的私有 IP 空间创建一个兜底 Gateway 阻止策略。然后,您可以在此基础上叠加更高优先级的允许策略(在 Access 或 Gateway 中),以授予用户对特定应用程序或 IP 的访问权限。

选项 1:Access 应用程序(推荐)

您可以为您的私有主机名创建 Access 自托管应用程序,并在此应用程序中配置 Access 策略。此选项允许您将用户访问与您的 SaaS 及其他 Web 应用程序一起进行管理。

选项 2:Gateway 防火墙策略

如果你更愿意使用传统防火墙模型保护应用,可以使用 SNI 或 SNI Domain 选择器构建 Gateway 网络策略。要增加一层保护,请添加 Gateway DNS 策略,允许或阻止解析 Host 或 Domain。

网络策略示例

以下示例由两个策略组成:第一个策略允许特定用户访问您的应用程序,第二个策略阻止所有其他流量。

  1. 允许公司员工
选择器 运算符 值 逻辑 操作
SNI in wiki.internal.local 且 (And) 允许 (Allow)
用户电子邮件 (User Email) matches regex .*@example.com
  1. 通配阻止策略
选择器 运算符 值 操作
目标 IP (Destination IP) in 10.0.0.0/8 阻止 (Block)

DNS 策略示例

选择器 运算符 值 逻辑 操作
主机 (Host) in wiki.internal.local 且 (And) 允许 (Allow)
用户电子邮件 (User Email) matches regex .*@example.com

4. 测试连接

终端用户现在可以通过访问其私有主机名来访问该应用程序。例如,要连接到私有 Web 应用程序,请打开浏览器并访问 wiki.internal.local。

故障排除

如果您无法连接,请验证以下内容:

  1. 确认 DNS 解析 - 在设备上,确认您可以成功解析私有主机名:

    nslookup wiki.internal.local
    Server:		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 解析器策略。

  2. 检查 Gateway 日志 - 查看您的 Gateway 网络日志以查看连接是否被策略阻止。

  3. 验证隧道状态 - 通过检查隧道状态确认您的隧道健康且已连接。

  4. 测试与初始解析 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。

  5. 检查证书错误 - 如果私有 HTTPS 应用返回错误 526,则 Gateway 无法验证源站证书。请创建匹配该应用的 Gateway HTTP Allow 策略,并将不受信任的证书操作设置为 Pass through。

限制

Google Chrome 限制对私有主机名的访问

从 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 内部(例如嵌入在第三方门户中的应用程序),则 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。此方法适用于个人用户,但不适用于企业级部署。

这篇文档对您有帮助吗?