源站与缓存

概念复制链接

配置源站复制链接

1. 打开 网站，选择网站，进入「源站」页签。

2. 在「源站」卡片中修改已有源站，或点击「添加源站」。

3. 填写「源站地址」「端口」「回源协议」「权重」；按需填写「回源 Host」「SNI」「源站组」，按需打开「备用」「S3 签名」。

4. 点击卡片底部的「保存」。控制台提示「已保存，版本 #N」。

5. 验证：节点应用该版本后，经节点访问网站：

   复制

   curl -sI -H 'Host: www.example.com' http://<节点 IP>/

   返回源站的状态码；有流量后，源站旁显示「正常」。

源站字段复制链接

每个网站 1–32 个源站，至少一个在默认组。

源站池设置复制链接

「源站池设置」卡片单独保存，其中还有主动健康检查与会话保持。

配置阶段的规则可按请求覆盖三项超时与「WebSocket」，见覆盖设置。

负载均衡与重试复制链接

被动健康检查复制链接

不发送探测请求；健康状态只由真实流量判断。打开主动健康检查后两者合并，见合并规则。

错误码需要节点 proto v0.2.1 及以上；其他错误和更早的节点显示节点上报的原文。

主动健康检查复制链接

1. 在「源站」页签的「源站池设置」卡片中，打开「主动健康检查」的「启用」。
2. 填写「路径」，选择「方法」，按需修改其他字段。
3. 点击卡片底部的「保存」。
4. 验证：令一个源站的检查路径返回期望范围以外的状态码；约「间隔 × 不健康阈值」秒后，该源站显示「{down}/{total} 个节点不可用」，节点结果标为「主动」，请求不再发往它。

合并规则复制链接

全部源站都不可用时仍按主源、备用源的顺序尝试（失败开放）。

会话保持复制链接

1. 在「源站池设置」卡片中打开「会话保持」的「启用」，按需修改「Cookie 有效期（秒）」。
2. 点击「保存」。
3. 验证：第一次回源的响应带 Set-Cookie: __ew_affinity=…；带着这个 Cookie 的后续请求都发往同一个源站。

回源 TLS复制链接

WebSocket复制链接

WebSocket 升级请求（Upgrade: websocket）默认透传，不经过缓存。关闭「WebSocket」后，升级请求返回 403，响应头 X-Edgeweir-Error: websocket-disabled。

升级后的连接空闲 3600 秒后关闭，网站的「发送」「读取」超时不作用于它；只有配置阶段规则的「回源发送超时」「回源读取超时」能改变它，见覆盖设置。

HTTP/2 与 gRPC复制链接

1. 在「源站」页签的「源站池设置」卡片中，把「回源 HTTP 版本」改为「HTTP/2」；需要转发 gRPC 时再打开「gRPC」。

2. 点击卡片底部的「保存」。

3. 验证：节点应用该版本后，源站访问日志里的请求为 HTTP/2。gRPC 网站可经节点调用，例如：

   复制

   grpcurl -authority grpc.example.com <节点 IP>:443 list

打开「gRPC」后，Content-Type 为 application/grpc 的请求（含 +proto、+json 等后缀或参数）经 HTTP/2 端到端转发：

源站组复制链接

源站的「源站组」把网站的源站分成几组，留空为默认组。没有命中「源站覆盖」规则的请求只发往默认组。

1. 在「源站」卡片中为源站填写「源站组」，例如 api，点击「保存」。至少保留一个源站在默认组，否则卡片显示「至少保留一个默认组源站」，不能保存。
2. 在「规则」页签的「回源」阶段点击「添加规则」，填写表达式，例如 starts_with(http.request.uri.path, "/api/")；「动作」选择「源站覆盖」，「源站组」选择 api，按需填写「回源 Host」「SNI」「端口」，打开「启用」（新规则默认停用），点击「保存」。字段见动作字段。
3. 验证：请求 /api/ 下的路径，源站日志显示请求到达 api 组的源站；其他路径仍到达默认组。

请求体上限复制链接

网站「源站」页签的「请求体上限」卡片单独保存。

