ServBay'de Ters Proxy Kurulumu: Dahili Ağ veya Uzaktaki Web Sitelerini Yerel Ortama Yönlendirme ve Geliştirme

ServBay, macOS için özel olarak geliştirilmiş bir yerel Web geliştirme ortamıdır. PHP, Node.js, Python, Go, Java gibi birçok programlama dili ile MySQL, PostgreSQL, MongoDB, Redis gibi veritabanlarını entegre bir şekilde sunar. Sadece yerel kod projelerini barındırmakla kalmaz, aynı zamanda güçlü bir ters proxy özelliği de sağlar. Ters proxy sayesinde, intranet, sanal makine, konteyner veya uzak sunuculardaki web sitelerini kolayca yerel ServBay ortamınıza yönlendirebilir, geliştirme, hata ayıklama ve erişimi çok daha verimli hale getirebilirsiniz.

Bu makalede, ServBay'de ters proxy nasıl kurulur adım adım anlatılacak, dahili ağ veya diğer erişilebilen adreslerdeki web sitelerinin yerel ortama nasıl yönlendirileceği detaylı olarak açıklanacaktır.

Genel Bakış

Bir ters proxy sunucusu, istemciden (ör. tarayıcınızdan) gelen istekleri alır ve bunları bir veya daha fazla arka uç sunucuya (bu durumda proxy yapmak istediğiniz dahili ağ veya uzak web sitelerine) iletir. ServBay, gömülü olarak gelen Caddy veya Nginx web sunucusu aracılığıyla bu işlevi sağlar.

Yerel geliştirme ortamında ters proxy kurmanın başlıca avantajları şunlardır:

• Tek Erişim Noktası: Tüm iç veya dış kaynaklara, yerel ServBay alan adı üzerinden erişebilirsiniz; karmaşık IP ve portları hatırlamaya gerek yoktur.
• SSL Yapılandırmasının Kolaylaştırılması: ServBay'in SSL yönetim özelliklerini (ServBay CA veya ACME gibi) kullanarak proxy yapılan web sitelerine HTTPS erişimi sağlayabilirsiniz; arka uç site yalnızca HTTP destekliyor olsa bile.
• Yerelde Hata Ayıklama: Uzak veya dahili ağdaki web uygulamalarını kendi tarayıcınızda kolayca debug edebilirsiniz.
• Ağ Sınırlamalarını Aşma: Bazı durumlarda, yerel çalışma ortamınızdan şirket intraneti veya kısıtlı ağ kaynaklarına erişiminizi kolaylaştırır (makinenizin hedef adrese ulaşabiliyor olması gerekir).

Ön Koşullar

Ters proxy kurulumuna başlamadan önce aşağıdaki koşulların sağlandığından emin olun:

1. ServBay Kurulmuş ve Çalışıyor: ServBay uygulamasının macOS sisteminizde doğru şekilde kurulduğundan ve çalıştığından emin olun.
2. Hedef Web Sitesine Erişim: Proxy yapmak istediğiniz dahili ağ veya uzak web sitesi çalışır durumda olmalı ve ServBay'i çalıştıran macOS bilgisayarınızın bu siteye IP/ad, port üzerinden doğrudan ulaşabildiğinden emin olun. Örneğin, hedefiniz 192.168.1.100:8080 ise, macOS'inizden 192.168.1.100'e ping atıp 192.168.1.100:8080'e erişebilmelisiniz.

Ters Proxy Sitesi Eklemek için Adımlar

Aşağıda, ServBay'de bir ters proxy web sitesi yapılandırmak için detaylı adımlar verilmiştir:

Adım 1: ServBay Yönetim Arayüzünü Açın

macOS uygulamaları klasörünüzdeki ServBay simgesini bulun ve çift tıklayarak uygulamayı başlatın.

Adım 2: Site Yönetimi'ne Gidin

ServBay başlatıldığında ana arayüzü göreceksiniz. Sol navigasyon menüsünden Web Siteleri seçeneğine tıklayın. Bu sizi, tüm yerel barındırılan ve ters proxy ile yönlendirilen siteleri yönetebileceğiniz site yönetimi sayfasına getirir.

Adım 3: Yeni Site Ekle

Site yönetimi sayfasının alt kısmında, + butonunu bulup tıklayın. Tıklayınca, sağ tarafta yeni bir form açılır; buradan yeni siteyi yapılandıracaksınız.

Adım 4: Site Ters Proxy Ayarlarını Yapılandırın

Yeni site formunda, ters proxy davranışını belirleyecek temel bilgileri doldurmanız gerekir:

