HGfast Cloud 灵狐加速 · 一站式全球云网络返回首页

Cloudflare Origin Rules怎么设置?从控制台到API的完整配置指南

更新于 2026-11-15 · hgfastapp.lol

简答:Cloudflare Origin Rules用于改变请求回源的主机、DNS目标、SNI或端口。先确认域名已通过代理,再在Rules Overview创建Origin Rule,按主机名或路径匹配请求并部署。

定义:Cloudflare Origin Rules是一组按请求条件匹配、并修改回源主机、解析目标、TLS SNI或目标端口的规则。

先看结论:你应该设置哪一种Origin Rule

如果你只是想把网站请求发送到非标准端口,设置Destination port;如果要把某个域名或路径发送到另一台源站,通常需要组合DNS record override与Host header override;如果源站证书选择依赖另一个主机名,再单独检查SNI。官方文档说明,Origin Rules要求相关DNS记录通过Cloudflare代理。

截至2026年11月15日页面显示,Cloudflare列出的可覆盖项目包括Host header、SNI、DNS record和destination port;规则通过过滤表达式决定哪些请求生效。可先阅读官方Origin Rules总览确认账户页面中的能力。

你的目标主要设置是否通常需要组合
整站改回源端口Destination port通常不需要
按路径转发到另一台源站DNS record override通常还要Host header override
第三方源站只接受指定域名Host header override通常还要DNS record override
TLS证书由另一个主机名匹配SNI override需检查Host与证书关系

先试这一步:打开Cloudflare控制台的Rules Overview,确认目标域名或子域名的DNS记录是Proxied状态,再进入Create rule > Origin Rule。

配置前检查:代理状态、源站和套餐能力

  1. 确认DNS代理。Origin Rules不能用于未通过Cloudflare代理的相关DNS记录。若记录为DNS only,先核对是否需要切换为Proxied。
  2. 准备源站信息。记录真实源站主机名、监听端口、源站证书包含的域名,以及应用是否根据Host header选择站点。
  3. 确认账户能力。官方页面列出Free、Pro、Business和Enterprise均有Origin Rules,但规则数量和可覆盖项目不同:端口覆盖在各列出的方案中可用,而Host、SNI和DNS覆盖在页面表格中标为Enterprise能力。当前账户的实际可用入口仍应以控制台显示为准。
  4. 区分公网解析与回源解析。DNS record override改变的是Cloudflare向哪个源站发请求,不等于让访客端看到的公共DNS答案发生同样变化。
检查项通过标准不通过时先做什么
DNS记录目标主机名存在且代理状态符合要求检查记录类型、目标和值是否正确
源站端口安全组、防火墙和应用均监听该端口从源站本机确认监听状态
证书证书覆盖实际SNI或Host对应名称核对证书SAN与回源模式
规则权限能看到Origin Rule创建入口检查账户方案和Token权限

控制台设置步骤:从匹配条件到部署

  1. 登录Cloudflare控制台,进入目标站点的Rules Overview。
  2. 选择Create rule > Origin Rule。官方控制台文档也列出可选模板,模板生成后仍需检查和修改。
  3. 在Rule name填写便于回滚的名称,例如app-path-to-origin-b。
  4. 设置匹配表达式。整站可以按主机名匹配;按路径转发时,建议先限定主机名,再限定URI路径。
  5. 在Then或源站覆盖区域选择需要的参数:Destination port、DNS record、Host header或SNI。
  6. 先使用Save as Draft或等效草稿选项检查规则;确认表达式和参数后再选择Deploy。不同账户的按钮文字可能变化,无法核实的菜单名称不要写死。
  7. 访问一个必然命中的URL,检查HTTP状态、证书和应用日志;若没有命中,使用Rules simulator验证该请求是否触发规则。

官方控制台流程可核对Origin Rule控制台创建说明。如果匹配的是一个新的主机名,还要先确认对应主机名已有可代理的DNS记录,否则规则可能没有可用的请求入口。

三个可改写的脱敏示例

场景匹配表达式示例覆盖项
按主机名转发http.host eq "app.example.com"DNS record与Host header
按路径转发http.host eq "www.example.com" and starts_with(http.request.uri.path, "/app/")DNS record、Host header或端口
按路径改端口starts_with(http.request.uri.path, "/calendar/")Destination port,例如8081

Host、DNS、SNI和端口到底怎么配

DNS record override决定Cloudflare解析并连接哪个源站;Host header override决定HTTP请求告诉源站“我要访问哪个站点”。因此,目标源站既需要被找到,又需要根据指定域名返回内容时,两者通常要一起配置。

Cloudflare官方设置说明指出,Host header覆盖通常会同步更新原请求的SNI。如果Host和SNI必须不同,应额外添加SNI override;SNI覆盖值需要是同一Cloudflare账户中的有效主机名,当前页面说明其使用静态值。

Destination port只改变回源目标端口,端口范围为1至65535。它不会自动修复源站防火墙、应用监听或证书问题。完整参数说明见Origin Rules设置参考。

参数改变什么常见误区
DNS recordCloudflare连接的源站主机误以为会直接修改访客公共DNS
Host headerHTTP请求中的Host值只改Host却没有可达的源站目标
SNITLS握手中发送的主机名证书不包含该名称导致握手失败
Destination port回源连接端口源站没有监听或防火墙未放行

用API创建Origin Rule:规则阶段、权限与示例