源站地址限制复制链接

源站不能指向特殊用途地址。

S3 兼容对象存储复制链接

在源站上打开「S3 签名」后填写以下字段。「预设」按服务商填入源站地址模板与区域示例，把地址中 <region> 这类尖括号部分换成自己的值；预设只填表单，不保存。

除 MinIO 外，选择预设时协议改为 HTTPS、端口改为 443。只列出官方文档写明支持 S3 兼容 AWS Signature V4 的服务；华为云 OBS 的文档只描述其自有签名，不在列表中，仍可按「自定义」填写。

配置缓存规则复制链接

1. 打开 网站，选择网站，进入「缓存」页签。

2. 在「缓存规则」卡片中点击「添加规则」。

3. 在「构建器」中填写「路径前缀」「后缀」；或切换到「高级」，在「表达式」中填写条件，见请求条件。

4. 选择「动作」，填写「缓存时间（秒）」，按需填写「浏览器 TTL（秒）」；只对静态资源关闭「遵循源站」。

5. 需要更多条件时点击「更多条件」，填写「精确路径」（仅构建器）「状态码」「最小（KB）」「最大（KB）」「过期后后台更新（秒）」「回源出错时用旧缓存（秒）」，或打开「缓存带 Authorization 头的请求」。

6. 拖动规则左侧的手柄调整顺序。

7. 点击「保存」。

8. 验证：同一 URL 请求两次，第二次命中缓存：

   复制

   curl -sI -H 'Host: www.example.com' http://<节点 IP>/static/app.js | grep -i x-cache

   第二次输出 X-Cache: HIT。

规则字段复制链接

每个网站最多 64 条规则。没有规则时卡片显示「不缓存」，网站不缓存任何响应。

匹配复制链接

请求条件复制链接

请求条件是一条 cache 阶段的表达式，字段、函数与 IP 名单引用同规则表达式，不能使用响应字段、regex_replace 与 wildcard_replace。true 匹配所有请求。

浏览器 TTL复制链接

「浏览器 TTL（秒）」大于 0 时，由该规则缓存的响应对访问者返回 Cache-Control: max-age=N。

缓存时间复制链接

Authorization复制链接

带 Authorization 的请求默认绕过缓存，响应也不存入缓存（RFC 9111 §3.5），源站返回 public 或规则覆盖源站缓存头时同样如此。规则打开「缓存带 Authorization 头的请求」后按该规则缓存，此时持有任意凭据的访问者共用同一份缓存，只适合与凭据无关的内容。

Set-Cookie复制链接

规则打开「缓存带 Set-Cookie 的响应」后，带 Set-Cookie 的响应按该规则缓存。

过期内容复制链接

两者在缓存时间为 0 时不生效。访问者收到的 Cache-Control 是源站原来的值，源站没有发送时不添加；设置了浏览器 TTL 时除外。

缓存键与分片复制链接

「缓存键与分片」卡片单独保存，对网站的全部规则生效。

PURGE 方法复制链接

「缓存」页签的「PURGE 方法」卡片：打开「启用」，在「PURGE 密钥」填写 16–256 个可打印字符（不含空格），或点击「生成」得到 32 字节随机密钥（只在此处显示，保存前复制），然后保存。之后：

curl -X PURGE -H 'X-Purge-Key: <密钥>' -H 'Host: www.example.com' 'http://<节点 IP>/static/app.js?v=2'

返回 202 {"task_id":"…"}：控制台为该 URL 创建一个 URL 刷新任务，下发给网站所在集群的每个节点，刷新预热 中来源显示为节点。

X-Cache复制链接

「X-Cache」卡片中关闭「向访客发送 X-Cache」后，网站的响应不带 X-Cache（缓存命中也是）；缓存行为不变。需要 site-content-v1。

字符编码复制链接

「字符编码」卡片为文本响应补上 Content-Type 的 charset 参数，只改响应头，不转换正文。

