Hız belgeleri

Kuruluma başla

Fora CDN istemcisi Node.js 18+ ile çalışır. Önce paketi projene ekle, ardından sana en yakın bölgeyi seçerek projeni başlat. Aşağıdaki tr-istanbul bölgesi Türkiye trafiği için en düşük Latency sunar.

1. Paketi kur

# Fora CDN istemcisini projene ekle
$ npm install @foracdn/client

2. Projeyi başlat

Kurulumdan sonra init komutu seçtiğin bölgede bir zone oluşturur ve proje köküne bir foracdn.config.json dosyası yazar.

# İstanbul bölgesinde yeni bir zone başlat
$ foracdn init --zone tr-istanbul

# ✔ Zone oluşturuldu: tr-istanbul
# ✔ Yapılandırma yazıldı: foracdn.config.json

DNS'i yönlendir

Trafiği Fora CDN üzerinden geçirmek için alan adının DNS kaydını bizim PoP ağımıza yönlendiren bir CNAME kaydı eklemen gerekir. DNS sağlayıcının kontrol panelinde aşağıdaki kaydı oluştur.

Not: Kök alan adları (örneğin example.com) için sağlayıcın CNAME flattening / ANAME desteklemiyorsa, alt alan adı (www) kullanmanı öneririz.

CNAME kaydı örneği

; Tip Ad Hedef TTL
www     IN  CNAME   tr-istanbul.pop.foracdn.net. 3600
@       IN  ALIAS   tr-istanbul.pop.foracdn.net. 3600

Kayıt yayıldıktan sonra (genelde birkaç dakika) doğrulama otomatik tamamlanır ve SSL sertifikan Let's Encrypt ile ücretsiz olarak sağlanır.

Cache'i ayarla

Cache kuralları, hangi içeriğin ne kadar süreyle PoP noktasında tutulacağını belirler. Kuralları foracdn.config.json içinde tanımlayabilir ya da panel üzerinden yönetebilirsin. Yapay zekâ destekli akıllı cache, %94'e varan isabet oranıyla kuralları otomatik optimize eder.

Yapılandırma örneği

{
  "zone": "tr-istanbul",
  "cache": {
    "rules": [
      {
        // Statik varlıkları 30 gün Cache
        "match": "*.{ js,css,png,jpg,svg,woff2 }",
        "ttl": "30d",
        "staleWhileRevalidate": true
      },
      {
        // API yanıtlarını önbelleğe alma
        "match": "/api/*",
        "ttl": "0",
        "bypass": true
      }
    ]
  }
}

API referansı

Fora CDN REST API'si zone'larını, cache'ini ve analitiğini programatik olarak yönetmeni sağlar. Tüm istekler https://api.foracdn.net/v1 kök adresine yapılır ve Authorization: Bearer <API_KEY> başlığı gerektirir.

Uç noktalar

Örnek istek

Aşağıdaki örnek, bir zone'un tüm cache'ini temizler:

# tr-istanbul zone'unun cache'ini tamamen temizle
$ curl -X POST "https://api.foracdn.net/v1/zones/tr-istanbul/purge" \
    -H "Authorization: Bearer $FORACDN_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "everything": true }'

# { "status": "ok", "purged": 18432, "region": "tr-istanbul" }