1. Ad (Name): Ters proxy siteniz için kolayca tanıyabileceğiniz bir isim belirleyin. Örn: Internal Backend Proxy.
2. Alan Adı (Domain): Proxy ile yönlendirilen web sitesine yerelde hangi alan adıyla ulaşmak istediğinizi girin. Örn: backend.servbay.demo veya proxy.to.local. ServBay, genellikle burada yazdığınız yerel geliştirme alan adını sistemin hosts dosyasına otomatik olarak ekler ve 127.0.0.1 ya da ::1'e yönlendirir.
3. Protokol (Protocol): Sitenizin desteklediği protokolü seçin. Genellikle HTTP/HTTPS seçilir ve böylece her iki protokol de desteklenir. ServBay, yapılandırmaya göre SSL süreçlerini otomatik yönetir.
4. SSL Sertifika Talep Yöntemi (SSL Certificate Request Method):
   • ServBay CA (Yerelde Geliştirme için Tavsiye Edilir): ServBay, yerleşik sertifika otoritesi (CA) ile alan adınız için otomatik olarak SSL sertifikası oluşturur ve yönetir. Bu oldukça pratiktir ancak tarayıcı veya sistemde ilgili CA root sertifikasının güvenilir olarak eklenmesi gerekir.
   • ACME (Let's Encrypt): Alan adınız herkese açık ve internete erişebilir ise, Let's Encrypt üzerinden ücretsiz SSL sertifikası başvurusu için bu seçeneği seçin.
   • Manuel (El ile): Elinizde mevcut bir SSL sertifikası (.crt, .key, .ca-bundle) varsa, bu seçeneği seçerek manuel olarak yükleyip yapılandırabilirsiniz. Yerel geliştirme ve intranet kaynaklarını proxy yapmak için genelde ServBay CA seçmeniz önerilir.
5. Site Türü (Website Type): Ters Proxy (Reverse Proxy) seçin. Bu, proxy fonksiyonunu etkinleştirir.
6. Proxy Hedefi (Proxy Target): Proxy yapmak istediğiniz dahili ağ veya uzaktaki web sitesinin tam adresini girin. IP:Port formatında veya protokollü tam URL olabilir.
   • Örnek 1 (IP:Port): 192.168.1.100:8080
   • Örnek 2 (protokollü URL): http://192.168.1.100:8080
   • Örnek 3 (intranet hostname): backend.internal:8443 (ServBay bilgisayarı bu adı çözebiliyor olmalı)
   • Örnek 4 (uzak URL): https://api.example.com Buradaki adresin ServBay çalıştırılan makineden doğrudan erişilebilir olması gerekir.

Adım 5: Yapılandırmayı Tamamla ve Kaydet

Tüm gerekli bilgileri doldurduktan sonra, formun altındaki Ekle (Add) butonuna tıklayın. ServBay, yapılandırmanızı otomatik olarak kaydedecek ve ilgili web sunucusunda (Caddy veya Nginx) gerekli ters proxy kurallarını oluşturacaktır.

Başarıyla kaydettikten sonra, yeni ters proxy siteniz site listesinde görünecektir.

Adım 6: Ters Proxy Sitesine Erişim

Kurulum tamamlandıktan sonra, tarayıcınızda adım 4'te belirlediğiniz alan adını (proxy.to.local veya backend.servbay.demo gibi) yazarak proxy ile yönlendirilen dahili ağ veya uzak web sitesine erişebilirsiniz.

ServBay CA ve HTTPS tercih ettiyseniz, ilk erişimde (CA henüz güvenilmedi ise) tarayıcıda bir sertifika uyarısı alabilirsiniz.

Adım 7: Site Hızlı İşlemleri

ServBay, her site için pratik hızlı işlem butonları sunar:

1. IDE ile Site Ana Dizini Aç: Ters proxy siteleri için genellikle gerek yoktur çünkü yerel kök dizini yoktur.
2. Tarayıcıda Siteyi Aç: Belirlediğiniz siteyi varsayılan tarayıcınızda hızlıca açabilirsiniz.
3. Site Loglarını Görüntüle: ServBay'in web sunucusunun (Caddy/Nginx) bu site için oluşturduğu erişim ve hata loglarını görüntüleyin. Hata ayıklama için son derece faydalıdır.
4. Siteyi Durdur/Aktifleştir: Ters proxy yapılandırmasını geçici olarak etkinleştirip devre dışı bırakabilirsiniz.
5. Siteyi Sil: Bu ters proxy yapılandırmasını ServBay'den tamamen kaldırabilirsiniz.

Sıkça Sorulan Sorular ve Çözümleri (SSS)

S: Siteye erişilemiyor, tarayıcı hata gösteriyor.

• ServBay Durumunu Kontrol Edin: ServBay uygulamasının çalıştığından ve web sunucusunun (Caddy/Nginx) aktif olduğundan emin olun.
• Alan Adı Çözümlemesini Kontrol Edin: Tarayıcıda girilen alan adının doğru olup, yerel ServBay IP'sine (genellikle hosts dosyasında otomatik yapılır) yönlendiğinden emin olun.
• ServBay Site Loglarını İnceleyin: Site listesindeki “Logları Görüntüle” butonuna tıklayın ve ServBay web sunucusu loglarını kontrol edin. Burada istemci istek detayları, proxy hedefine bağlantı girişimleri ve hata mesajları olacaktır; sorunun kaynağını tespit etmek için en doğrudan yöntemdir.
• Güvenlik Duvarı/Antivirüs Yazılımını Kontrol Edin: macOS güvenlik duvarının veya başka yazılımın ServBay'in 80 veya 443 portunu dinlemesini ya da proxy hedefine bağlanmasını engellemediğinden emin olun.

S: ServBay makinesi proxy hedefini görebiliyor ama tarayıcıdan alan adı ile girince hata alıyorum.

• Proxy Hedefi Formatını Kontrol Edin: ServBay'de yapılandırılan “Proxy Target” adresinin formatının doğru olduğundan ve makinenin bu adrese doğrudan erişebildiğinden emin olun. Terminalde curl [proxy hedef adresi] komutuyla test edebilirsiniz.
• Hedef Sunucu Yapılandırmasını Kontrol Edin: Bazı back-end sunucular Host başlığına bakar. ServBay, genellikle istemciden gelen orijinal Host başlığını hedefe iletir. Eğer backend sunucunuz özel bir Host başlığı bekliyorsa ve siz farklı bir alan adıyla erişiyorsanız sorun oluşabilir. Gelişmiş ServBay ayarlarında iletilen başlıklar üzerinde değişiklik yapabilirsiniz (gerektiğinde Caddyfile veya Nginx konfigürasyonunu elle düzenlemek gerekebilir).
• Hedef Sunucu Güvenlik Duvarını Kontrol Edin: ServBay makineniz hedef IP ve porta erişebilse bile, sunucunun güvenlik duvarı bazı IP aralıklarından gelen bağlantıları engelliyor olabilir. ServBay bilgisayarının IP'sinden bağlantıya izin verildiğinden emin olun.

S: HTTPS ile proxy siteye girerken sertifika uyarısı çıkıyor.

• ServBay CA Kullanıldıysa: Bu beklenen bir durumdur; çünkü ServBay CA, halka açık tarayıcılar tarafından otomatik güvenilen bir CA değildir. İşletim sistemi veya tarayıcıda ServBay CA root sertifikasını manuel olarak güvenilir olarak eklemeniz gerekir. “Ayarlar” bölümünden root sertifikayı yükleyebilirsiniz.
• ACME (Let's Encrypt) Kullanıldıysa: Alan adınızın ServBay makinesinin IP adresine düzgün şekilde çözümlendiğinden, ACME sertifika başvurusunun ServBay'ın SSL yönetim platformu üzerinden başarıyla yapılabildiğinden emin olun. Hatalar için ServBay loglarını inceleyin.

S: Belirli başlık veya cookie gerektiren hedeflere nasıl proxy yaparım?

ServBay'in temel ters proxy ayarları, çoğu istemci istek bilgisini iletir. Daha karmaşık senaryolar (özelleştirilmiş başlık ekleme, yanıt başlığında değişiklik, özel cookie işlemleri veya path rewrite gibi) gerekiyorsa, ServBay'in gelişmiş ayarlar bölümünden doğrudan Caddyfile veya Nginx yapılandırma dosyalarını elle düzenlemeniz gerekebilir. Bu kısım, Caddy veya Nginx konfigürasyonu hakkında temel bilgi gerektirir.

Özet

ServBay'in ters proxy özelliği sayesinde, intranet, sanal makine, konteyner veya uzaktaki sunuculardaki web sitelerini kolayca yerel geliştirme ortamınıza entegre edebilirsiniz. Bu sadece tek ve kolay bir erişim noktası sağlamakla kalmaz; aynı zamanda yerel hata ayıklama ve SSL kurulumu süreçlerinizi basitleştirir. Bu makaledeki adımları izleyerek ters proxy web sitesi kurulumunu hızla gerçekleştirebilir ve kullanmaya başlayabilirsiniz. ServBay'in güçlü log analiz özellikleri ve sorun giderme tavsiyeleriyle, proxy ile yönlendirilen web sitelerinizin kararlılığını sağlayabilir ve geliştirme verimliliğinizi artırabilirsiniz.