动态与公告

产品动态

安全公告

产品公告

产品简介

产品概述

产品优势

应用场景

EdgeOne 与 CDN 等产品功能对比

使用限制

购买指南

试用套餐体验权益说明

免费版套餐使用说明

计费概述

计费项目

购买指引

续费指引

欠费与退款说明

套餐选型对比

关于“干净流量”计费说明

DDoS 防护容量说明

快速入门

选择业务场景

快速接入网站安全加速

通过 Pages 快速部署网站

域名服务与源站配置

域名服务

HTTPS 证书

源站配置

站点加速

概述

访问控制

智能加速

缓存配置

文件优化

网络优化

URL 重写

修改头部

修改应答内容

规则引擎

图片与视频处理

单连接下载限速

DDoS 与 Web 防护

概述

DDoS 防护

Web 防护

Bot 管理

API 资产识别（Beta）

边缘函数

概述

快速指引

操作指引

Runtime APIs

示例函数

实践教程

Pages

四层代理

概述

新建四层代理实例

修改四层代理实例配置

停用/删除四层代理实例

批量配置转发规则

获取客户端真实IP

数据分析与日志服务

日志服务

数据分析

告警服务

站点与计费管理

计费管理

站点管理

版本管理

通用策略

通用参考

配置语法

请求与响应行为

国家/地区及对应代码枚举

Terraform

Terraform 简介

安装和配置 Terraform

实践教程

自动预热/清除缓存

防盗刷/盗链实践

HTTPS 相关实践

加速优化

流量调度

数据分析与告警

第三方日志平台集成实践

对象存储类源站（例如：COS）配置实践

跨域响应配置

API 文档

History

Introduction

API Category

Making API Requests

Site APIs

Acceleration Domain Management APIs

Site Acceleration Configuration APIs

Edge Function APIs

Alias Domain APIs

Security Configuration APIs

Layer 4 Application Proxy APIs

Content Management APIs

Data Analysis APIs

Log Service APIs

Billing APIs

Certificate APIs

Origin Protection APIs

Load Balancing APIs

Diagnostic Tool APIs

Custom Response Page APIs

API Security APIs

DNS Record APIs

Content Identifier APIs

Legacy APIs

Ownership APIs

Image and Video Processing APIs

Multi-Channel Security Gateway APIs

Version Management APIs

Data Types

Error Codes

常见问题

产品特性相关问题

DNS 记录相关问题

域名配置相关问题

站点加速相关问题

数据与日志相关问题

安全防护相关问题

源站配置相关问题

排障指南

异常状态码参考

EdgeOne 4XX/5XX 状态码排障指南

520/524状态码排障指南

521/522 状态码排障指南

工具指南

变量

PDF

聚焦模式

字号

最后更新时间： 2025-12-05 14:25:02

简介
配置中，变量允许您动态提取和处理请求中的数据。这些变量不仅可以存储静态值，还可以引用请求中的特定字段或信息，其值在处理每个请求时都可能变化。例如：http.request.host 变量，它可以提取每个 HTTP 请求中的 hostname。这种能力使规则引擎能够处理更复杂的业务逻辑。
内容
以下是目前 EdgeOne 支持的预设变量 - 从客户端 HTTP 请求中获取特定的字段或信息作为变量。
说明：
使用变量时，请遵循以下格式：${http.request.scheme}。若格式或名称不正确，则无法成功使用变量。
目前仅支持单独使用变量，不允许变量与常量，或变量 A 与变量 B 拼接等形式。
名称
类型
说明
示例
可使用模块
http.request.scheme
String
客户端请求协议（应用层协议 HTTP/HTTPS）
http
﻿
https
站点加速, 
Web 防护
http.request.zone
String
站点名称
example.com
站点加速
http.request.zoneid
String
站点 ID
zone-2c2r77pc3796
站点加速
http.request.host
String
客户端请求 URI 中的 hostname
www.example.com
站点加速, 
Web 防护
http.request.full_uri
String
客户端请求的完整 URI（不包括 #fragment）
https://www.example.org/articles/index?section=539061&expand=comments
站点加速
http.request.method
String
客户端请求 HTTP 方法（Method）
GET
站点加速,
 Web 防护
