Cache Policy

速盾网络 Team

Cache policies define high-level caching strategies that can be applied across your domain. Policies combine multiple cache settings into reusable configurations, making it easier to manage caching behavior consistently.

Understanding Cache Policies

A cache policy is a named configuration that specifies:

What content to cache
How long to cache it
How to handle cache keys
Compression and optimization settings

code

Cache Policy "Static Assets"
├── TTL: 30 days
├── Browser TTL: 1 day
├── Cache Key: URL + Accept-Encoding
├── Compression: Brotli, Gzip
└── Serve Stale: Enabled

Default Policies

Sudun includes pre-configured policies for common use cases:

Standard Policy

Balanced caching for typical websites:

Setting	Value
Edge TTL	Respect origin headers
Browser TTL	Respect origin headers
Cache Key	URL + Query String
Compression	Auto
Serve Stale	On error only

Aggressive Policy

Maximum caching for static content:

Setting	Value
Edge TTL	30 days
Browser TTL	7 days
Cache Key	URL only
Compression	Always
Serve Stale	Always

Dynamic Policy

Minimal caching for dynamic content:

Setting	Value
Edge TTL	None
Browser TTL	None
Cache Key	N/A
Compression	On-the-fly
Serve Stale	Never

Creating Custom Policies

Dashboard Setup

Go to Domains → Select your domain
Navigate to Caching → Policies
Click Create Policy
Configure policy settings
Click Save

Policy Configuration

json

{
  "name": "my-static-policy",
  "description": "Policy for static assets",
  "settings": {
    "cache": {
      "edge_ttl": 2592000,
      "browser_ttl": 86400,
      "respect_origin": false
    },
    "cache_key": {
      "include_query_string": false,
      "include_headers": ["Accept-Encoding"]
    },
    "optimization": {
      "compression": "auto",
      "minify": false
    },
    "stale": {
      "serve_while_revalidate": true,
      "serve_on_error": true,
      "max_stale_age": 86400
    }
  }
}

Policy Settings

TTL Settings

Control cache duration:

Setting	Description	Range
edge_ttl	Time cached at edge	0 - 31536000 (1 year)
browser_ttl	Time cached in browser	0 - 31536000
respect_origin	Honor origin headers	true/false
min_ttl	Minimum cache time	0 - 86400
max_ttl	Maximum cache time	0 - 31536000

TTL Hierarchy:

code

If respect_origin = true:
  TTL = Origin Cache-Control (within min/max bounds)

If respect_origin = false:
  TTL = edge_ttl setting

Cache Key Settings

Define what makes cached content unique:

json

{
  "cache_key": {
    "include_query_string": true,
    "query_string_whitelist": ["page", "sort"],
    "query_string_blacklist": ["utm_*", "fbclid"],
    "include_headers": ["Accept-Encoding", "Accept-Language"],
    "include_cookies": [],
    "include_device_type": false,
    "include_geo": false
  }
}

Cache Key Options:

Option	Effect
include_query_string	Vary cache by query parameters
query_string_whitelist	Only these params affect cache
query_string_blacklist	Ignore these params
include_headers	Vary cache by request headers
include_cookies	Vary cache by cookies
include_device_type	Separate mobile/desktop cache
include_geo	Separate cache by country

Compression Settings

Configure content compression:

json

{
  "compression": {
    "mode": "auto",
    "algorithms": ["br", "gzip", "deflate"],
    "min_size": 1024,
    "types": ["text/*", "application/json", "application/javascript"]
  }
}

Compression Modes:

Mode	Behavior
auto	Compress based on content type and size
always	Always compress eligible content
never	Disable compression
origin	Use origin compression only

Stale Content Settings

Configure stale content behavior:

json

{
  "stale": {
    "serve_while_revalidate": true,
    "serve_on_error": true,
    "max_stale_age": 86400,
    "error_codes": [500, 502, 503, 504]
  }
}

Applying Policies

Apply to Path

Assign a policy to specific paths:

json

{
  "policy_assignments": [
    {
      "policy": "aggressive-static",
      "match": {
        "path": "/static/*"
      }
    },
    {
      "policy": "dynamic",
      "match": {
        "path": "/api/*"
      }
    }
  ]
}

Apply to File Types

Assign policy by file extension:

json

{
  "policy": "aggressive-static",
  "match": {
    "file_extensions": ["css", "js", "jpg", "png", "woff2"]
  }
}

Apply to Content Type

Assign policy by response content type:

json

{
  "policy": "standard",
  "match": {
    "content_type": ["text/html", "application/xhtml+xml"]
  }
}

Policy Inheritance

Policies can inherit from other policies:

json

{
  "name": "my-images-policy",
  "inherits": "aggressive-static",
  "overrides": {
    "cache": {
      "browser_ttl": 604800
    },
    "optimization": {
      "image_optimization": true
    }
  }
}

Inheritance Chain:

code

Base Policy: aggressive-static
└── my-images-policy (inherits + overrides browser_ttl)
    └── my-hero-images (inherits + overrides image quality)

Policy Versioning

Version Control

Track policy changes over time:

json