只作用于源站返回（含缓存命中）的 text/*、application/javascript、application/json、application/xml 响应；节点自己生成的响应（错误页、人机验证页、PURGE 应答）不变。需要 site-content-v1。

缓存区复制链接

集群 页面「概览」中的「缓存区」卡片设置集群每个节点的缓存区；节点详情的「缓存」可单独覆盖本节点的容量。

刷新与预热复制链接

1. 打开 刷新预热。
2. 选择「URL 刷新」「目录刷新」「Host 刷新」「标签刷新」「全站刷新」「URL 预热」或「站点地图预热」。
3. URL 类任务：每行填写一个 URL；Host 刷新：每行一个 Host；标签刷新：选择网站，每行（或用逗号分隔）一个标签；全站刷新：勾选网站；站点地图预热：填写「站点地图 URL」与「最多 URL 数」。预热类任务按需勾选「设备」中的「桌面端」「移动端」。
4. 点击「提交」。
5. 验证：任务出现在「任务」列表，展开后各节点状态为「成功」；刷新后下一次请求返回 X-Cache: MISS。

任务下发到网站所在集群的每个已启用节点，逐节点显示结果。已停用的网站不能刷新或预热（「网站已停用」）。/purge?site=<网站 ID> 只列出该网站的任务（「任务」旁显示网站名，点击 × 清除），并在全站刷新与标签刷新中预选该网站；/purge?type=<类型>&urls=<URL> 打开该类型并填好 URL（多个 URL 用 JSON 数组，如 urls=["https://www.example.com/a","https://www.example.com/b"]）。内容为空或只有空白行时「提交」不可用。⌘K / Ctrl+K 的「刷新 URL…」打开本页（在网站页面时只列出该网站的任务）。

访问日志、网站「统计」页签的热门 URL 与「安全」页签的 Top 路径，在行右侧的「⋯」中提供「刷新 URL」：路径展开到网站的每个非泛域名，确认列出的 URL 后创建 URL 刷新任务，提示中的「查看任务」打开该网站的任务。

在网站内刷新复制链接

网站「缓存」页签顶部的「刷新缓存」卡片：

1. 选择「URL 刷新」「目录刷新」或「全站刷新」。
2. URL 与目录刷新：每行填写一个以 / 开头的路径或完整 URL。路径展开到网站的每个非泛域名（例如 /app.js 对 www.example.com 与 example.com 各一条），右上角显示展开后的 URL 数；超过 500 条或有既不是路径也不是 URL 的行时在下方提示，「提交」不可用。网站只有泛域名时填写完整 URL。全站刷新显示将要刷新的域名。
3. 点击「提交」。

卡片下方列出该网站最近 5 个任务，节点执行期间每 2 秒刷新；「查看任务」打开 /purge?site=<网站 ID>。

任务类型复制链接

URL 必须以 http:// 或 https:// 开头，不能包含账号，Host 必须是某个网站的域名（含泛域名下的子域名），不能是 *.example.com 这样的模式。https:// URL 在节点有 HTTPS 监听时经本地 TLS 监听预热（不校验本机证书）；没有 HTTPS 监听时失败（「节点还没有 HTTPS 监听」）。节点另有刷新专用的拉取通道：刷新不等前面已经开始的预热或升级。

Cache-Tag复制链接

源站在响应头 Cache-Tag 中用逗号分隔列出标签，例如 Cache-Tag: product-42, category-7。

站点地图复制链接

清除网站缓存复制链接

在网站「概览」页签点击「清除缓存」并确认（或按 ⌘K / Ctrl+K 搜索网站，选择「清除缓存：（网站）」），与 刷新预热 的「全站刷新」相同：控制台创建一个全站刷新任务，下发到网站所在集群的每个已启用节点，不发布配置版本。提示中的「查看任务」打开 /purge?site=<网站 ID>，只列出该网站的任务，表单中预选该网站。已停用的网站不能清除缓存。

任务限制复制链接

节点状态复制链接

限制复制链接

故障排查复制链接

节点自身返回的错误带响应头 X-Edgeweir-Error 和 Cache-Control: no-store。X-Cache 为 nginx 缓存状态：MISS、HIT、BYPASS、EXPIRED、STALE、UPDATING、REVALIDATED。