http.request.uri
String
客户端请求的 URI 路径和查询字符串（包含 Path + Argument，不包含 Scheme 和 Host）
/articles/index?section=539061&expand=comments
站点加速, 
Web 防护
http.request.uri.path
String
客户端请求的 URI 路径
/articles/index
站点加速, 
Web 防护
http.request.file_extension
String
客户端请求文件的文件后缀
jpg
站点加速, 
Web 防护 (with additional '.')
http.request.filename
String
客户端请求文件的文件名
bot.txt
站点加速
http.request.uri.query
String
客户端请求的整个查询字符串，不包括？分隔符
section=539061&expand=comments
站点加速, 
Web 防护
http.request.headers["key"]
String
客户端请求指定头部名称为 “key” 的头部值，“key” 可替换为您指定的名称
https://developer.mozilla.org
站点加速, 
Web 防护
http.request.uri.args["key"]
String
客户端查询字符串指定参数名称为 “key” 的参数值，“key” 可替换为您指定的名称
value
站点加速
http.request.version
String
客户端请求所使用的 HTTP 协议的版本
HTTP/1.0
﻿
HTTP/1.1
﻿
HTTP/2
﻿
HTTP/3
站点加速
http.request.ip
String
客户端 TCP IP 地址，例如：1.1.1.1
93.184.216.34
站点加速, 
Web 防护
http.request.ip.port
String
客户端源端口
1028
站点加速
http.request.ip.city
String
与客户端 IP 地址相关联的城市
San Francisco
站点加速
http.request.ip.continent
String
与客户端 IP 地址相关联的大洲代码
AF: 非洲 (Africa)
﻿
AS: 亚洲 (Asia)
﻿
EU: 欧洲 (Europe)
﻿
NA: 北美洲 (North America)
﻿
SA: 南美洲 (South America)
﻿
OC: 大洋洲 (Oceania)
﻿
AN: 南极洲 (Antarctica)
站点加速
http.request.ip.country
String
与客户端 IP 地址相关联的以 ISO 3166-1 Alpha 2 格式的 2 字母国家代码
GB，更多见 [ISO 3166-1 Alpha 2 规范]
站点加速, 
Web 防护 (planned)
http.request.ip.version
Integer
客户端请求的 IP 协议版本（网络层协议 IPv4/IPv6）
4
﻿
6
Web 防护
http.request.xff_header_ip
String
当请求中包含 X-Forwarded-For 头部时，为 X-Forwarded-For 头部中第一个 IP，即被代理的原始客户端 IP；当请求中不包含 X-Forwarded-For 头部时，为请求的客户端 IP。
93.184.216.34
Web 防护
http.request.cookies["key"]
String
客户端请求中指定名称为 “key” 的 Cookie 会话值，“key” 可替换为您指定的名称
MySessionId
Web 防护
http.request.ja3
String
客户端请求的 JA3 指纹（TLS 指纹）
e7d705a3286e19ea42f587b344ee6865
Web 防护
http.request.ip.reputation
String
客户端 IP 的信誉度（客户端画像分析），包括历史恶意行为类型和信誉置信度。
scanners.medium
Web 防护
http.request.ip.isp
String
客户端 IP 所属的运营机构
chinatelecom.com
Web 防护
http.request.bot.search_engine_bot
String
客户端请求来源的搜索引擎爬虫分类
googlebot_image
Web 防护
http.request.bot.known_bot_type
String
客户端请求的 User-Agent 头部所表示的已知爬虫类型
web_developer_tools
Web 防护
http.request.bot.behavioral_analysis.tag
String
客户端请求的智能分析结果分类
malicious_bot
﻿
suspected_bot
Web 防护
http.request.bot.behavioral_analysis.rule_id
String
客户端请求的智能分析的详细特征 ID
botba-1320255933
Web 防护
http.request.bot.session
Object
客户端请求中所包含的 Bot 会话信息。包括会话的详细特征：
status：会话状态
ip：会话的初始 IP
-
Web 防护
http.request.bot.token
Object
客户端请求中包含的 Bot 校验票据信息。包括票据的详细状态：
status：票据是否有效
bot_client：客户端校验结果为 Bot 客户端
browser_client：客户端校验结果为浏览器客户端
-
Web 防护
http.request.ip.asn
String
与客户端 IP 地址相关联的 ASN
130340
Web 防护
http.request.xff_header_ip
String
客户端IP(优先匹配XFF头部)
93.184.216.34
Web 防护
http.request.bot.search_engine_bot_id
String
搜索引擎爬虫配置，用于处置来自搜索引擎爬虫的请求。此类请求的 IP、User-Agent 或 rDNS 结果匹配已知搜索引擎爬虫。
搜索引擎爬虫特征 ID
Web 防护
http.request.bot.known_bot_category_id
String
商业或开源工具 UA 特征配置（原 UA 特征规则），用于处置来自已知商业工具或开源工具的访问请求。此类请求的 User-Agent 头部符合已知商业或开源工具特征。
-
Web 防护
http.request.ip.source_idc_id
String
﻿ 客户端 IP 的来源 IDC 特征 ID。用于匹配来自 IDC（数据中心） 的客户端 IP 的访问请求。此类来源请求不是由移动端或浏览器端直接访问。
-
Web 防护
http.request.ip.reputation_id
String
﻿ IP 威胁情报库特征 ID，用于匹配来自近期访问行为具有特定风险特征的客户端 IP 的请求。
-
Web 防护
http.request.bot.bot_rating_id
String
﻿ 智能 Bot 分析评级
-
Web 防护
http.request.bot.bot_intelligence_details
String
﻿智能 Bot 分析对请求分析后，提取的爬虫风险详情
-
Web 防护
﻿

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

