Belirli bir URL'yi başka bir URL'ye 301/302 ile nasıl yönlendiririm?

Kısa cevap

Eski adresi tanımlayan bir Path koşulu (ör. Exact Match, /eski-sayfa) oluşturulur; Location Redirection aksiyonunda Redirect Code ve Redirect Location (yeni adres) girilip koşul seçilir ve aksiyon vService'in Actions alanına eklenir. Kalıcı taşımada 301, geçici yönlendirmede 302 seçilir; POST isteğinin aynı yöntemle gitmesi gerekiyorsa 308 ya da 307 seçilir. Location redirection koşulsuz kaydedilirse hiç çalışmaz.

Temel Bilgi

Yönlendirme yanıtı, istemciye bir 3xx durum kodu ve gidilecek adresi taşıyan Location başlığı gönderir; tarayıcı bu adrese yeni bir istek yapar. Kodlar iki soruya göre seçilir: taşıma kalıcı mı, POST gibi istekler aynı yöntemle mi tekrarlanmalı (RFC 9110 · 15.4 Redirection 3xx).

Kod	Anlamı	Yöntem	Ne zaman
301 Moved Permanently	Kaynak kalıcı olarak taşındı; arama motorları yeni adresi dizine alır, tarayıcılar yanıtı önbelleğe alabilir	Tarayıcılar POST'u GET'e çevirebilir	Kalıcı adres değişikliği (SEO)
302 Found	Kaynak geçici olarak başka adreste; eski adres geçerliliğini korur	Tarayıcılar POST'u GET'e çevirebilir	Kampanya, geçici bakım, deneme
303 See Other	Sonuç başka bir adreste; tarayıcı GET ile gider	Her zaman GET	Form gönderiminden sonra sonuç sayfası
307 Temporary Redirect	302 gibi geçici	Yöntem ve gövde korunur	Geçici taşımada POST/PUT
308 Permanent Redirect	301 gibi kalıcı	Yöntem ve gövde korunur	Kalıcı taşımada POST/PUT

Sorun: Adresi Değişen Sayfalar Kırık Bağlantıya Dönüşüyor

Bir sayfanın adresi değiştiğinde eski adrese gelen kullanıcılar ve arama motorları 404 alır; eski bağlantılardan gelen trafik ve arama sıralaması kaybolur. Eski adrese gelen isteğin, Kurum Servisine gitmeden yeni adrese yönlendirilmesi gerekir.

Çözüm: Beş Yöntem

Yöntemlerin hepsi aynı Location Redirection aksiyonunu kullanır; eski adresin nasıl tanındığı ve yeni adresin nasıl üretildiği değişir. Yönlendirme yalnızca HTTP vService'te çalışır.

Durumunuz	Uygun yöntem
Tek bir sayfa başka bir adrese taşındı	Yöntem 1: Location redirection + Path koşulu
Eski adres belirli bir sorgu dizesiyle tanımlı (/urun.php?id=5)	Yöntem 2: Path + Query ya da URL koşulu
Bir yol önekinin tamamı taşındı (/blog/… → /haber/…)	Yöntem 3: Replace (first) ile önek değiştirme
Çok sayıda eski adres → yeni adres eşlemesi var	Yöntem 4: Dynamic list + Mapping
Komut satırından yapılandırma	Yöntem 5: WEB-CLI

Yöntem 1: Location Redirection + Path Koşulu Önerilen

• Nasıl çalışır Koşula uyan istek Kurum Servisine gitmez; TR7 seçilen kodla ve yeni adresle yanıt verir.
• Nerede açılırLoad Balancer → Conditions · Load Balancer → Actions · vService → Details → Actions
• Gereksinim En az bir koşul; koşulsuz Location redirection çalışmaz
• vService tipi HTTP

Adım adım yapılandırma

1

Adım 1 Koşul formunu aç

Sol alttaki TR7 logosuyla açılan menüde Load Balancer → Conditions → Add tıklanır (nasıl eklenir).