需要自动化部署时,官方流程是使用Rulesets API,规则动作设为route,参数放在action_parameters,并部署到Zone级别的http_request_origin阶段。先查询目标Zone是否已有该阶段的ruleset;没有时创建一个kind: zone、phase: http_request_origin的ruleset,再更新规则。

API Token需要具备官方页面列出的Origin Rules编辑权限。下面是将/app/路径发送到指定源站并同步设置Host的脱敏示例,使用前请替换环境变量,并先备份当前ruleset中的全部规则,因为更新请求可能提交完整规则列表。

export ZONE_ID="你的Zone_ID"
export RULESET_ID="你的Origin_Ruleset_ID"
export CLOUDFLARE_API_TOKEN="你的API_Token"

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/rulesets/$RULESET_ID" \
  --request PUT \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "rules": [
      {
        "ref": "app_origin_override",
        "expression": "http.host eq \"www.example.com\" and starts_with(http.request.uri.path, \"/app/\")",
        "description": "Route app path to origin B",
        "action": "route",
        "action_parameters": {
          "host_header": "origin.example.net",
          "origin": {
            "host": "origin.example.net"
          }
        }
      }
    ]
  }'

如果只改端口,可将action_parameters改为包含origin.port;如果要单独设定SNI,可使用sni.value。字段结构和示例应以官方Origin Rules API文档为准,不要把网页示例中的占位符直接用于生产环境。

规则不生效或出现525、526、502时怎么查

  1. 先查是否命中。用Rules simulator测试完整URL,确认主机名、路径、查询条件与表达式一致。官方总览把Rules simulator列为Origin Rules排查工具。
  2. 再查DNS代理。确认请求进入的主机名对应Proxied记录,而不是DNS only或不存在的记录。
  3. 检查规则合并。多个Origin Rule同时匹配时,配置会合并,后面的规则可能覆盖前面规则中的同一参数。建议让路径更具体的规则放在容易识别的位置,并记录每条规则的用途。
  4. 检查Host与证书。出现525 SSL handshake failed时,重点检查SNI、源站443端口、TLS协议和证书;出现526 Invalid SSL certificate时,重点检查证书有效性、域名匹配与SSL模式。
  5. 检查源站应用。出现502或应用返回404时,使用源站日志确认请求是否到达,以及应用是否识别新的Host、路径和端口。
  6. 排除旧规则影响。如果同时存在旧的Page Rule和Origin Rule,官方FAQ说明Origin Rule参数会覆盖Page Rule中的对应参数;多个Origin Rule命中时则会合并设置。可暂时停用冲突规则,再逐条恢复。
错误可改进修正栏
规则保存后访问仍到旧源站匹配表达式未命中或DNS未代理用Rules simulator测试主机名和路径,并确认Proxied状态
525 SSL handshake failedSNI、证书或回源端口不匹配按实际证书名称设置SNI,检查源站端口和TLS配置
526 Invalid SSL certificate证书不覆盖回源使用的主机名核对证书SAN、Host header和SNI三者关系
路径返回404源站应用未识别原始路径或Host检查应用路由、Host处理和源站访问日志

FAQ中关于规则冲突与多规则合并的说明,可参考Origin Rules官方FAQ。

Origin Rules与其他功能的边界

Origin Rules解决的是“请求最终回哪个源站、使用哪个Host、SNI或端口”。如果目标是让访客跳转到新URL,应考虑Redirect Rules;如果目标是修改访客看到的URI路径,应考虑URL Rewrite Rules;如果要根据复杂逻辑访问多个后端,则需要评估Workers、Load Balancing或其他架构。

不要用Origin Rules代替源站防火墙配置、DNS基础解析、证书签发或应用路由。设置完成后,应分别验证:规则是否命中、请求是否抵达正确源站、TLS握手是否成功、应用是否返回预期内容。规则执行顺序和可用功能可以继续查看Cloudflare Rules官方文档索引。

常见问题

Cloudflare Origin Rules需要把DNS改成代理状态吗?

需要。官方说明要求相关域名或子域名的DNS记录通过Cloudflare代理,否则Origin Rule无法按预期处理这些请求。

只设置DNS record override,不设置Host header可以吗?

技术上可以存在只改DNS目标的场景,但如果源站根据Host选择站点,通常还要设置Host header;否则请求可能到达正确服务器却返回错误站点或404。

Host header和SNI必须设置成一样吗?

不一定。Host覆盖通常会同步影响SNI;如果TLS握手需要不同的主机名,应额外配置SNI override,并核对该名称对应的证书和账户资格。

Cloudflare Origin Rules可以把请求转发到任意端口吗?

Destination port的配置范围是1至65535,但实际能否访问还取决于Cloudflare支持的回源端口、源站监听、防火墙和应用协议,不能只看规则是否保存成功。

多个Origin Rules同时命中时哪条优先?

官方FAQ说明,多个规则命中时配置会合并,后面的规则会覆盖前面规则中相同的设置。因此应避免宽泛表达式与具体路径表达式产生意外重叠。

Origin Rules和Redirect Rules有什么区别?

Origin Rules改变Cloudflare到源站的回源方式,访客通常仍访问原URL;Redirect Rules向访客返回跳转,让浏览器改访问地址,两者解决的问题不同。

相关阅读

参考资料

  1. Cloudflare Origin Rules官方总览
  2. Cloudflare控制台创建Origin Rule
  3. Cloudflare Origin Rules设置参考
  4. Cloudflare通过API创建Origin Rule
  5. Cloudflare Origin Rules官方FAQ
  6. Cloudflare Rules官方文档索引