Cloudflare Worker Kanalını Bağla
Hazırlayan Ersin DorlakSon güncelleme:
Bu Sayfa Ne Yapar
Cloudflare Worker kanalı, sitesi Cloudflare proxy'si arkasında yayınlanan projelerde SEO düzeltmelerini sayfa Cloudflare kenarından geçerken HTML'e yazar; kaynak koda, sunucuya ya da yönetim paneline dokunmadan Google'ın ilk gördüğü HTML değişir. Pixel düzeltmeyi ziyaretçinin tarayıcısında uygular, eklenti kurulamayan özel yazılımlarda ise sunucu tarafına erişim çoğu zaman yoktur; Worker bu iki durumun arasındaki boşluğu kapatır.
Kurulum ekranı SEO Onarım sayfasının Kanal & Kurulum görünümünde Cloudflare Worker kartından açılır ve üç bloktan oluşur. Durum bloğu kanalın hâlini (Kurulmadı, Kurulum bekliyor: Worker henüz düzeltme listesini çekmedi., Çalışıyor) ve kurulumdan sonra Bağlantıyı test et ile Worker'ı kaldır (geri al) düğmelerini gösterir. Otomatik kurulum (önerilen) bloğu Cloudflare API token, Account ID, Zone ID ve route desenini ister; Elle kurulum bloğu ise Worker kodunu ve üç değişkeni kopyalamanız için açar. En altta kanalın sınırları yazar.
Otomatik kurulumda panel önce token'ı Cloudflare'de doğrular, sonra hesabınıza otopilot-edge- ile başlayan, alan adınızdan türetilmiş bir Worker betiği yükler ve route desenine bağlar; aynı desende route varsa onu günceller. Worker sitenize gelen ilk istekte HMAC-SHA256 ile imzalı düzeltme listesini çeker, listeyi 5 dakika önbellekte tutar ve sayfa kurallarını HTMLRewriter ile uygular. robots.txt, sitemap.xml, llms.txt ve IndexNow anahtar dosyası ile 301/302/307/308 yönlendirmeler de kenardan sunulur. /wp-admin, /wp-login.php, /api/ ve /admin/ ile başlayan yollara dokunulmaz; panele ulaşılamazsa sayfa değiştirilmeden geçer.
Kanal, özel kodlu ya da kapalı altyapılı sitesini Cloudflare'de barındıran işletmeler ve bu siteleri yöneten ajanslar içindir. Düzeltmeler sunucu tarafında yazıldığı için panel canlı sayfayı yeniden çekip doğrulayabilir; her yayın Site kodu görevleri ekranının Yayın betikleri sekmesinde bir sürüm olarak listelenir ve tek düğmeyle geri alınabilir.
Sık yanlış anlamalardan biri, alan adının Cloudflare'de kayıtlı olmasının yeterli olduğudur: DNS kaydı turuncu bulutla (proxy) çalışmıyorsa istekler Worker'a hiç uğramaz. Bir diğeri, Worker'ın her işi yapabileceğidir; görsel optimizasyonu, yeni sayfa oluşturma, adres (slug) değişikliği ve blog yayını bu kanalla yapılmaz, görünür metin düzeltmeleri ise yalnız onayınızla yayına çıkar.
Anlatılan sayfayı panelde aç(giriş yapınca açılır)
Ön Koşullar
- Planınızda otomatik SEO düzeltme hakkı olmalıdır; hak yoksa Cloudflare Worker kartı kilitli görünür ve kurulum görünümü açılmaz.
- Sitenin alan adı Cloudflare'de olmalı ve DNS kaydı proxy (turuncu bulut) modunda çalışmalıdır. Panel sitenizin yanıt başlıklarında Cloudflare izi bulamazsa kart Bu sitenin altyapısıyla uyumsuz grubunda görünebilir.
- Cloudflare hesabında API token oluşturabilmeli, alan adının Overview sayfasındaki Account ID ve Zone ID değerlerine erişebilmelisiniz.
- Token girme, kurulum, test ve kaldırma yalnız proje sahibine açıktır; takım arkadaşları alanları devre dışı görür.
Adım Adım Kullanım
- Sol menüden SEO Hata Düzenleyici → SEO Onarım sayfasını açıp Kanal & Kurulum görünümüne geçin; listede Geliştirici süzgeciyle Cloudflare Worker kartını bulun. Kanallar → Web sitem → Önerilen kanal ekranındaki Worker önerisinden gelirseniz kurulum adımı doğrudan açılır.
- Kartta Yönet düğmesine basın. SEO Onarım bu projede ilk kez açılıyorsa Otomatik SEO Hata Düzeltme Kurulumu penceresinde Kanalı seç adımında Cloudflare Worker'ı, Otomasyon modunu seç adımında modu seçip İleri — Kuruluma git ile ilerleyin. Başka bir kanal aktifse Teslim kanalını değiştir? penceresi çıkar; mevcut kanal, Worker ilk çekimi yapana kadar çalışmayı sürdürür.
- Cloudflare'de My Profile → API Tokens → Create Token → Custom token yolunu izleyin. İzin olarak Account · Workers Scripts · Edit ve Zone · Workers Routes · Edit verin, Zone Resources bölümünde yalnız bu alan adını seçin. Daha geniş yetki gerekmez; dar token sızsa bile yalnız bu alan adının Worker'larını etkiler.
- Alan adının Cloudflare'deki Overview sayfasının sağ altından Account ID ve Zone ID değerlerini kopyalayın. İkisi de 32 karakterlik değerdir; boşluk ya da eksik karakter olursa kurulum "Token, Account ID (32 karakter), Zone ID (32 karakter) ve route desenini kontrol edin." uyarısıyla durur.
- Otomatik kurulum (önerilen) bloğunda Cloudflare API token, Account ID ve Zone ID alanlarını doldurun. Route deseni alanını boş bırakırsanız projenin adresinden türetilen örnek.com/* kullanılır; www ve çıplak alan adı ayrı yayınlanıyorsa ikinci deseni Cloudflare'de ayrıca route olarak ekleyin.
- Worker'ı kur düğmesine basın; düğme işlem boyunca Kuruluyor… yazar. Başarılı olunca "Worker kuruldu: … İlk istekte düzeltme listesini çekecek." bildirimi çıkar, token alanı temizlenir ve Durum satırı Kurulum bekliyor: Worker henüz düzeltme listesini çekmedi. olur.
- Cloudflare hesabınıza token vermek istemiyorsanız Elle kurulum bloğunda Worker kodunu ve değişkenleri göster düğmesine basın. Cloudflare'de Workers & Pages → Create → Worker ile yeni Worker açın, Worker kodu alanındaki kodu yapıştırın, Settings → Variables bölümüne OTOPILOT_PANEL_URL, OTOPILOT_PROJECT_ID ve Secret türünde OTOPILOT_EDGE_SECRET değişkenlerini ekleyip alan adına route bağlayın.
- Sitenin herhangi bir sayfasını tarayıcıda açın; bu ilk istek Worker'ın düzeltme listesini çekmesini sağlar. Panel listeyi verdiğinde kanal aktif olur ve Durum satırı Çalışıyor olarak görünür; kart da Aktif · Çalışıyor etiketini alır.
- Bağlantıyı test et düğmesine basın. Panel sitenizin başlangıç adresini çeker ve yanıtta Worker izini arar; "Worker sitede çalışıyor (4 kural uygulandı)." ya da "Worker sitede çalışıyor." mesajı kurulumun tamam olduğunu, hata mesajları ise sorunun nerede olduğunu gösterir.
- Düzeltmeler sekmesinde bekleyen bir düzeltmeyi onaylayın. Worker en geç 5 dakikalık önbellek süresi dolunca yeni listeyi çeker; düzeltme uygulanmış sayılır ve panel canlı sayfayı yeniden okuyarak doğrulamaya başlar.
- Yayınları izlemek için Kanallar → Takılanlar ve site kodu altındaki Site kodu görevleri ekranında Yayın betikleri sekmesini açın. Worker'ın çektiği düzeltme kümesi her değiştiğinde yeni bir Sürüm satırı oluşur; sorunlu bir sürümde Bu sürümü geri al düğmesini kullanın.
- Kanalı bırakmak isterseniz Durum bloğunda Worker'ı kaldır (geri al) düğmesine basıp onaylayın. Otomatik kurulumda panel route'u ve betiği Cloudflare'den siler, site düzeltmesiz özgün hâline döner; elle kurduysanız route'u Cloudflare'de siz silin.
Ekrandaki öğeler
- Cloudflare Worker (edge) kanalı başlığı — altında kanalın nasıl çalıştığını ve güvenlik notunu (imzalı liste, 5 dakika önbellek, dar yetkili token) anlatan iki satır bulunur.
- Durum bloğu — Kurulmadı (bağlantı yok), Kurulum bekliyor: Worker henüz düzeltme listesini çekmedi. (Worker kuruldu, ilk çekim bekleniyor) ya da Çalışıyor (Worker listeyi çekti, kanal aktif).
- Bağlantıyı test et — sitenin başlangıç adresini çeker ve yanıtta Worker izini arar; yalnız kurulumdan sonra ve proje sahibine görünür.
- Worker'ı kaldır (geri al) — onay sonrası route'u ve betiği siler, kanalı aktif kanal olmaktan çıkarır; site özgün hâline döner.
- Otomatik kurulum (önerilen) bloğu — token izinlerinin özeti ve Cloudflare API token (gizli alan), Account ID, Zone ID, Route deseni alanları.
- Route deseni ipucu — boş bırakılırsa kullanılacak varsayılan deseni gösterir; www ve çıplak alan adı ayrıysa ikisinin de route olarak eklenmesi gerektiğini hatırlatır.
- Worker'ı kur — üç zorunlu alan dolmadan etkin olmaz; işlem sırasında Kuruluyor… yazar.
- Elle kurulum bloğu ve Worker kodunu ve değişkenleri göster — elle kurulum için kodu ve değişkenleri açar.
- Değişkenler — OTOPILOT_PANEL_URL, OTOPILOT_PROJECT_ID ve OTOPILOT_EDGE_SECRET değerleri; her birinin yanında Kopyala düğmesi vardır.
- Worker kodu — Cloudflare'e yapıştırılacak betiğin tamamı ve Kopyala düğmesi.
- Sınırlar satırı — bu kanalla yapılmayan işler: görsel optimizasyonu, yeni sayfa, adres (slug) değişikliği ve blog yayını.
- Kanal kartı — Cloudflare Worker adı, Google görür ve Dosyalar rozetleri, Son senkron zamanı ve kart üzerinde Bağlantıyı test et ile Yönet düğmeleri.
Sürümler ve geri alma
- Yayın betikleri sekmesinde her satır "Cloudflare Worker · Sürüm 3 (1.0.1)" biçimindedir; parantez içindeki değer düzeltme listesini çeken Worker kodunun sürümüdür.
- Worker'ın çektiği düzeltme kümesi değiştiğinde yeni sürüm Yayında olur, öncekinin etiketi Yerini yenisi aldı olarak değişir.
- Satırda tarih, "12 düzeltme" gibi düzeltme sayısı, varsa "2 geri alındı" bilgisi ve etkilenen sayfaların ilk beş yolu görünür.
- Bu sürümü geri al sürümdeki geri alınabilir tüm düzeltmeleri geri alır; Worker bir sonraki çekişte bu kuralları bırakır. Tek bir düzeltmeyi geri almak için Düzeltmeler sekmesini kullanın.
- Worker'ı kaldır (geri al) ise kanalın tamamını kapatır; düzeltme kayıtları panelde kalır, site düzeltmesiz HTML'e döner.
Sonuçları nasıl yorumlarsınız
- Çalışıyor ve kartta Aktif · Çalışıyor, Worker'ın düzeltme listesini düzenli çektiğini gösterir. Worker listeyi ziyaret ya da bot isteği geldikçe çeker; kanaldan 24 saat çekim gelmezse kart Siteye ulaşmıyor olur ve "Siteye ulaşılamıyor" bildirimi gelir.
- Test mesajındaki kural sayısı, başlangıç sayfasına o an uygulanan kural sayısıdır; başka sayfalardaki düzeltmeler bu sayıya girmez. 0 kural, başlangıç sayfası için düzeltme olmadığı anlamına gelebilir.
- Onayladığınız bir düzeltme en geç önbellek süresi (5 dakika) dolunca sayfada görünür. Panel uygulanan düzeltmeyi varsayılan ayarlarda yaklaşık 2 dakika, 1 saat ve 1 gün sonra canlı sayfadan okuyarak doğrular; doğrulanan düzeltme Doğrulandı olur.
- Yayın betikleri sekmesindeki "Bu kanallar üzerinden şu an sitede 25 düzeltme var." satırı, Worker'ın şu anda sunduğu düzeltmelerin toplamıdır; sayı beklenmedik biçimde düştüyse geri alınan sürümleri kontrol edin.
Örnek senaryo
örnek.com, kendi yazdığı PHP altyapısını Cloudflare arkasında yayınlayan bir hizmet sitesi. Tarama 40 sayfada eksik meta açıklama, kopya başlık ve hatalı canonical buldu; sahibi kaynak koda dokunmak istemiyor. Kanal & Kurulum görünümünde Cloudflare Worker kartını açıyor, Cloudflare'de yalnız örnek.com için Workers Scripts ve Workers Routes düzenleme izni olan bir token oluşturuyor ve Account ID ile Zone ID'yi kopyalıyor. Route desenini boş bırakıp Worker'ı kur diyor.
Bildirimden sonra sitenin ana sayfasını açıyor; durum satırı Çalışıyor oluyor ve Bağlantıyı test et "Worker sitede çalışıyor (3 kural uygulandı)." yanıtını veriyor. Sahibi Düzeltmeler sekmesinde 40 sayfanın önerilerini onaylıyor. Worker birkaç dakika içinde yeni listeyi çekiyor ve Yayın betikleri sekmesinde yeni bir Yayında sürüm beliriyor. Ertesi gün iki sayfadaki başlığın marka adını yanlış yazdığı fark ediliyor; sahibi bu iki düzeltmeyi Düzeltmeler sekmesinden tek tek geri alıyor, kalan düzeltmeler yayında kalıyor ve doğrulama taramaları sonuçları Doğrulandı olarak işaretliyor.
İpuçları
- Token'ı yalnız bu alan adıyla sınırlayın ve adını "otopilot-edge" gibi tanınır bir ad yapın; ileride iptal edeceğiniz zaman kolay bulursunuz.
- Token'ı Cloudflare'de iptal etmeden önce panelden Worker'ı kaldır (geri al) düğmesini kullanın; panel route'u ve betiği silmek için kayıtlı token'a ihtiyaç duyar.
- www ve çıplak alan adı ayrı yayınlanıyorsa ikinci route'u Cloudflare'de aynı Worker'a bağlayın; aksi hâlde düzeltmeler adreslerden yalnız birinde görünür.
- Worker'ı yeniden kurmak gizli anahtarı değiştirmez; route desenini değiştirmek için alanı doldurup Worker'ı kur düğmesine yeniden basmanız yeterlidir.
- Pixel'den Worker'a geçtiyseniz Worker Çalışıyor olduktan sonra Pixel betiğini siteden kaldırın; aynı kuralların iki kez uygulanmasını önlersiniz.
- Route desenini ya da DNS ayarını her değiştirdiğinizde Bağlantıyı test et düğmesine yeniden basın; Worker izinin yanıtta göründüğünü hemen doğrularsınız.
Sık yapılan hatalar
- DNS kaydını "DNS only" (gri bulut) bırakmak; istekler Worker'a uğramaz ve test "Site yanıtında Worker izi yok" uyarısı verir.
- Token'a yalnız Workers Scripts iznini verip Workers Routes iznini unutmak; betik yüklenir ama route oluşturulamaz.
- Elle kurulumda OTOPILOT_EDGE_SECRET değişkenini düz metin olarak eklemek ya da değeri eksik kopyalamak; imza doğrulanamaz ve Worker düzeltme listesi alamaz.
- Worker'ın blog yazısı yayınlamasını ya da görselleri küçültmesini beklemek; bu işler için ayrı bir yayın kanalı ya da site kodu gerekir.
Sık Karşılaşılan Sorunlar
- Token, Account ID (32 karakter), Zone ID (32 karakter) ve route desenini kontrol edin.: Alanlardan biri biçime uymuyor: Account ID ve Zone ID 32 karakterlik değer olmalı, route deseni alanadi.com/* biçiminde olmalıdır. Değerleri Cloudflare'deki Overview sayfasından yeniden kopyalayın, başta ve sonda boşluk bırakmayın.
- Cloudflare token geçersiz ya da süresi dolmuş.: Token yanlış kopyalanmış, iptal edilmiş ya da süresi bitmiştir. Cloudflare'de API Tokens listesinden token'ın etkin olduğunu kontrol edin; gerekirse aynı izinlerle yenisini oluşturup Worker'ı kur adımını tekrarlayın.
- Token'ın yetkisi yetmiyor: Workers Scripts: Edit ve Workers Routes: Edit (bu alan adı) gerekli.: Token doğrulandı ama betik yükleme ya da route oluşturma reddedildi. Token'a Account · Workers Scripts · Edit ve Zone · Workers Routes · Edit izinlerini verin ve Zone Resources bölümünde bu alan adının seçili olduğundan emin olun.
- Site yanıtında Worker izi yok: route alan adına bağlı mı ve site Cloudflare proxy (turuncu bulut) arkasında mı kontrol edin.: Test sayfayı çekti ama Worker'ın eklediği başlığı bulamadı. Cloudflare'de route'un doğru desenle bu Worker'a bağlı olduğunu ve DNS kaydının proxy modunda olduğunu kontrol edin; www ile çıplak alan adı ayrıysa ikisine de route ekleyin.
- Site yanıt vermedi.: Test sırasında sitenin başlangıç adresi yanıt vermedi ya da hata döndü. Sitenin açık olduğunu, Cloudflare güvenlik kurallarının (bot koruması, ülke engeli) panel isteklerini engellemediğini kontrol edip testi yeniden çalıştırın.
- Kurulum bekliyor: Worker henüz düzeltme listesini çekmedi.: Worker kuruldu ama siteye henüz istek gelmedi ya da istekler route'a takılmıyor. Sitenin bir sayfasını açın; durum değişmiyorsa Bağlantıyı test et ile route ve proxy ayarını denetleyin.
- Worker yüklenemedi.: Cloudflare betik yükleme isteğini reddetti. Token izinlerinin doğru olduğundan emin olup birkaç dakika sonra yeniden deneyin; sürerse Elle kurulum yolunu kullanın ya da Yardım & Destek üzerinden bize ulaşın.
- Elle kurduysanız Cloudflare'de Worker route'unu da silin.: Kaldırma sırasında panel route'u silemedi: kurulum elle yapılmıştır ya da token artık geçerli değildir. Cloudflare'de alan adının Workers Routes listesinden route'u ve gerekirse Worker'ı kendiniz silin; panel bağlantıyı kapattığı için Worker artık düzeltme listesi alamaz ve sayfaları değiştirmeden geçirir, ama route ve betik hesabınızda kalır.
İlgili Kılavuzlar
Bu adımları kendi sitenizde uygulayın
Önce ücretsiz site analiziyle sitenizdeki sorunları görün. Hesabınız varsa rehberde anlatılan sayfayı panelde açın.