笔记

Cloudflare 基础:域名、IP、Pages、Workers 与 Tunnel

用一张路径图理解 Cloudflare:域名和 DNS 怎么工作,Pages 和 Workers 分别适合什么,Tunnel 如何避免公网入站,以及出问题时的排查顺序。

先把四层分开

排障绕远路,多半是把不同层混在一起了。分开看,会清楚很多:

  1. 域名与 DNS:用户输入的名字,如何解析到一个地址。
  2. 边缘网络:Cloudflare 接住请求,决定缓存、转发、拦截还是拒绝。
  3. 源站或隧道:请求最终落到哪台机器、哪个端口、哪个进程。
  4. 应用:进程是否在跑、配置是否生效、日志说了什么。

一个 502 可能来自源站没监听、隧道配置错了、应用崩了,也可能来自 Access 策略。先定位在哪一层,再去改配置。

域名与 DNS

注册商和 nameserver 不是一回事

  • 注册商负责“这个名字归谁”,以及续费。
  • DNS 托管负责“这个名字指向哪”。把 nameserver 改到 Cloudflare 后,解析记录在 Cloudflare 管理。

常见错误是改了注册商面板里的 A 记录,但 nameserver 早就指向 Cloudflare,于是改动没有任何效果。先确认当前 nameserver:

dig +short NS your-domain.tld

返回的应该是 Cloudflare 分配的两个 nameserver,而不是注册商默认的。

记录类型

类型 用途 注意
A 名字指向 IPv4 家宽公网 IP 可能变化,需要 DDNS
AAAA 名字指向 IPv6 本机没有 IPv6 出口时不要随便加
CNAME 名字指向另一个名字 根域名能否用 CNAME 取决于 DNS 提供商
TXT 验证、SPF、DKIM 等 不要把所有验证记录堆在同一个名字下
MX 邮件 改了会影响收信,先确认现有记录

代理开关与 TTL

橙色云朵表示请求经过 Cloudflare 代理;灰色表示只做 DNS 解析(DNS only)。代理开启后,TTL 由 Cloudflare 管理,源站证书和回源策略也需要一起考虑。

一个实用原则:先让服务在 DNS only 下可用,再打开代理。 这样能区分“源站不可达”和“边缘配置有问题”。

DNSSEC

DNSSEC 能降低 DNS 缓存投毒的风险,但它不是“打开就万事大吉”。启用后如果 DS 记录和 Cloudflare 的密钥不同步,域名可能直接解析失败。启用前确认注册商支持,启用后不要随手改 nameserver。

IP 地址与端口

公网 IP、NAT 和 CGNAT

家庭宽带拿到的“公网 IP”不一定是真的公网 IPv4:

  • 真公网 IPv4:可以在外部直接访问。
  • NAT 后面:需要端口映射,且运营商可能封 80/443。
  • CGNAT:多个用户共享一个出口 IP,端口映射通常无效。

判断方法之一是看路由器 WAN 口地址:10.、172.16–31.、192.168. 开头通常是私网。即使 WAN 口是公网地址,运营商也可能在上层做 NAT。

为什么优先 Tunnel 而不是端口映射

端口映射把内网服务直接暴露到公网,扫描器会在几分钟内找到它。更稳的做法是:

  • 用 Cloudflare Tunnel 或 VPN 让请求从内到外建立连接,不在路由器上开入站端口。
  • 在应用前加一层身份认证,而不是只靠“路径没人知道”。
  • 源站只监听内网地址,不监听 0.0.0.0。

如果必须做端口映射,至少限制来源 IP、只开必要端口、把服务放在独立网段,并确认应用本身有认证。

Pages:静态站点

