YEREL GELİŞTİRME · GERÇEK CİHAZDA TEST
Localhost paylaşın: telefonda deneyin, webhook alın
Siteniz bilgisayarınızda çalışır. Telefonunuza, müşterinize veya webhook hizmetine geçici bir HTTPS bağlantısıyla erişim verin. Dağıtım yapmanız gerekmez.
Paylaşmadan önce yerel adresi kontrol edin
Geliştirme sunucusunun gösterdiği adrese bakın. Protokol ve port önemlidir: http://localhost:5173 ile https://localhost:7143 farklı hedeflerdir. Tüneli oluşturmadan önce tam adresi bilgisayarda açıp tipik bir işlem yapın.
Bir uygulama, bir port
Sayfa ve API aynı yerel adresi kullanıyorsa tek tünel ikisine de ulaşır. Yollar korunur: /contact için gelen açık istek yerel uygulamada /contact yoluna gider. Tünel dosyalarınızı kopyalamaz veya dağıtmaz.
Frontend ve API farklı portlardaysa
Frontend tüneli başka porttaki API’yi otomatik yayımlamaz. localhost:3000 çağrısı yapan tarayıcı ziyaretçinin kendi cihazına ulaşır. Geliştirme sunucusunun API proxy’sini veya erişilebilir bir API test adresini kullanıp frontend’i buna göre ayarlayın.
Açık adresi bilgisayarınızda ve başka cihazda açın. Yerel sayfa çalışıp açık sayfa çalışmıyorsa iki adresi karşılaştırın; böylece uygulama hatasını tünel veya ana makine ayarı sorunundan ayırabilirsiniz.
Localhost’u telefonunuzda açın
Telefonda localhost, bilgisayarınızı değil telefonun kendisini belirtir. Herkese açık bağlantıyı açın veya GhostlyShare’deki QR kodunu tarayın.
- Wi-Fi dışından erişimi kontrol etmek için mobil veriye geçin.
- Menüyü, formları, klavyeyi ve dosya yüklemeyi gerçek cihazda deneyin.
- Bir alt sayfayı doğrudan açıp yenileyin. Görselleri ve API yanıtlarını da kontrol edin.
Yalnızca aynı Wi-Fi ağında mı test ediyorsunuz? Geliştirme sunucusu ve güvenlik duvarı izin veriyorsa bilgisayarın yerel ağ adresi yeterli olabilir. Herkese açık tünel, diğer ağlardan ve dış hizmetlerden erişim sağlar.

