CDN on Zerops

Zerops CDN has 6 global regions with a fixed 30-day cache TTL (HTTP Cache-Control headers are ignored by CDN but still affect browsers). Built on Nginx + Cloudflare geo-steering.

Regions

1. EU (Prague, CZ) — Primary + all-region failover
2. EU (Falkenstein, DE) — Secondary European
3. UK (London)
4. AU (Sydney)
5. SG (Singapore)
6. CA (Beauharnois, Canada)

DNS TTL: 30 seconds. Geo-steering routes to nearest node. EU Prague is fallback if all others down.

CDN Modes

Object Storage CDN

• URL: https://storage.cdn.zerops.app/bucket/path
• Env var: ${storageCdnUrl}
• Direct from Object Storage through CDN

Static CDN

• URL: https://static.cdn.zerops.app/domain.com/path
• Env var: ${staticCdnUrl}
• For custom domains on static/nginx services
• Wildcard domains NOT supported

API CDN

• Coming soon
• Env var: ${apiCdnUrl}

Cache Behavior

• TTL: Fixed 30 days (not configurable)
• HTTP Cache-Control headers: Affect browser caching, NOT CDN caching
• Eviction: LRU when storage capacity reached
• First request: Fetched from origin and cached

Purge Patterns

/*            # All content
/dir/*        # Directory contents
/file$        # Specific file (exact match)
/prefix*      # Pattern prefix match

Wildcard must be at end. Use $ suffix for exact file match.

Purge via zsc

Signature: zsc cdn purge <domain> [path] — the domain is required first; the path/pattern is the optional second arg (defaults to *). Works for Static-Mode CDN only — Object-Storage CDN content is purged via the REST API, not zsc. Run from a container whose CDN domain is active.

zsc cdn purge example.com               # Purge all cached content for the domain
zsc cdn purge example.com "/images/*"   # Purge a directory
zsc cdn purge example.com "/style.css$" # Purge exact file

Gotchas

1. CDN URLs are project-scoped env vars: ${storageCdnUrl}, ${staticCdnUrl}, ${apiCdnUrl} are referenced directly with no hostname prefix (unlike service vars like ${storage_apiUrl})