缓存规则

请求 → 边缘服务器 → 缓存检查
                            │
                    ┌───────┴───────┐
                    │               │
               缓存命中        缓存未命中
                    │               │
              返回缓存内容     从源站获取
                              缓存响应
                              返回给用户

# 精确匹配
/images/logo.png

# 前缀匹配
/static/*

# 通配符匹配
/api/*/public

# 正则匹配 (高级)
^/blog/[0-9]{4}/.*$

{
  "match": {
    "file_extension": ["jpg", "jpeg", "png", "gif", "webp", "css", "js"]
  },
  "action": "cache",
  "ttl": 86400
}

{
  "match": {
    "path": "/search",
    "query_string": {
      "contains": "category"
    }
  }
}

{
  "match": {
    "headers": {
      "Accept": "application/json"
    }
  },
  "action": "bypass"
}

{
  "match": { "path": "/static/*" },
  "action": "cache",
  "ttl": 604800,
  "settings": {
    "browser_ttl": 86400,
    "serve_stale": true
  }
}

{
  "match": { "path": "/api/*" },
  "action": "bypass"
}

{
  "match": { "path": "/assets/*" },
  "action": "override",
  "ttl": 2592000,
  "ignore_origin_headers": true
}

{
  "edge_ttl": 86400,
  "browser_ttl": 3600
}

https://example.com/page?sort=date&page=1
         │            │        │
      协议方案      路径     查询字符串

{
  "cache_key": {
    "query_string": {
      "include": ["category", "page"]
    }
  }
}

{
  "cache_key": {
    "headers": ["Accept-Language", "Accept-Encoding"]
  }
}

{
  "cache_key": {
    "cookies": ["session_type", "user_tier"]
  }
}

{
  "serve_stale": {
    "while_revalidate": true,
    "on_error": true,
    "max_stale_age": 86400
  }
}

源站错误 (5xx) → 提供陈旧内容 → 记录错误

{
  "match": { "path": "/static/*" },
  "action": "cache",
  "ttl": 86400,
  "respect_origin_headers": false
}

规则 1: /api/* → 绕过 (优先级: 1)
规则 2: /api/public/* → 缓存 (优先级: 2)
规则 3: /* → 缓存 (优先级: 3)

请求: /api/users → 匹配规则 1 → 绕过
请求: /api/public/data → 匹配规则 1 → 绕过 (而非规则 2!)

{
  "name": "静态资源",
  "match": {
    "file_extension": ["css", "js", "jpg", "png", "gif", "ico", "woff2"]
  },
  "action": "cache",
  "ttl": 2592000,
  "browser_ttl": 86400
}

{
  "name": "API 绕过",
  "match": { "path": "/api/*" },
  "action": "bypass"
}

{
  "name": "HTML 页面",
  "match": {
    "file_extension": ["html"],
    "path": "/*"
  },
  "action": "cache",
  "ttl": 300,
  "serve_stale": true
}

{
  "name": "版本化资源",
  "match": {
    "path": "/assets/v*/*"
  },
  "action": "cache",
  "ttl": 31536000,
  "immutable": true
}

# 检查缓存状态
curl -I https://example.com/static/style.css

# 响应头部
X-Cache-Status: HIT
Cache-Control: max-age=86400
Age: 3600

# 列出缓存规则
curl -X GET https://api.Sudun.com/v1/domains/example.com/cache-rules \
  -H "Authorization: Bearer YOUR_API_KEY"

# 创建缓存规则
curl -X POST https://api.sudun/v1/domains/example.com/cache-rules \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Static Assets",
    "match": {"file_extension": ["css", "js", "png"]},
    "action": "cache",
    "ttl": 86400
  }'