---
title: "Cloudflare 基础：域名、IP、Pages、Workers 与 Tunnel"
description: "用一张路径图理解 Cloudflare：域名和 DNS 怎么工作，Pages 和 Workers 分别适合什么，Tunnel 如何避免公网入站，以及出问题时的排查顺序。"
canonical: "https://localdeploy.dev/cloudflare"
source: "content/pages/cloudflare.md"
updatedAt: "2026-11-16"
lang: "zh"
altPath: "/en/cloudflare"
---


## 先把四层分开

很多排障之所以绕远路，是因为把不同层混在一起。把下面四层分开，问题会清楚很多：

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

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

## 域名与 DNS

### 注册商和 nameserver 不是一回事

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

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

```bash
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 是否匹配，最后看本地服务是否监听：

```bash
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 当成应用内鉴权。** 它保护入口，不替代应用自己的权限模型。

## 下一步

- 想判断自己的硬件适合跑什么：回到首页做一次资源评估。
- 想把多个服务收敛到一个入口：读 [Traefik 反向代理](/services#traefik)。
- 想在没有公网入站的情况下暴露服务：读 [cloudflared 内网穿透](/services#cloudflared)。
- 想先把安全底线补齐：读 [网络安全基础](/security)。

## Structured data

```json
{
  "@context": "https://schema.org",
  "@type": "WebPage",
  "name": "Cloudflare 基础：域名、IP、Pages、Workers 与 Tunnel",
  "url": "https://localdeploy.dev/cloudflare",
  "description": "用一张路径图理解 Cloudflare：域名和 DNS 怎么工作，Pages 和 Workers 分别适合什么，Tunnel 如何避免公网入站，以及出问题时的排查顺序。",
  "inLanguage": "zh",
  "isPartOf": {
    "@type": "WebSite",
    "name": "localdeploy.dev",
    "url": "https://localdeploy.dev/"
  }
}
```
