附录
更新时间:2026-06-05
相关对象定义
CacheTtl
| 参数 | 类型 | 可选 | 说明 |
|---|---|---|---|
| type | String | 必选 | 其合法值为“path”。表示缓存目录的路径。 |
| value | String | 必选 | 其合法值为“/”。表示根目录。 |
| ttl | Int | 必选 | 缓存时间,单位为秒。值为0时,表示不缓存。 |
| weight | Int | 必选 | 权重,其合法值为100。 |
| override_origin | Bool | 必选 | 表示缓存是否遵循源站。值为“true”时,表示不遵循源站,按照该条配置规则缓存。值为“false”时,表示遵循源站。 |
CacheKey
| 参数 | 类型 | 可选 | 说明 |
|---|---|---|---|
| query | Bool | 必选 | 其合法值为 true 和 false。true 表示保留参数缓存,false 表示忽略参数缓存。 |
| exclude_args | List<String> | 可选 | 忽略哪些参数缓存,只有 query = false 时才有效。 |
| include_args | List<String> | 可选 | 包含哪些参数缓存,只有 query = false 时才有效。 |
注:exclude_args 与 include_args 不可同时设置。
HSTS
| 参数 | 类型 | 可选 | 说明 |
|---|---|---|---|
| maxAge | Int | 必选 | 配置保存时间,单位为天, 用户输入值为 0 ~ 730 或者 -1,为 -1 时表示关闭该配置项。 |
| includeSubDomains | Bool | 必选 | 是否包含子域名。 |
| preload | Bool | 必选 | 是否支持预加载。 |
HTTP3
| 参数 | 类型 | 可选 | 说明 |
|---|---|---|---|
| enable | bool | 必选 | 开启为 true,关闭为 false。 |
HttpHeader
| 参数 | 类型 | 可选 | 说明 |
|---|---|---|---|
| type | String | 必选 | "origin" 表示回源生效,"response" 表示给用户响应时生效。 |
| header | String | 必选 | header 为 http 头字段,一般为 HTTP 的标准 Header,其长度限制为 128。也可以是用户自定义的 Header。 |
| value | String | 必选 | 指定 header 的值,其长度限制为 1000。可以是常量,也可以是变量。删除 HTTP 头时,可以传空字符串""。 字符 $ 开始的子串一定要符合 ${x} 的模式,其合法变量值为: • ${uri} 表示客户端请求的 URL 路径部分(不包含查询参数)。 • ${host} 表示客户端请求 host 头部值。 • ${scheme} 表示客户端请求协议(http 或 https)。 • ${request_uri} 表示客户端请求路径和参数(包含查询参数)。 • ${jvip} 表示节点 IP。 • ${remote_addr} 表示客户端 IP,存在代理的情况下不准确。 • ${request_id} 表示请求的唯一标识符。 典型非法值: • 变量不符合限制要求,如 "X-REQ-${url}"; • 包含 "$" 字符但不符合 "${x}" 模式,如:"X-REQ-$uri" 。 注意:value 不支持 "$" 纯字符的传递,如果您希望响应客户端一个包含 "$" 符号的响应头将不被允许,如 "X-$" 是非法的。 |
| action | String | 必选 | 设置 HTTP 头合法值为 "add",删除 HTTP 头合法值为 "remove"。 |
注:最多设置 20 条 HTTP 回源请求头规则,最多设置 20 条 HTTP 节点响应头规则。不支持删除 "ohc","baidu" 开头的回源请求头。
CacheTtlCode
| 参数 | 类型 | 可选 | 说明 |
|---|---|---|---|
| type | String | 必选 | 合法值为"code",表示异常状态码缓存。 |
| value | String | 必选 | 状态码的合法值为: • 4xx:400、401、403、404、405、407、414、451 • 5xx:500、501、502、503、504、509、514 |
| ttl | Int | 必选 | 缓存时间,单位为秒。取值范围:0-315360000。 |
| overrideOrigin | Bool | 必选 | 缓存是否遵循源站,其合法值为“true”。 |
| weight | Int | 必选 | 权重,其合法值为 100 。 |
注:最多支持设置 15 条状态码缓存规则,且规则不可重复设置。
评价此篇文章
