SPA yenilenince 404 veriyor mu? Tek bir ayar çözer
Son güncelleme: 2026-11-11
Kısaca: Site ayarları > Site bölümünde Daha fazla’yı açın ve “Bilinmeyen adreslerde ana sayfayı aç (uygulama tarzı siteler için)” seçeneğini açın; React veya Vue sitenizde doğrudan bağlantılar ve yenilemeler 404 yerine uygulamanızı açar. Dikkat: bu seçenek açıkken “Var olmayan adreslerde gösterilecek sayfa” sıradan adreslerde kullanılmaz, bu yüzden sitenize uyanı seçin.
Bir bakışta
- Gereken süre
- Yaklaşık 2 dk
- Gereken plan
- Ücretsiz
- Kod bilgisi
- Gerekmez
- Nerede yapılır
- Düzenleyici
Adım adım
- 1
Derleme çıktısı klasörünü yükleyin
React, Vue veya Vite sitesinde, derleme komutunun ürettiği klasörü (çoğunlukla dist) ZIP olarak ya da klasör halinde yükleyin. Bu siteler neredeyse boş bir index.html içerir ve ekranı bir betik çizer. Bu yüzden /about gibi bir adres için dosya yoktur ve seçenek kapalıyken o adresi doğrudan açmak ya da yenilemek 404 verir.
index.html<!doctype html><div id="root"></div><script type="module" src="/assets/index.js"></script> - 2
SPA seçeneğinin açık olduğunu kontrol edin
ZIP, klasör veya GitHub ile içe aktardıktan hemen sonra dosyalarınız açıkça bu tür bir uygulama yapısındaysa seçenek kendiliğinden açılır ve düzenleyici sizi bilgilendirir. Kendiniz kontrol etmek için soldaki menüden Ayarlar > Site ayarları > Site’ye gidin, Daha fazla’yı açın ve “Bilinmeyen adreslerde ana sayfayı aç (uygulama tarzı siteler için)” seçeneğini açın. Değişiklikler otomatik kaydedilir ve yeniden yayınlamadan hemen geçerli olur.
Site ayarları > Site > Daha fazla içinde SPA anahtarı var - 3
Doğrudan bağlantı ve yenilemeyle deneyin
Adresinizin sonuna uygulamanızın bir rotasını ekleyip açın ve sayfayı yenileyin. 404 yerine uygulamanız görünüyorsa tamamdır. Yalnızca ekran adresleri (dosya uzantısı olmayanlar) ana sayfayı açar; görsel veya betik gibi uzantılı bir dosya yoksa yine 404 döner.
myname.html2site.com/about YayındaAnahtar açıkken bu adresi yenilemek uygulamanızı açar
- 4
404 sayfasıyla birlikte mi? Birini seçin
“Var olmayan adreslerde gösterilecek sayfa”, Site ayarları > Site’de bu sitedeki sayfalar arasından seçilir (seçmezseniz varsayılan 404 sayfası gösterilir). Birden çok sayfalı sıradan siteler için doğrusu budur ve SPA anahtarı kapalı kalır. Anahtar açıkken bilinmeyen adresler ana sayfayı açar ve o 404 sayfası kullanılmaz. Bir uygulamanın içinde “bulunamadı” ekranı istiyorsanız, onu uygulamanızın yönlendiricisinde oluşturun.
Site ayarları > SiteVar olmayan adreslerde gösterilecek sayfa Varsayılan 404 sayfasıBilinmeyen adreslerde ana sayfayı aç ON
Sık sorulan sorular
React uygulamam yenilenince neden 404 veriyor?
Tek sayfalık bir uygulamada her adres için bir dosya yoktur; tarayıcıdaki bir betik adresi okuyup ekranı çizer. Statik barındırma adresle aynı adlı bir dosya arar, /about için bulamaz ve 404 döner. SPA seçeneğini açtığınızda o adres ana sayfayı sunar ve uygulamanız devralır.
SPA seçeneğini kendim mi açmalıyım?
ZIP, klasör veya GitHub ile içe aktardıktan hemen sonra dosyalarınız açıkça uygulama biçimindeyse (örneğin bir betiğin doldurduğu boş bir ana sayfa) kendiliğinden açılır. İşaretler daha zayıfsa Site ayarları, Daha fazla altında nedenini söyleyen bir öneri gösterir. Her iki durumda da anahtarla açıp kapatabilirsiniz.
Sıradan bir sitede açık bırakabilir miyim?
Önermiyoruz. Açıkken yanlış yazılan her adres ana sayfayı açar, özel 404 sayfanız hiç kullanılmaz ve arama motorları var olmayan adresleri gerçek sayfa sayabilir. Her sayfası için dosyası olan siteler bunu kapalı tutmalı.
SPA sitesinde yine de “sayfa bulunamadı” ekranı gösterebilir miyim?
Bu seçenek bilinmeyen adresleri ana sayfaya gönderir, dolayısıyla o ekran kendi uygulamanızın yönlendiricisinden gelmelidir. 404 sayfası kullanmak isterseniz anahtarı kapatın ve “Var olmayan adreslerde gösterilecek sayfa” altından bir sayfa seçin.
Açtım ama hâlâ 404 alıyorum. Ne yapmalıyım?
Önce dosya listesinde bir ana sayfa (index.html) olup olmadığına bakın; yoksa açılacak bir şey olmaz ve 404 alırsınız. Ayrıca .js veya .png gibi uzantılı adresler dosya yoksa 404 döndürür ve bu doğrudur; uygulamanızın yüklediği dosya yollarının doğru olduğunu kontrol edin.
Sıradaki okuma
- Site klasörünüzü ZIP olarak yükleyip kendi adresinizi alın Birden çok dosyalı bir siteyi (CSS, JS, görseller, ek sayfalar) ZIP ya da tüm klasör olarak ücretsiz kendi adresinizde yayınlama rehberi (Türkçe)
- Bir GitHub deposunu içe aktarıp statik site olarak yayınlayın Herkese açık bir GitHub deposunun statik dosyalarını içe aktarıp ücretsiz kendi adresinizde yayınlama rehberi: derleme yok, index.html gerekli (Türkçe)
- Yayınlanan sitenizi önceki bir sürüme geri alın Yayınlanmış bir siteyi önceki sürüme geri alma: inceleme, geri yükleme, geri yüklemeyi geri alma ve ücretsiz ile Plus’ın sakladıkları (Türkçe)
- Kendi alan adınızı sitenize nasıl bağlarsınız Yayınlanmış bir HTML sitesine kendi alan adınızı bağlama rehberi: adresi girme, alan adını aldığınız yerde CNAME ve TXT değerlerini ekleme, Bağlı olmasını bekleme, otomatik HTTPS (Plus’tan itibaren)
Denemek okumaktan hızlı — HTML'nizi yapıştırın ve hemen yayınlayın.