Beş dakikalık yararlı bir telefon testi
- Gezinme ve sayfa düzeni
- Menüyü açın, telefonu döndürün ve uzun bir sayfaya bakın. Yatay kaydırma, örtülmüş düğmeler ve sabit başlığın gizlediği içerikleri arayın. Tarayıcı emülasyonu yararlıdır ama gerçek cihazdaki her etkileşimi yansıtmaz.
- Formlar ve oturum
- Her alana dokunun; önce geçersiz, sonra geçerli değer gönderin. Hataların klavyenin üstünde göründüğünü kontrol edin. Giriş yalnızca bilgisayarda çalışıyorsa yeni oturum deneyin, callback ve çerez ayarlarını inceleyin.
- İstekler ve yükleme
- Görsel ağırlıklı bir sayfayı ve veri yükleyen bir işlemi deneyin. Ev bağlantısı üzerinden yavaş yanıt, üretim ortamının performans ölçümü değildir. Hatayı yerelde tekrarlamak için sayfayı, cihazı ve işlemi kaydedin.
Çalışmanızı müşteriye gösterin
İncelenecek sayfanın tam bağlantısını gönderin. Nelerin denenmesini istediğinizi ve önizlemenin ne zaman kapanacağını belirtin.
Göndermeden önce
Test hesabı ve örnek içerik kullanın. Bağlantının kendi çerezleriniz veya açık oturumunuz olmadan çalıştığını kontrol edin.
Belirli bir kontrol isteyin
İletişim formunu doldurmak, mobil menüyü incelemek veya test ödemesiyle sipariş vermek: net bir görev daha yararlı geri bildirim sağlar.
Bugünkü görüşme için önizleme burada. Lütfen mobil menüyü ve iletişim formunu kontrol edin. Görüşmemizden sonra bağlantı kapanacak.
Geri bildirimi yeniden üretilebilir hale getirin
Sayfa adresini, cihazı, tarayıcıyı ve sorundan önceki son işlemi sorun. “X bekliyordum ama Y oldu” açıklamalı ekran görüntüsü, “sayfa bozuk”tan daha yararlıdır. İnceleme sırasında uygulamayı değiştiriyorsanız haber verin: ayarlara bağlı olarak ziyaretçiler değişikliği veya yenilemeyi hemen görebilir.
Yerelde webhook alın
Bir webhook hizmeti bilgisayarınızdaki localhost’a erişemez. Hizmete callback yoluyla birlikte tünelin açık adresini verin. Bu örnek, uygulamanın /api/webhooks/demo üzerinde POST isteklerini zaten işlediğini varsayar.
http://localhost:5173/api/webhooks/demohttps://YOUR-TUNNEL.trycloudflare.com/api/webhooks/demo- YOUR-TUNNEL yerine gerçek ana makine adınızı yazın ve tam callback adresini sağlayıcının test ayarlarına girin.
- İmza doğrulamasını açık tutun. Webhook sırrını yerelde saklayın ve sağlayıcıdan bir test olayı gönderin.
- Teslim durumunu ve yerel günlükleri kontrol edin. Sağlayıcının beklediği başarı yanıtını verin; tekrar denemelerde işlemi iki kez yapmayın.
Tarayıcıdaki parola istemi webhook gönderen hizmeti engelleyebilir. Sağlayıcının erişebildiği bir uç nokta kullanın ve imzalı isteklerini doğrulayın. CORS, tarayıcı istekleri içindir; sunucular arası webhook teslimlerine uygulanmaz.
Yalnızca tarayıcıyı değil webhook yanıtını kontrol edin
Callback adresini tarayıcıda açmak genellikle GET gönderir. Birçok webhook uç noktası POST bekler; tarayıcı hatası teslimin bozuk olduğunu kanıtlamaz. Sağlayıcının test olayını gönderip zaman ve teslim kimliğini yerel günlükle karşılaştırın.
- 404 / 405
- Yolu ve HTTP yöntemini kontrol edin. Otomatik olarak frontend portunu değil API portunu kullanın. Ana sayfanın açılması callback uç noktasının var olduğunu göstermez.
- 401 / 403
- İsteği kimin reddettiğini bulun: önizleme parolası, uygulama kimlik doğrulaması veya imza kontrolü. İmzalı verilerde özgün istek gövdesi için sağlayıcı kurallarına uyun; doğrulamadan önce ayrıştırıp yeniden yazmak imzayı geçersiz kılabilir.
- 5xx / Timeout
- Uygulamanın çalıştığını ve isteği aldığını kontrol edin. Uzun işlemlerde sağlayıcının yanıt süresine uyun ve gerektiğinde arka plan işleri kullanın. Yinelenen sipariş veya mesaj oluşmaması için tekrar teslimi test edin.
Sağlayıcının test modunu kullanın; sırları veya tam kişisel verileri günlüklere yazmayın. Başarılı test teslimi ve uygulamanın işlemesini doğrular; sağlayıcının entegrasyon gerekliliklerinin yerini almaz.
Bağlantı açılıyor ama bir şeyler çalışmıyor mu?
Açık bağlantı uygulamaya ulaşamıyor
Önce yerel adresi açın. Portu, HTTP veya HTTPS kullanımını ve uygulamayla tünelin çalışıp çalışmadığını kontrol edin.
Görseller veya API çağrıları çalışmıyor
Koda sabit yazılmış localhost adreslerini arayın. Mümkünse göreli yollar kullanın. Ayrı porttaki API için ayrı bir erişilebilir yol gerekir.
Uygulama localhost’a yönlendiriyor
Açık temel adresi, güvenilir proxy ayarlarını ve giriş callback’lerini kontrol edin. Ana makine kontrollerini tümüyle kapatmak yerine gerçek önizleme sunucusuna izin verin.
Canlı yenileme veya WebSockets çalışmıyor
WebSockets bağlantılarının açık ana makineyi ve HTTPS sayfalarda wss kullandığını kontrol edin. Bazı geliştirme sunucuları ayrı HMR ana makinesi ayarı ister.
Webhook başarı yanıtı almıyor
Callback yolunu, HTTP yöntemini, imza sırrını ve teslim günlüğünü kontrol edin. Yeni geçici tünel başlattığınızda callback adresini güncelleyin.
Testi bitirin ve paylaşımı durdurun
GhostlyShare’de paylaşımı veya terminalde Ctrl+C ile tüneli durdurun. Bitiş süresi, planlanan önizlemeyi otomatik kapatabilir. İşiniz bitince sağlayıcıdaki geçici callback adreslerini de kaldırın.
Sürekli kullanım için sabit adres mi gerekiyor?
Geçici önizleme bir dağıtım değildir. Evden barındırma rehberimiz adlandırılmış tünelleri, alan adlarını, Windows hizmetlerini ve işletim maliyetlerini açıklar.
Kalıcı Cloudflare Tunnel kurun →Yerel önizlemeler hakkında sorular
SSS
Localhost neden telefonumda çalışmıyor?
Localhost, adresi açan cihazı belirtir. Bilgisayardaki uygulamaya telefondan ulaşmak için herkese açık önizleme bağlantısını kullanın.
Bilgisayarım açık kalmalı mı?
Evet. Bilgisayar, yerel uygulama ve tünel çalışmaya devam etmelidir. Uyku modu veya tünelin durması önizlemeyi erişilemez yapar.
Önizleme için alan adı gerekir mi?
Hayır. Geçici tünel açık bir HTTPS adresi sağlar. Adres değişirse paylaşılan bağlantıları ve webhook ayarlarını güncelleyin.