{
  "name": "static-assets",
  "version": 3,
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-15T10:30:00Z",
  "changelog": [
    {
      "version": 3,
      "date": "2024-01-15",
      "changes": "Increased browser TTL to 7 days"
    },
    {
      "version": 2,
      "date": "2024-01-10",
      "changes": "Added Brotli compression"
    }
  ]
}

Rollback

Revert to a previous policy version:

Go to Policies → Select policy
Click Version History
Select the version to restore
Click Rollback

Policy Testing

Preview Mode

Test policy changes before deployment:

json

{
  "preview": true,
  "test_urls": [
    "https://example.com/test-page",
    "https://example.com/static/test.css"
  ]
}

A/B Testing

Test policy effectiveness:

json

{
  "ab_test": {
    "enabled": true,
    "variants": [
      {
        "name": "control",
        "policy": "current-policy",
        "weight": 50
      },
      {
        "name": "experiment",
        "policy": "new-policy",
        "weight": 50
      }
    ],
    "metrics": ["cache_hit_ratio", "origin_requests", "ttfb"]
  }
}

Common Policy Patterns

E-commerce Product Pages

json

{
  "name": "product-pages",
  "settings": {
    "cache": {
      "edge_ttl": 3600,
      "browser_ttl": 300
    },
    "cache_key": {
      "include_query_string": true,
      "query_string_whitelist": ["variant", "color", "size"]
    },
    "stale": {
      "serve_while_revalidate": true,
      "max_stale_age": 3600
    }
  }
}

News/Blog Articles

json

{
  "name": "blog-content",
  "settings": {
    "cache": {
      "edge_ttl": 600,
      "browser_ttl": 60
    },
    "stale": {
      "serve_while_revalidate": true,
      "serve_on_error": true
    }
  }
}

API Responses

json

{
  "name": "api-cacheable",
  "settings": {
    "cache": {
      "edge_ttl": 60,
      "browser_ttl": 0,
      "respect_origin": true
    },
    "cache_key": {
      "include_query_string": true,
      "include_headers": ["Authorization"]
    }
  }
}

Versioned Assets

json

{
  "name": "immutable-assets",
  "settings": {
    "cache": {
      "edge_ttl": 31536000,
      "browser_ttl": 31536000,
      "immutable": true
    },
    "cache_key": {
      "include_query_string": false
    }
  }
}

Policy Analytics

View policy performance metrics:

Metric	Description
Cache Hit Ratio	% of requests served from cache
Origin Offload	% reduction in origin requests
Bandwidth Saved	Data served from cache
Avg TTL	Average time content stays cached

Dashboard Metrics

Go to Analytics → Cache Performance
Filter by policy name
View metrics over time

Troubleshooting

Policy Not Applying

Check policy assignment rules
Verify path/extension matching
Check policy priority order
Review origin response headers

Unexpected Cache Behavior

Check if origin headers override policy
Verify cache key configuration
Test with curl to see response headers
Check for conflicting rules

Low Cache Hit Ratio

Review cache key settings (too specific?)
Check TTL values (too short?)
Analyze query string variations
Consider device/geo splitting impact

API Reference

Create Policy

bash

curl -X POST https://api.Sudun.com/v1/domains/example.com/policies \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-policy",
    "settings": {
      "cache": {"edge_ttl": 86400},
      "compression": {"mode": "auto"}
    }
  }'

Update Policy

bash

curl -X PUT https://api.Sudun.com/v1/domains/example.com/policies/my-policy \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "settings": {
      "cache": {"edge_ttl": 172800}
    }
  }'

List Policies

bash

curl -X GET https://api.Sudun.com/v1/domains/example.com/policies \
  -H "Authorization: Bearer YOUR_API_KEY"

Need help with cache policies? Contact support@Sudun.com

Cache Policy

Understanding Cache Policies

Default Policies

Standard Policy

Aggressive Policy

Dynamic Policy

Creating Custom Policies

Dashboard Setup

Policy Configuration

Policy Settings

TTL Settings

Cache Key Settings

Compression Settings

Stale Content Settings

Applying Policies

Apply to Path

Apply to File Types

Apply to Content Type

Policy Inheritance

Policy Versioning

Version Control

Rollback

Policy Testing

Preview Mode

A/B Testing

Common Policy Patterns

E-commerce Product Pages

News/Blog Articles

API Responses

Versioned Assets

Policy Analytics

Dashboard Metrics

Troubleshooting

Policy Not Applying

Unexpected Cache Behavior

Low Cache Hit Ratio

API Reference

Create Policy

Update Policy

List Policies

Tags

Understanding Cache Policies

Default Policies

Standard Policy

Aggressive Policy

Dynamic Policy

Creating Custom Policies

Dashboard Setup

Policy Configuration

Policy Settings

TTL Settings

Cache Key Settings

Compression Settings

Stale Content Settings

Applying Policies

Apply to Path

Apply to File Types

Apply to Content Type

Policy Inheritance

Policy Versioning

Version Control

Rollback

Policy Testing

Preview Mode

A/B Testing

Common Policy Patterns

E-commerce Product Pages

News/Blog Articles

API Responses

Versioned Assets

Policy Analytics

Dashboard Metrics

Troubleshooting

Policy Not Applying

Unexpected Cache Behavior

Low Cache Hit Ratio

API Reference

Create Policy

Update Policy

List Policies