2

Adım 2 Path koşulunu tanımla

Criteria = Path, eşleştirme yöntemi Exact Match (varsayılan), değer /eski-sayfa girilir. Path değeri sorgu dizesini içermez; /eski-sayfa?x=1 isteği de bu koşula uyar. Büyük/küçük harf farkı gözetilmeyecekse Case Insensitive işaretlenir.

3

Adım 3 Koşulu kaydet

Formun altındaki Add tıklanır.

4

Adım 4 Aksiyon formunu aç

Load Balancer → Actions → Add tıklanır (nasıl eklenir).

5

Adım 5 Location redirection'ı tanımla

Action Name girilir, Action Type = Location Redirection seçilir.

• Redirect Code: varsayılanı 301: Moved Permanently. Seçenekler: 301: Moved Permanently, 302: Found (Moved Temporarily), 303: See Other, 307: Temporary Redirect, 308: Permanent Redirect.
• Redirect Location (zorunlu): /yeni-sayfa (aynı alan adı) ya da https://www.example.com/yeni-sayfa (başka alan adı). Adres girildiği gibi kullanılır; eski isteğin sorgu dizesi kendiliğinden eklenmez, korunacaksa fx ile Request query değişkeni adresin sonuna eklenir.
• Conditions: 2. adımdaki koşul seçilir.
• Hit Counter (varsayılan kapalı) açılırsa yönlendirmeler sayılır.

6

Adım 6 Aksiyonu kaydet

Formun altındaki Add tıklanır.

7

Adım 7 vService'i düzenle

Load Balancer → Load Balancer vService List ekranında HTTP vService seçilip Edit tıklanır (Edit).

8

Adım 8 Aksiyonu Actions alanına ekle

Details açılır ve Actions alanında aksiyon seçilir. Aksiyonlar listedeki sırayla işlenir; yönlendirme isteği bitirdiği için kendisinden sonraki aksiyonlar bu istekte çalışmaz (aksiyon sıralaması).

9

Adım 9 Kaydet

Save tıklanır. Değişiklik açık bağlantılar kopmadan uygulanır; ilerleme ekranın sağ altındaki senkron göstergesinde izlenir. Cluster'da varsayılan auto-sync ile eş cihaza da gönderilir; Manual Sync Mode açıksa eş cihaza Synchronize ile gönderilir.

Doğrulama

1Yanıtİstemci tarafı

curl -sI http://www.example.com/eski-sayfa

BeklenenHTTP/1.1 301 Moved Permanently + Location: /yeni-sayfa

2Sayım ve logTR7 tarafı

Hit Counter açıksa vService panosunun Action Hits sekmesinde aksiyonun sayısı artar; HTTP Logs ekranında istek 301 durum koduyla görünür.

BeklenenSayı artar · durum kodu 301

Yöntem 2: Path + Query ya da URL Koşulu

• Nasıl çalışır Eski adres belirli bir sorgu dizesiyle tanımlıysa (/urun.php?id=5) koşul yolu ve sorguyu birlikte karşılaştırır; yalnızca o istek yönlendirilir.
• Nerede açılırLoad Balancer → Conditions → Path + Query ya da URL
• Gereksinim Sorgu dizesi istekte her zaman aynı sırayla gelmeli (Exact match birebir karşılaştırır)
• vService tipi HTTP

Adım adım yapılandırma

1

Adım 1 Koşul formunu aç

Load Balancer → Conditions → Add tıklanır.

2

Adım 2 Path + Query koşulunu tanımla

Criteria = Path + Query, eşleştirme Exact match, değer /urun.php?id=5 girilir. Alan adı da ayırt edilecekse Criteria = URL seçilir ve değer şema ile birlikte yazılır: http://www.example.com/urun.php?id=5. URL değeri isteğin şemasını da içerdiğinden HTTPS ile gelen istek için ayrı bir https://www.example.com/urun.php?id=5 koşulu eklenir ve iki koşul aksiyonda or ile seçilir.