Cloudflare Pages 适合静态 HTML/CSS/JS、预渲染站点和轻量 Pages Functions。

  • 构建:连接 Git 仓库或上传构建产物;构建命令和输出目录要写对。
  • 自定义域:绑定后仍要走 DNS;证书由 Cloudflare 签发。
  • 预览环境:每个分支可以有自己的预览地址,注意预览地址默认可能被搜索引擎看到。
  • 限制:Pages 不是通用服务器。需要常驻进程、数据库连接池或大文件处理时,考虑 Workers、容器或自己的机器。

一个常见误区是把 Pages 当成“免费服务器”。它能很好地托管静态文件,但不会替你运行一个长期在线的应用进程。

Workers:边缘函数

Workers 适合在边缘做请求处理:鉴权、重写、A/B、轻量 API、定时任务。

  • 绑定:KV、D1、R2、Queues 都是通过绑定访问,不在代码里写账号密钥。
  • 路由:可以挂在自定义域或 workers.dev 上;注意路由匹配顺序。
  • Cron:定时任务需要在配置里声明触发器,否则不会执行。
  • 日志:用 wrangler tail 或控制台日志排查;不要在生产日志里打印令牌和个人数据。

Workers 有 CPU 时间和请求限制。把重活放到队列或源站,边缘只做轻量判断。

Tunnel:从内到外的连接

Cloudflare Tunnel 的模型是:内网机器主动向外建立连接,Cloudflare 把公网请求通过这条连接送回内网。因此不需要在路由器上开入站端口。

典型步骤:

  1. 在目标机器上安装 cloudflared。
  2. 创建 tunnel,拿到 token 或凭据文件。
  3. 配置 ingress:域名 → 本地服务地址。
  4. 在 DNS 里把域名指向 tunnel。
  5. 需要身份认证时,在 Access 里加应用和策略。

排障时先看 tunnel 是否连上,再看 ingress 是否匹配,最后看本地服务是否监听:

cloudflared tunnel info <tunnel-name>
curl -I http://127.0.0.1:8080

“tunnel 是 healthy 的”只说明连接在,不代表本地服务可达,也不代表 Host 头匹配。

R2、D1、Queues

  • R2:对象存储,适合图片、备份、交付文件。默认私有,公开访问要显式配置。
  • D1:SQLite 风格的边缘数据库,适合小规模结构化数据和元数据;不要把它当高并发主库。
  • Queues:异步任务,适合把慢操作从请求路径里拿出去;要设计重试和死信。

选型时先问:“这个数据需要强一致吗?访问频率多高?失败后能不能重放?”答案会决定用 D1、R2 还是自己的数据库。

排障顺序

现象 先看什么 常见原因
域名打不开 dig、nameserver、DNS 记录 nameserver 没生效、记录被删、DNSSEC 配置错误
证书错误 边缘证书状态、源站证书 源站证书过期、代理模式与源站端口不匹配
502 / 521 / 522 源站是否监听、隧道是否连上 进程没起、端口写错、防火墙拦截
一直登录页 Access 应用和策略 策略不匹配、服务令牌没带上
内容不更新 缓存状态、构建版本 缓存规则命中、部署没生效、浏览器缓存
只有部分人能访问 地域、IP、设备策略 Access 规则、WAF、速率限制

常见误区

  • 把 cf-cache-status 当应用日志。 它只说明边缘有没有缓存,不说明应用返回了什么。
  • 把 502 都归因于隧道。 隧道健康、源站没监听时仍然是 502。
  • 在 Pages 上跑常驻服务。 静态托管不是通用计算。
  • 开了代理却用源站 IP 直连测试。 你测到的不是用户实际走的路径。
  • 把 Access 当成应用内鉴权。 它保护入口,不替代应用自己的权限模型。

相关笔记

  • 判断这台机器适合跑什么:回首页做一次资源评估。
  • 暴露之前先把底线补上:网络安全基础。
  • 选一台机器的系统:系统选型。
有问题就发邮件。纠错、提问或者聊项目,都发到 [email protected]。本页也有 Markdown 版本:/zh/cloudflare.md。