← Tüm yazılar
rehber github pages

GitHub Pages ile nori.tr Subdomain Bağlama

GitHub Pages, statik siteler için en popüler ücretsiz hosting çözümlerinden biri. Bu rehberde, GitHub Pages üzerinde yayınladığın siteyi nori.tr subdomain'ine nasıl bağlayacağını adım adım anlatıyoruz.

Ön koşullar

  • Onaylanmış bir .nori.tr subdomain'in olmalı
  • GitHub hesabın ve yayınlamak istediğin bir repo'n olmalı
  • Repo'da GitHub Pages aktif olmalı

Adım 1: GitHub Pages'i aktif et

Henüz aktif değilse:

  1. GitHub'da repo'na git
  2. Settings → Pages bölümüne gir
  3. Source kısmından branch'ini seç (genellikle main) ve klasörü belirle (/ (root) veya /docs)
  4. Save'e tıkla

Siten birkaç dakika içinde kullaniciadin.github.io/repo-adi adresinde yayınlanacak.

Adım 2: CNAME dosyası oluştur

Repo'nun kök dizinine CNAME adında bir dosya oluştur. İçeriğine sadece subdomain'ini yaz:

seninadın.nori.tr

Önemli: Dosya adı büyük harfle CNAME olmalı, uzantısı olmamalı. İçinde sadece domain adresin olmalı, başka bir şey yazma.

Adım 3: DNS kaydını yapılandır

nori.tr subdomain'in onaylandıktan sonra DNS kayıtların otomatik olarak yapılandırılır. Eğer manuel yapılandırma gerekiyorsa, aşağıdaki CNAME kaydını eklemelisin:

Tür Ad Değer
CNAME seninadın kullaniciadin.github.io

Adım 4: GitHub'da custom domain'i ayarla

  1. Repo'nda Settings → Pages'e git
  2. Custom domain alanına subdomain'ini yaz: seninadın.nori.tr
  3. Save'e tıkla
  4. GitHub DNS kontrolü yapacak — yeşil tik görene kadar birkaç dakika bekle

Adım 5: Kontrol et

Her şey doğru yapılandırıldıysa, subdomain'in birkaç dakika içinde aktif olacak. Kontrol etmek için:

dig seninadın.nori.tr CNAME

Çıktıda kullaniciadin.github.io görüyorsan her şey yolunda demektir. Tarayıcıda https://seninadın.nori.tr adresini ziyaret ederek test edebilirsin.

Sık karşılaşılan sorunlar

404 hatası alıyorum

CNAME dosyasının repo'nun kök dizininde olduğundan ve içeriğinin doğru olduğundan emin ol. Ayrıca GitHub Pages'in doğru branch ve klasörü işaret ettiğini kontrol et.

DNS henüz yayılmadı

DNS değişiklikleri genellikle birkaç dakika içinde yayılır, ancak nadir durumlarda 24 saate kadar sürebilir. Sabırla bekle ve dig komutuyla kontrol et.

CNAME dosyası her deploy'da siliniyor

Eğer bir build aracı (Hugo, Jekyll, Vite vb.) kullanıyorsan, CNAME dosyasını public/ veya static/ klasörüne koy, böylece build çıktısına dahil olur.

Özet

  1. GitHub Pages'i aktif et
  2. Repo'ya CNAME dosyası ekle
  3. DNS CNAME kaydını yapılandır
  4. GitHub Settings'ten custom domain'i ayarla
  5. Birkaç dakika bekle ve test et

Yazan: Yunus Emre Aygün - Kurucu, nori.tr & Bilişimya