3

Adım 3 Koşulu kaydet

Add tıklanır.

4

Adım 4 Aksiyon formunu aç

Load Balancer → Actions → Add tıklanır.

5

Adım 5 Aksiyonu tanımla

Yöntem 1'in 5. adımındaki gibi Location Redirection tanımlanır; Redirect Location = /urunler/5, Conditions alanında bu koşul seçilir.

6

Adım 6 Aksiyonu kaydet

Add tıklanır.

7

Adım 7 vService'i düzenle

vService Edit ile açılır.

8

Adım 8 Aksiyonu Actions alanına ekle

Details → Actions alanında aksiyon seçilir.

9

Adım 9 Kaydet

Save tıklanır.

Doğrulama

1Yanıtİstemci tarafı

curl -sI "http://www.example.com/urun.php?id=5" ve karşılaştırma için curl -sI "http://www.example.com/urun.php?id=6"

Beklenenid=5 → 301 + Location: /urunler/5 · id=6 → yönlendirme yok

Yöntem 3: Replace (first) ile Önek Değiştirme

• Nasıl çalışır Redirect location, isteğin yolunu Smart Variable olarak alır ve Replace (first) fonksiyonuyla önekini değiştirir; /blog/ altındaki her sayfa /haber/ altındaki karşılığına gider.
• Nerede açılırLocation Redirection → Redirect Location → fx
• Gereksinim Önek dışındaki yol yapısı yeni adreste aynı kalmalı
• vService tipi HTTP

Adım adım yapılandırma

1

Adım 1 Koşul formunu aç

Load Balancer → Conditions → Add tıklanır.

2

Adım 2 Önek koşulunu tanımla

Criteria = Path, eşleştirme Start, değer /blog/ girilir. Case insensitive işaretlenmez: fonksiyondaki ^/blog/ kalıbı büyük/küçük harfe duyarlıdır; koşul /BLOG/yazi isteğini de yakalarsa adres değişmeden aynı yere yönlendirilir ve döngü oluşur.

3

Adım 3 Koşulu kaydet

Add tıklanır.

4

Adım 4 Aksiyon formunu aç

Load Balancer → Actions → Add tıklanır.

5

Adım 5 Aksiyonu tanımla

Action Name girilir, Action Type = Location Redirection, Redirect Code = 301: Moved Permanently seçilir.

6

Adım 6 Yol değişkenini ekle

Redirect Location alanındaki fx ile Path/page of the request [URI] değişkeni eklenir (Variables).

7

Adım 7 Replace (first) fonksiyonunu ekle

Değişken penceresinde Add Functions açılır ve Replace (first) seçilir: To Replace = ^/blog/, New Value = /haber/. To Replace alanı düzenli ifadedir; ^ yalnızca yolun başındaki /blog/ bölümünü değiştirir.

8

Adım 8 Sorgu dizesini ekle

Aynı alanda yol değişkeninin arkasına fx ile Request query değişkeni eklenir. Bu değişken sorgu dizesini başındaki ? ile birlikte verir, sorgu yoksa boş kalır; araya ayrıca ? yazılmaz.

9

Adım 9 Koşulu seç

Conditions alanında 2. adımdaki koşul seçilir.

10

Adım 10 Aksiyonu kaydet

Add tıklanır.

11

Adım 11 vService'i düzenle

vService Edit ile açılır.

12

Adım 12 Aksiyonu Actions alanına ekle

Details → Actions alanında aksiyon seçilir.

13

Adım 13 Kaydet

Save tıklanır.

Kalıbın örnek isteklerdeki sonucu:

İstek	Location
/blog/yazi-1	/haber/yazi-1
/blog/2024/ocak/yazi?utm=x&p=2	/haber/2024/ocak/yazi?utm=x&p=2
/blog/	/haber/
/blog/blog/x	/haber/blog/x (yalnızca baştaki önek değişir)
/blog (sonda / yok)	Koşul uymaz; yönlendirilmez. Bu adres de taşınacaksa Exact match /blog için Yöntem 1 ile ayrı bir yönlendirme eklenir

