Statik Dosya Sitesi Ekleme
ServBay, çoklu dil ve veri tabanı desteğiyle güçlü bir yerel web geliştirme aracıdır. Dinamik sitelerin yanı sıra, ServBay özellikle HTML, CSS ve JavaScript kullanılarak oluşturulan basit web sayfaları veya ön uç uygulamaları gibi statik dosya sitelerinin barındırılması ve test edilmesinde de oldukça etkilidir.
Bu makalede, ServBay üzerinde statik dosya sitesi ekleme ve yapılandırma adımlarını bulacaksınız.
Genel Bakış
Statik dosya siteleri, sunucu tarafı script’lerin (ör. PHP, Node.js, Python vb.) çalıştırılmadığı, dosyaların web sunucusu tarafından doğrudan sunulduğu sitelerdir. Genellikle HTML sayfaları, CSS dosyaları, JavaScript dosyaları, görseller ve fontlar gibi kaynaklar içerir.
ServBay ile yerel ortamda statik site barındırmak; geliştirme, hata ayıklama ve test süreçlerini kolaylaştırır. Özellikle üretim ortamı alan adını taklit etme, HTTPS bağlantısı denemeleri veya çapraz kaynak paylaşımı (CORS) testleri gibi senaryolarda büyük avantaj sağlar.
Kullanım Senaryoları
- Saf ön uç projelerinin (HTML/CSS/JS) geliştirilmesi ve test edilmesi.
- Statik dokümantasyon veya blog sitelerinin barındırılması.
- Farklı web sunucularının (Caddy/Nginx) statik kaynaklara tepkisinin test edilmesi.
- Yerel ortamda üretim benzeri alan adı ve HTTPS erişiminin simülasyonu.
- React, Vue, Angular gibi modern ön uç çatıların inşa edilmiş çıktılarının test edilmesi.
Önkoşullar
- ServBay'i macOS'ta başarıyla kurup çalıştırmış olmalısınız.
- Yayınlamak istediğiniz statik site dosyalarına sahip olmalısınız.
Adım Adım Talimatlar
Aşağıdaki adımları izleyerek ServBay üzerinde statik dosya sitenizi kolayca ekleyebilirsiniz:
Adım 1: Site Dosyalarınızı Hazırlayın
Öncelikle, statik site dosyalarınızı (ör. index.html
, style.css
, script.js
vb.) tek bir klasörde topladığınızdan emin olun.
Site klasörünüzü ServBay’in varsayılan kök dizini olan /Applications/ServBay/www
altında oluşturmanız önerilir. Bu, dosya yönetimini daha düzenli tutmanıza yardımcı olur. Örneğin, my-static-site
adında bir site oluşturmak isterseniz, /Applications/ServBay/www/
dizininde aynı isimde bir klasör oluşturun ve tüm site dosyalarınızı oraya aktarın.
# Terminalde örnek site dizini oluşturun
mkdir -p /Applications/ServBay/www/servbay-static-demo
cd /Applications/ServBay/www/servbay-static-demo
# Basit bir index.html dosyası oluşturun
echo '<!DOCTYPE html>
<html lang="zh-Hans">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>ServBay 静态网站示例</title>
<style>
body { font-family: sans-serif; text-align: center; margin-top: 50px; }
h1 { color: #333; }
</style>
</head>
<body>
<h1>Tebrikler! ServBay statik site yapılandırması başarılı!</h1>
<p>Bu yerel statik sayfaya ServBay üzerinden erişiyorsunuz.</p>
</body>
</html>' > index.html
# Dosya yapınız şu şekilde olacaktır:
# /Applications/ServBay/www/servbay-static-demo/index.html
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
Adım 2: ServBay'e Site Ekleme
- ServBay uygulamasını başlatın.
- Sol menüden Siteler seçeneğine tıklayın (Not: Eski sürümlerde "Ana Bilgisayar" olarak görünebilir, son sürümde "Siteler" olarak güncellenmiştir).
- Site listesi ekranında alttaki Ekle butonuna tıklayın. Karşınıza bir yapılandırma penceresi açılacaktır.
Adım 3: Site Ayarlarını Yapılandırın
Açılan pencerede şu bilgileri girin veya seçin:
- Alan Adı (Domain): Sitenize yerelde hangi alan adıyla erişmek istediğinizi girin. Önerilen uzantı
.servbay.demo
dur; örneğinstatic.servbay.demo
veyamy-static-site.servbay.demo
. ServBay,.servbay.demo
uzantılı alan adlarının yerelde çözülmesini otomatik olarak sağlar; hosts dosyanızı elle düzenlemenize gerek yoktur.- Açıklama:
.servbay.demo
uzantısı, gerçek alan adlarıyla çakışmayı önler ve ServBay’in entegre DNS çözümleyicisi sayesinde bu tür domainler otomatik olarak bilgisayarınıza yönlendirilir.
- Açıklama:
- Yol (Path): Sağdaki klasör simgesine tıklayın ve 1. adımda oluşturduğunuz site klasörünü seçin; örneğin
/Applications/ServBay/www/servbay-static-demo/
.- Açıklama: Yol, Web sunucusunun (Caddy ya da Nginx) site dosyalarını arayacağı kök dizindir (Document Root).
http://static.servbay.demo/
adresine gittiğinizde, sunucu önce bu klasörde birindex.html
(veya diğer varsayılan dosyaları) arar. Yolun, site dosyalarını içeren klasöre işaret ettiğinden emin olun, spesifik bir dosyaya (ör.index.html
) değil.
- Açıklama: Yol, Web sunucusunun (Caddy ya da Nginx) site dosyalarını arayacağı kök dizindir (Document Root).
- Port: Genellikle varsayılan bırakılır. HTTP için 80, HTTPS için 443 standart portlardır. Alternatif bir port kullanmak istiyorsanız burada değiştirebilirsiniz.
- Web Sunucusu: Statik siteler için hem Caddy hem de Nginx mükemmel seçenektir.
- Caddy: Basit yapılandırma sağlar, HTTP/2 ve HTTPS (ServBay User CA desteğiyle) otomatik olarak ayarlanır; ServBay'in varsayılan önerisidir.
- Nginx: Yüksek performans ve esnek yapılandırma sunar; üretim ortamlarında yaygındır.
- Birini seçmeniz yeterlidir.
- PHP Sürümü: Statik siteler için PHP gerekmez; None (Yok) seçiniz.
- Node.js Sürümü: Statik siteler için Node.js gerekmez; None (Yok) seçiniz.
- Python Sürümü: Statik siteler için Python gerekmez; None (Yok) seçiniz.
- Go Sürümü: Statik siteler için Go gerekmez; None (Yok) seçiniz.
- Java Sürümü: Statik siteler için Java gerekmez; None (Yok) seçiniz.
- SSL: Statik sitenize yerelde HTTPS üzerinden erişmek istiyorsanız bu seçeneği işaretleyebilirsiniz. ServBay’in entegre ServBay User CA sertifikası ile otomatik olarak yerel bir SSL sertifikası ayarlanır, böylece HTTPS testleri yapabilirsiniz.
- CORS: Eğer statik siteniz farklı bir yerel alan adından kaynak veya API çağrısı yapacaksa, bu seçeneği işaretleyip uygun ayarları yapabilirsiniz. ServBay, CORS başlıklarını site için yapılandırmanıza imkan tanır.
Adım 4: Kaydedin ve Değişiklikleri Uygulayın
- Tüm yapılandırma bilgilerini girdikten sonra, pencerenin altındaki Kaydet butonuna tıklayın.
- ServBay’in site listesine geri dönün; az önce eklediğiniz yeni siteyi göreceksiniz.
- Site listesi üzerinde üstteki Değişiklikleri Uygula butonuna tıklayın.
- Açıklama: Değişiklikleri Uygulaya tıklamak, ServBay’in web sunucularının (Caddy veya Nginx) yapılandırmasını yeniden yüklemesini sağlar ve yeni ayarların geçerli olması için gereklidir. Bu adım atlanırsa eklediğiniz siteye erişemezsiniz.
Kurulumu Doğrulama
Yapılandırıp değişiklikleri kaydettikten sonra, web tarayıcınızda belirlediğiniz alan adını (örn. http://static.servbay.demo
veya SSL'i etkinleştirdiyseniz https://static.servbay.demo
) adres çubuğuna yazıp siteye erişin.
Her şey doğru ayarlandıysa, örnekte oluşturduğunuz index.html
sayfası gibi statik site içeriğiniz tarayıcıda görünecektir.
Dikkat Edilecekler
- Yol olarak gerçekten dosyalarınızın bulunduğu site klasörünü girdiğinizden emin olun.
- Her yeni site eklediğinizde, yapılandırma değiştirdiğinizde veya sildiğinizde, mutlaka Değişiklikleri Uygula butonuna tıklayın.
- Statik siteler için sunucu taraflı dillere (PHP, Node.js vd.) None atamak en iyi uygulamadır; gereksiz kaynak tüketimi ve olası güvenlik açıklarını önler.
- Erişim sıkıntısı yaşarsanız, ServBay'in çalıştığından, web sunucusunun (Caddy/Nginx) durumunun iyi olduğundan ve tarayıcıda girdiğiniz alan adının ServBay'dekiyle tamamen uyumlu olduğundan emin olun.
Sıkça Sorulan Sorular (SSS)
S: Alan adına gittiğimde “Bu siteye ulaşılamıyor” ya da “Sunucu bulunamadı” hatası alıyorum, ne yapmalıyım?
C:
- ServBay uygulamasının çalıştığından emin olun.
- ServBay’de Değişiklikleri Uygula butonuna tıkladığınızdan emin olun.
- Tarayıcıda girdiğiniz alan adının tam olarak ServBay’de yapılandırılan isimle (ve protokol ön ekiyle, ör.
http://
veyahttps://
) aynı olduğuna emin olun. - Yol ayarının site dosyalarını içeren klasöre doğru işaret ettiğinden emin olun.
- ServBay log dosyalarını kontrol edin, daha fazla hata detayı bulabilirsiniz.
S: Site yolunu ayarladım ama tarayıcıda siteye gidince index.html yerine dizin listesi görünüyorsa nedeni ne olabilir?
C: Genelde kök dizinde varsayılan bir ana sayfa dosyası (ör. index.html
) bulunmadığında bu durum oluşur. Site kök klasörünüzde index.html
(ya da web sunucunuzun varsayılan ana sayfa dosyası) olduğundan ve dosya adı/uzantısının doğru yazıldığından (büyük/küçük harf duyarlılığına dikkat edin) emin olun.
S: Statik site için HTTPS desteği ekleyebilir miyim?
C: Evet, ServBay’de site ayarlarında SSL seçeneğini işaretleyebilirsiniz. ServBay, yerel alan adınız için kendi User CA’sı ile otomatik olarak SSL sertifikası oluşturur ve güvenilir hale getirir; böylece yerel HTTPS testleri yapabilirsiniz.
Sonuç
ServBay sayesinde basit HTML sayfalarından modern ön uç uygulama çıktılarına kadar statik dosya sitelerini yerelde kolayca ekleyip yönetebilirsiniz. ServBay’in site yönetimi, yerel alan adı çözümleme ve SSL desteği ile ön uç geliştirme ve test süreçleriniz çok daha verimli hale gelir.