内置变量

匹配变量

匹配变量值的是有正则表达式的地方，使用匹配结果，通常为一个从0开始的数字，比如在重写规则中：

那么

${0} - 表示整体匹配的内容
${1} - 表示第一个括号匹配的内容
${2} - 表示第二个括号匹配的内容

可以使用(?i)来设置不区分大小写：

也可以给变量设置一个名称：

然后就可以在待替换字符串中使用 ${myName} ：

${edgeVersion} - 边缘节点的版本
${remoteAddr} - 客户端地址（IP），会依次根据X-Forwarded-For、X-Real-IP、RemoteAddr获取，适合前端有别的反向代理服务时使用；如果前端没有别的反向代理，则存在被伪造的风险
${rawRemoteAddr} - 客户端地址（IP），返回直接连接服务的客户端原始IP地址，如果前端有别的反向代理，可能会返回前端反向代理的地址，而不是真实的客户端地址
${remotePort} - 客户端端口
${remoteUser} - 客户端用户名
${requestId} - 请求ID，类似于1638414954148000001，v0.3.7加入
${requestURI} - 请求URI，比如/hello?name=lily
${requestPath} - 请求路径（不包括参数），比如/hello
${requestURL} - 完整的请求URL，比如https://example.com/hello?name=lily，v0.2.5版本加入
${requestPathExtension} - 请求路径中的文件扩展名，包括点符号，比如.html、.png
${requestLength} - 请求内容长度
${requestMethod} - 请求方法，比如GET、POST
${requestFilename} - 请求文件路径
${scheme} - 请求协议，http或https
${proto} - 包含版本的HTTP请求协议，类似于HTTP/1.0
${timeISO8601} - ISO 8601格式的时间，比如2018-07-16T23:52:24.839+08:00
${msec} - 带有毫秒的时间，比如1531756823.054
${timestamp} - unix时间戳，单位为秒
${host} - 主机名，通常是请求的域名
- 主机名第一段，比如www.example.com的值为www
${host.last} - 主机名最后一段，比如www.example.com的值为com
${host.N} - 主机名的第几段，从0开始，N最大为4，即${host.0}、${host.1}…${host.4}
${host.-N} - 主机名的倒数第几段，从-1开始，比如对于www.example.com的${host.-1}值为com，N最大为5
${serverName} - 接收请求的服务器名
${serverPort} - 接收请求的服务器端口
${referer} - 请求来源URL
${referer.host} - 请求来源URL域名，在v0.2.6中加入
${userAgent} - 客户端信息
${contentType} - 请求头部的Content-Type
${request} - 构造类似于”GET / HTTP/1.1”之类的请求字符串
${cookie.NAME} - 单个cookie值，比如${cookie.sid}
${isArgs} - 问号（?）标记，如果URL有参数，则值为?；否则，则值为空，在v0.3.7中加入
${args} - 所有URL参数组合字符串
${arg.NAME} - 单个URL参数值，比如${arg.name}
${headers} - 所有Header信息组合字符串
${header.NAME} - 单个Header值，比如${header.User-Agent}
${documentRoot} - 当前请求的文档根目录

${geo.country.name} - 国家/地区名称，v0.4.0加入
${geo.country.id} - 国家/地区ID，v0.4.0加入
${geo.province.name} - 省份名称（目前只包含中国省份），v0.4.0加入
${geo.province.id} - 省份ID（目前只包含中国城市），v0.4.0加入
${geo.city.name} - 城市名称（目前只包含中国城市），v0.4.0加入
${geo.city.id} - 城市ID（目前只包含中国城市），v0.4.0加入

${isp.name} - ISP服务商名称，v0.4.0加入
- ISP服务商ID，v0.4.0加入

${browser.os.name} - 客户端所在操作系统名称，v0.4.0加入
${browser.os.version} - 客户端所在操作系统版本，v0.4.0加入
${browser.version} - 客户端浏览器版本，v0.4.0加入
${browser.isMobile} - 手机标识，如果客户端是手机，则值为1，否则为0，v0.4.0加入

${product.name} - 产品名，可以在”系统设置”–“管理界面设置”中设置，v0.4.0加入
${product.version} - 产品版本，可以在”系统设置”–“管理界面设置”中设置，v0.4.0加入

响应相关变量

${requestTime} - 请求花费时间
${bytesSent} - 发送的内容长度，包括Header（字节）
${bodyBytesSent} - 发送的内容长度，不包括Header（字节）
${status} - 状态码，比如200
${statusMessage} - 状态消息，比如200 OK
${response.contentType} - 响应的Content-Type值
${response.header.NAME} - 响应中的Header值

${origin.id} - 源站服务器ID
${origin.code} - 源站服务器代号
${origin.address} - 源站服务器地址，包含主机地址和端口
${origin.host} - 源站服务器地址，只包含主机地址
${origin.scheme} - 源站服务器协议

缓存相关变量

${cache.status} - 缓存状态，值可能为：
- BYPASS - 没有开启缓存策略或者其他原因未通过缓存策略处理的时候，状态为BYPASS
- HIT - 已命中缓存
- MISS - 未命中缓存
- PURGE - 正在清除缓存
- UPDATING - 正在更新缓存，v0.3.7加入
- EXPIRED - 已过期
- STALE - 正在使用过期的缓存
${cache.age} - 缓存对象的有效期，v0.3.7加入
${cache.policy.id} - 缓存策略ID
${cache.policy.name} - 缓存策略名称
${cache.policy.type} - 缓存策略类型（memory、file之类）
${cache.key} - 当前请求的缓存Key，v0.3.7加入

${node.id} - 节点ID
${node.name} - 节点名称
${node.role} - 节点角色

请求变量

内置变量

匹配变量

响应相关变量

缓存相关变量

环境相关变量