Doğrulama

1Yanıtİstemci tarafı

curl -sI "http://www.example.com/blog/2024/yazi?p=2"

Beklenen301 + Location: /haber/2024/yazi?p=2

Yöntem 4: Dynamic List + Mapping ile Toplu Eşleme

• Nasıl çalışır Eski yollar bir Dynamic List koşulunda aranır; Redirect location, Mapping (exact match) fonksiyonuyla her eski yolu kendi yeni yoluna çevirir. Tek koşul ve tek aksiyonla yüzlerce eşleme yönetilir.
• Nerede açılırConditions → Dynamic List · Redirect Location → fx → Mapping (exact match)
• Gereksinim Eşleme listesindeki her eski yol koşulun listesinde de bulunmalı; yollar boşluk içermemeli
• vService tipi HTTP

Adım adım yapılandırma

1

Adım 1 Koşul formunu aç

Load Balancer → Conditions → Add tıklanır.

2

Adım 2 Dynamic list koşulunu tanımla

Criteria = Dynamic List seçilir. Key to Search alanındaki varsayılan istemci IP değişkeni silinip fx ile Path/page of the request [URI] eklenir; Search Method = Exact match; List alanına eski yollar her satıra bir tane yazılır (/urun-a, /urun-b, /hakkimizda.html).

3

Adım 3 Koşulu kaydet

Add tıklanır.

4

Adım 4 Aksiyon formunu aç

Load Balancer → Actions → Add tıklanır.

5

Adım 5 Aksiyonu tanımla

Action Type = Location Redirection, Redirect Code = 301: Moved Permanently seçilir.

6

Adım 6 Mapping fonksiyonunu ekle

Redirect Location alanındaki fx ile Path/page of the request [URI] eklenir, Add functions → Mapping (exact match) seçilir ve listeye her satıra eski-yol yeni-yol yazılır:

/urun-a /urunler/a
/urun-b /urunler/b
/hakkimizda.html /kurumsal/hakkimizda

Ardından sorgu dizesini korumak için Request query değişkeni eklenir.

7

Adım 7 Koşulu seç

Conditions alanında 2. adımdaki koşul seçilir.

8

Adım 8 Aksiyonu kaydet

Add tıklanır.

9

Adım 9 vService'i düzenle

vService Edit ile açılır.

10

Adım 10 Aksiyonu Actions alanına ekle

Details → Actions alanında aksiyon seçilir.

11

Adım 11 Kaydet

Save tıklanır.

Mapping'de hiçbir satır eşleşmezse sonuç boş olur; bu yüzden koşul listesi ile eşleme listesi aynı eski yolları içermelidir. /urun-a/ (sonda /) gibi bir istek ne listeye ne eşlemeye uyar ve yönlendirilmez.

Doğrulama

1Yanıtİstemci tarafı

Listedeki her eski yol curl -sI ile istenir; listede olmayan bir yol da denenir.

Beklenen/urun-a → 301 + Location: /urunler/a · listede olmayan yol yönlendirilmez

Yöntem 5: WEB-CLI

• Nasıl çalışır Koşul, aksiyon ve vService bağlantısı WEB-CLI komutlarıyla oluşturulur; sonuç Yöntem 1 ile aynıdır.
• Nerede açılır TR7 WEB-CLI → lb condition · lb action · lb service
• Gereksinim WEB-CLI erişimi; koşulun kimliği (ID)
• vService tipi HTTP

Adım adım yapılandırma

1

Adım 1 Koşulu ekle

Path koşulu eklenir; eşleştirme belirtilmezse Exact match kullanılır:

lb condition add criteria path query /eski-sayfa --name eski-sayfa

2

Adım 2 Koşulun kimliğini al

Aksiyon koşulu adıyla değil kimliğiyle (ID) bağlar. lb condition add başarılı olunca çıktı vermez; kimlik, koşul listesinin id sütununda koşulun adının yanında görülür:

