前置 Cloudflare
开启橙云后,部分行为不再由 nginx 决定。这一章只讲会改变行为的几个开关,以及三个必然会遇到的限制。
← 文档索引 · 上一章:边缘 nginx · 回到:部署概览
1. 先决定哪些域名过 CDN
| 域名 | 是否过 CDN | 原因 |
|---|---|---|
| 站点、控制台、身份、网关(业务域名) | 是(橙云) | 防攻击、缓存静态资源、隐藏源站 IP |
集群 API(kubectl 用的那个) |
否(灰云) | exec / logs 的 WebSocket 与大量流式响应不适合过代理,而且不该暴露到公网 |
| 需要从任意客户端直连的接口(如支付回调调试) | 视情况 | 过 CDN 后源站看到的是 Cloudflare IP,签名类回调不受影响 |
灰云只是把 DNS 记录指向源站、不经过 Cloudflare——证书、端口、限流全部由您的 nginx 负责。
2. DNS 与 SSL/TLS 模式
- DNS:业务域名加
A(或AAAA)记录指向源站 IP,打开橙云。代理状态就是开关。 - SSL/TLS → Overview:模式选 Full (strict)。
Flexible会让 Cloudflare 用 HTTP 回源,源站以为自己是明文——重定向循环与 Secure Cookie 丢失都从这里来;Full不校验证书,等于放弃回源这一段的真实性;只有源站只有自签证书时才临时用。
- Edge Certificates:最低 TLS 版本 1.2;打开
Always Use HTTPS;Automatic HTTPS Rewrites可选。 - 回源证书二选一:
- 源站 nginx 已有 Let's Encrypt 证书(上一章)→ 什么都不用做;
- 想让 Cloudflare 直连 NodePort(跳过 nginx)→ 用 Cloudflare Origin CA 签一张 15 年证书装到
Istio 的
Gateway上,模式仍是 Full (strict)。
Origin CA 证书浏览器不认,只能用于 Cloudflare 回源。它不能替代站点证书——两个方向各用各的。
3. 还原真实客户端 IP
不过这一步,源站日志里全是 Cloudflare 的地址,按 IP 的限流、风控与排查全部失效。
# 拉官方地址段(会变,务必定期更新)
curl -s https://www.cloudflare.com/ips-v4 https://www.cloudflare.com/ips-v6 \
| sed 's/^/set_real_ip_from /; s/$/;/' | sudo tee /etc/nginx/conf.d/cloudflare-realip.conf
在站点 server 块里(必须在 location 之外,否则只对某个路径生效):
real_ip_header CF-Connecting-IP;
验证:tail -f /var/log/nginx/access.log,$remote_addr 应变成真实的公网地址而不是 172.x。
Ubuntu 官方包的 nginx 已编译 http_realip_module;自行编译的要确认带了这个模块。
同时把源站防火墙只放行 Cloudflare 地址段(
ufw allow from <段> to any port 443), 否则知道源站 IP 的人可以绕过 CDN 直接打。
4. 缓存:只缓存静态资源
Cloudflare 默认只缓存它的"可缓存扩展名"(css/js/图片),这基本是对的。不要用
Cache Everything 规则覆盖页面与接口:
| 路径 | 规则 | 不这么做的后果 |
|---|---|---|
/_next/static/*、图片、字体 |
缓存(可设长 TTL) | 每次回源,静态资源拖慢首屏 |
| 页面 HTML | Bypass | 未登录用户看到上一个登录用户的内容,或登录后被缓存成"未登录" |
/graphql |
Bypass | 会话与权限被缓存,出现"换账号还是旧数据" |
/api/auth/*、/events(SSE) |
Bypass | 登录失败、事件流被缓冲或缓存 |
| 上传与 Webhook | Bypass | 请求体被缓存层截断 |
如果站点做了 staticAssetVersion 这类版本后缀,静态资源可以放心长缓存;否则用较短的 TTL
(如 1 天)并靠文件名变化更新。
5. 三个必然撞上的上限
| 上限 | Cloudflare 的值 | 撞上时的症状 | 处理 |
|---|---|---|---|
| 单请求体大小 | 免费/Pro 100 MB | 上传到 100% 返回 413,且与 nginx 的 client_max_body_size 无关 |
大于 100 MB 的上传走灰云子域,或升级套餐 |
| 源站响应超时 | 100 秒 | 长任务返回 524,日志显示源站实际上仍在执行 | 过 CDN 的接口必须"先返回后执行",或用 SSE 心跳保活 |
| 单连接空闲 | 由边缘决定 | SSE 长时间无数据被断 | 服务端每 15–30 秒发一次注释行心跳(: ping) |
第二条最容易误判:502/504 是源站的问题,524 一定是 Cloudflare 等不及了。看到 524 不要去 翻 Pod 日志找异常——那里什么都没有,请求还在正常执行。
6. WebSocket
Cloudflare 对 WebSocket 是默认支持、无需开关,但有两条注意:
- 必须用 wss(
https://的同端口),否则浏览器在 HTTPS 页面上会拒绝; - nginx 一侧的
Upgrade/Connection透传仍要配——Cloudflare 只是把握手转给你,不会替你升级。 见边缘 nginx 第 3 节的map块。
7. Certbot 在 CDN 之后怎么续期
证书在源站 nginx 上时,HTTP-01 校验要满足:http://titanides.com/.well-known/acme-challenge/xxx
从公网可达。橙云下这一条仍成立(Cloudflare 会回源),但两点会破坏它:
Always Use HTTPS把校验请求 301 到 HTTPS——Certbot 能跟随,通常不影响;如果加了强制跳转到 别的域名,就会失败;- 源站只放行 Cloudflare 地址段是正确的,但同时需要放行 80(HTTP-01 用 80)。
更稳的做法是 DNS-01(用 Cloudflare API token 签,支持通配符):
sudo apt install python3-certbot-dns-cloudflare
sudo certbot certonly --dns-cloudflare \
--dns-cloudflare-credentials /etc/letsencrypt/cloudflare.ini \
-d 'titanides.com' -d '*.titanides.com'
cloudflare.ini 里放一个只对目标 zone 有 Zone:DNS:Edit 权限的 API Token(不是 Global Key),
然后 sudo chmod 600。切换后在续期定时器上执行一次 certbot renew --dry-run。
8. 上线前逐条核对
# 1. 回源模式:响应头里应当只有一层 CF-Ray,且 https 正常
curl -sI https://titanides.com/ | grep -Ei 'cf-ray|server|location'
# 2. 真实 IP 已还原(源站上执行,看到真实公网地址而不是 Cloudflare 段)
tail -n 5 /var/log/nginx/access.log
# 3. 缓存没有命中动态路径(X-Cache 应为 MISS 或 BYPASS)
curl -sI https://titanides.com/graphql -X POST | grep -i 'cf-cache-status'
# 4. 大文件上限的真实位置(用略超 100 MB 的文件,看到 413 就是 CDN 拦的)
head -c 120000000 /dev/zero > /tmp/big.bin
curl -sS -o /dev/null -w '%{http_code}\n' -F 'file=@/tmp/big.bin' https://titanides.com/<上传接口>
第 4 条的意义在于区分是谁拦的:nginx 拦下的 413 会在源站访问日志里留一行;Cloudflare 拦下的 不会——日志里干干净净。