边缘安全加速平台 EO

变量

简介

内容

帮助和支持

名称	类型	说明	示例	可使用模块
http.request.scheme	String	客户端请求协议（应用层协议 HTTP/HTTPS）	http https	站点加速, Web 防护
http.request.zone	String	站点名称	example.com	站点加速
http.request.zoneid	String	站点 ID	zone-2c2r77pc3796	站点加速
http.request.host	String	客户端请求 URI 中的 hostname	www.example.com	站点加速, Web 防护
http.request.full_uri	String	客户端请求的完整 URI（不包括 #fragment）	https://www.example.org/articles/index?section=539061&expand=comments	站点加速
http.request.method	String	客户端请求 HTTP 方法（Method）	GET	站点加速, Web 防护
http.request.uri	String	客户端请求的 URI 路径和查询字符串（包含 Path + Argument，不包含 Scheme 和 Host）	/articles/index?section=539061&expand=comments	站点加速, Web 防护
http.request.uri.path	String	客户端请求的 URI 路径	/articles/index	站点加速, Web 防护
http.request.file_extension	String	客户端请求文件的文件后缀	jpg	站点加速, Web 防护 (with additional '.')
http.request.filename	String	客户端请求文件的文件名	bot.txt	站点加速
http.request.uri.query	String	客户端请求的整个查询字符串，不包括？分隔符	section=539061&expand=comments	站点加速, Web 防护
http.request.headers["key"]	String	客户端请求指定头部名称为 “key” 的头部值，“key” 可替换为您指定的名称	https://developer.mozilla.org	站点加速, Web 防护
http.request.uri.args["key"]	String	客户端查询字符串指定参数名称为 “key” 的参数值，“key” 可替换为您指定的名称	value	站点加速
http.request.version	String	客户端请求所使用的 HTTP 协议的版本	HTTP/1.0 HTTP/1.1 HTTP/2 HTTP/3	站点加速
http.request.ip	String	客户端 TCP IP 地址，例如：1.1.1.1	93.184.216.34	站点加速, Web 防护
http.request.ip.port	String	客户端源端口	1028	站点加速
http.request.ip.city	String	与客户端 IP 地址相关联的城市	San Francisco	站点加速
http.request.ip.continent	String	与客户端 IP 地址相关联的大洲代码	AF: 非洲 (Africa) AS: 亚洲 (Asia) EU: 欧洲 (Europe) NA: 北美洲 (North America) SA: 南美洲 (South America) OC: 大洋洲 (Oceania) AN: 南极洲 (Antarctica)	站点加速
http.request.ip.country	String	与客户端 IP 地址相关联的以 ISO 3166-1 Alpha 2 格式的 2 字母国家代码	GB，更多见 [ISO 3166-1 Alpha 2 规范]	站点加速, Web 防护 (planned)
http.request.ip.version	Integer	客户端请求的 IP 协议版本（网络层协议 IPv4/IPv6）	4 6	Web 防护
http.request.xff_header_ip	String	当请求中包含 X-Forwarded-For 头部时，为 X-Forwarded-For 头部中第一个 IP，即被代理的原始客户端 IP；当请求中不包含 X-Forwarded-For 头部时，为请求的客户端 IP。	93.184.216.34	Web 防护
http.request.cookies["key"]	String	客户端请求中指定名称为 “key” 的 Cookie 会话值，“key” 可替换为您指定的名称	MySessionId	Web 防护
http.request.ja3	String	客户端请求的 JA3 指纹（TLS 指纹）	e7d705a3286e19ea42f587b344ee6865	Web 防护
http.request.ip.reputation	String	客户端 IP 的信誉度（客户端画像分析），包括历史恶意行为类型和信誉置信度。	scanners.medium	Web 防护
http.request.ip.isp	String	客户端 IP 所属的运营机构	chinatelecom.com	Web 防护
http.request.bot.search_engine_bot	String	客户端请求来源的搜索引擎爬虫分类	googlebot_image	Web 防护
http.request.bot.known_bot_type	String	客户端请求的 User-Agent 头部所表示的已知爬虫类型	web_developer_tools	Web 防护
http.request.bot.behavioral_analysis.tag	String	客户端请求的智能分析结果分类	malicious_bot suspected_bot	Web 防护
http.request.bot.behavioral_analysis.rule_id	String	客户端请求的智能分析的详细特征 ID	botba-1320255933	Web 防护
http.request.bot.session	Object	客户端请求中所包含的 Bot 会话信息。包括会话的详细特征： status：会话状态 ip：会话的初始 IP	-	Web 防护
http.request.bot.token	Object	客户端请求中包含的 Bot 校验票据信息。包括票据的详细状态： status：票据是否有效 bot_client：客户端校验结果为 Bot 客户端 browser_client：客户端校验结果为浏览器客户端	-	Web 防护
http.request.ip.asn	String	与客户端 IP 地址相关联的 ASN	130340	Web 防护
http.request.xff_header_ip	String	客户端IP(优先匹配XFF头部)	93.184.216.34	Web 防护
http.request.bot.search_engine_bot_id	String	搜索引擎爬虫配置，用于处置来自搜索引擎爬虫的请求。此类请求的 IP、User-Agent 或 rDNS 结果匹配已知搜索引擎爬虫。	搜索引擎爬虫特征 ID	Web 防护
http.request.bot.known_bot_category_id	String	商业或开源工具 UA 特征配置（原 UA 特征规则），用于处置来自已知商业工具或开源工具的访问请求。此类请求的 User-Agent 头部符合已知商业或开源工具特征。	-	Web 防护
http.request.ip.source_idc_id	String	客户端 IP 的来源 IDC 特征 ID。用于匹配来自 IDC（数据中心）的客户端 IP 的访问请求。此类来源请求不是由移动端或浏览器端直接访问。	-	Web 防护
http.request.ip.reputation_id	String	IP 威胁情报库特征 ID，用于匹配来自近期访问行为具有特定风险特征的客户端 IP 的请求。	-	Web 防护
http.request.bot.bot_rating_id	String	智能 Bot 分析评级	-	Web 防护
http.request.bot.bot_intelligence_details	String	智能 Bot 分析对请求分析后，提取的爬虫风险详情	-	Web 防护