lb condition list

3

Adım 3 Aksiyonu ekle

lb action add type req_redirect_location name eski-yeni redirectLoc /yeni-sayfa --redirectCode 301 --cond <koşul-kimliği>

--redirectCode her zaman yazılır; yazılmazsa komut satırının varsayılanı olan 300 (Multiple Choices) kaydedilir, arayüzdeki 301 varsayılanı burada geçerli değildir. --cond yazılmazsa aksiyon kaydedilir ama hiç çalışmaz.

4

Adım 4 vService'teki mevcut aksiyonlara bak

lb service show <vService>

Çıktıdaki rules.0, rules.1 … satırları vService'teki aksiyonları sırasıyla gösterir. lb service update komutunda --rules.N o sıradaki aksiyonun yerine geçer; yeni aksiyon ilk boş sıraya yazılır.

5

Adım 5 Aksiyonu vService'e ekle

vService'te iki aksiyon (0 ve 1) varsa yeni aksiyon 2. sıraya yazılır; hiç aksiyon yoksa --rules.0 kullanılır:

lb service update id <vService> --rules.2 eski-yeni

Doğrulama

1YapılandırmaTR7 tarafı

lb service show <vService> çıktısında rules.N satırlarına bakılır; ardından curl -sI http://www.example.com/eski-sayfa denenir.

Beklenenrules.2 = eski-yeni, önceki aksiyonlar yerinde · 301 + Location: /yeni-sayfa

Sık Yapılan Hatalar

Koşulsuz Location redirection çalışmaz

Location redirection koşul seçilmeden de kaydedilir ama hiçbir isteği yönlendirmez; arayüz bu durumda uyarı vermez. Her yönlendirmede en az bir koşul seçilir (Location Redirection veya User Authentication (On HTTP request) action'ını koşulsuz eklersem neden çalışmıyor?).

• Sorgu dizesinin kendiliğinden taşınacağını sanmak. Redirect location girildiği gibi kullanılır; sorgu dizesi korunacaksa Request query ya da Path + query of the request değişkeni eklenir.
• Denemeyi 301 ile yapmak. Tarayıcılar 301'i önbelleğe alır; yanlış bir kural düzeltilse bile ziyaretçi eski hedefe gitmeye devam edebilir. Kural önce 302 ile denenir, doğrulandıktan sonra 301'e çevrilir.
• POST isteklerini 301/302 ile yönlendirmek. Tarayıcılar bu kodlarda POST'u GET'e çevirebilir ve form verisi kaybolur; yöntem korunacaksa 308 ya da 307 seçilir.
• Döngü kurmak. Yeni adres aynı vService'e gelip koşulu yine sağlıyorsa (ör. Path Start /urun koşulu ve hedef /urunler/…) istek sonsuz yönlendirilir; TR7 bunu engellemez. Koşul hedef adresi kapsamayacak biçimde dar tutulur.
• Önek yönlendirmesinde Case insensitive işaretlemek. Replace (first) kalıbı büyük/küçük harfe duyarlıdır; büyük harfli istek değişmeden aynı adrese yönlendirilir ve döngü oluşur.
• Network ya da L7 TCP vService'te denemek. Location redirection yalnızca HTTP vService'in Actions listesinde görünür.

Dokümantasyonda nasıl yapılır

• Location Redirection · Redirect Code
• Location Redirection · Redirect Location
• Location Redirection · Yönlendirmenin çalışma biçimi
• Path koşulu · Content Matching Method
• Converters · Text Manipulation

İlgili sorular

• www ekleme / kaldırma yönlendirmesini nasıl yaparım?
• Eski domainden yeni domaine SEO dostu geçişi nasıl yaparım?
• URL path'ini backend'e gitmeden önce yeniden yazabilir miyim (rewrite)?
• Location Redirection veya User Authentication (On HTTP request) action'ını koşulsuz eklersem neden çalışmıyor?