Pratik localhost paylaşım rehberi
Cloudflare ve GhostlyShare ile localhost'u açığa çıkar
Bir müşteri önizleme istediğinde, webhook sağlayıcı geri çağırma URL'si gerektiğinde veya geliştirme sunucunuzu telefonda açmak istediğinizde, hâlâ yerelde çalışan bir şey için genel URL gerekir. Bu rehber önce terminal odaklı Cloudflare yolunu, sonra tekrarlanan paylaşım için GhostlyShare iş akışını gösterir.
Hızlı karar
Paylaşım miktarına uygun aracı kullanın
Hata, her yerel önizlemeyi barındırma gibi görmek. Tünel geçici erişim için en iyisidir. GhostlyShare, bu düzenli bir iş akışına dönüştüğünde en iyisidir. Gerçek dağıtım, kullanıcılar URL'ye bağımlı olduğunda en iyisidir.
cloudflared.exe kullanın
Cloudflare tünel istemcisini bir kez kurun, bir komut çalıştırın, geçici URL'yi kopyalayın, ardından Ctrl+C ile durdurun.
GhostlyShare kullanın
Masaüstü uygulamasının yerel servisleri algılamasına, paylaşımı başlatmasına, hazır olma durumunu göstermesine, URL'yi kopyalamasına ve terminal çıktısında arama yapmadan erişimi durdurmasına izin verin.
Uygulamayı dağıt
URL'nin çalışma süresi, izleme, yedekler, stabil sürümler veya destek sahipliği gerekiyorsa, dizüstü tüneli yanlış güvenilirlik sınırıdır.
Yöntem 1
Cloudflare EXE: en hızlı ve temiz komut satırı akışı
Cloudflare tünel istemcisi cloudflared olarak adlandırılır. Windows'ta winget ile kurabilir veya EXE'yi manuel indirebilirsiniz. Kısa geliştirme önizlemesi için Quick Tunnel, yönlendirici port yönlendirmesi, Cloudflare DNS bölgesi veya özel alan olmadan rastgele HTTPS URL'si sağlar.
Yerel uygulamayı başlat
Yerel URL'yi önce tarayıcınızda açın. Uygulama yerelde çalışmıyorsa, genel tünel bunu düzeltemez.
npm run devWindows'ta cloudflared kurun
Use winget when it is available. If you download the EXE manually, place it in a folder such as C:\Cloudflared\bin and call it cloudflared.exe.
winget install --id Cloudflare.cloudflaredGenel URL oluştur
Use the exact local HTTP URL and port. In PowerShell from the EXE folder, use .\cloudflared.exe if the executable is not on PATH.
cloudflared.exe tunnel --url http://localhost:5173Paylaşmadan önce test et
Oluşturulan trycloudflare.com URL'sini gizli pencerede veya başka bir cihazda açın. Göndermeden önce giriş, varlıklar, yönlendirmeler ve API çağrılarını kontrol edin.
https://example-random-name.trycloudflare.comTüneli kasıtlı olarak durdur
Demo veya webhook testi bittiğinde terminal işlemini durdurun. Makineniz uykuya geçerse veya bağlantı kesilirse, hızlı tünel zaten çalışmayı durdurur.
Ctrl+CStabil önizleme isimleri
Rastgele URL mi yoksa özel Cloudflare ana bilgisayar adı mı?
Bağlantının test sonrası kaybolabileceği durumlarda rastgele URL'ler idealdir. Önizlemenin stabil görünmesi gereken durumlarda, örn. demo.example.com, ve alan adını Cloudflare'da yönetiyorsanız özel alan adları mantıklıdır.
| İhtiyaç | Kullan | Neden uygun |
|---|---|---|
| Beş dakikalık demo veya webhook geri çağrısı | Rastgele URL | Hesap veya DNS çalışması gerekmez, bağlantı test sonrası kolayca atılabilir. |
| Markalı görünmesi gereken müşteri yorumu | Özel alan adı | Kontrol ettiğiniz bir ana bilgisayar adı tanınması daha kolaydır, ancak Cloudflare bölgeniz, token izinleriniz, DNS ve tünel yönlendirmesi gerekir. |
| Rastgele açılmaması gereken önizleme | Parola korumalı bağlantı | Genel erişim öncesi parola ekleyin, ardından URL ve parolayı erişim ihtiyacı olan küçük grupla ayrı paylaşın. |
Diğer seçenekler
Localhost'u açığa çıkarmanın diğer yolları
Her durum için tek bir araca ihtiyacınız yok. En iyi seçim, tek kullanımlık bağlantı, masaüstü iş akışı, markalı önizleme, özel ağ aracı veya kasıtlı olarak güçlendirilmiş kendi kendine barındırma kurulumundan hangisini istediğinize bağlıdır.
| Araç | Tipik komut veya işlem | En uygun | Dikkat edin |
|---|---|---|---|
| Cloudflare Hızlı Tünel | cloudflared tunnel --url http://localhost:5173
|
Yönlendirici değişikliği olmadan hızlı atıp kullanımlık genel HTTPS URL'leri. | Sadece geliştirme ve test; rastgele URL; terminal yaşam döngüsü. |
| GhostlyShare | Masaüstü uygulamasında Genel Erişime Geç'i seçin
|
Tekrarlanan yerel önizlemeler, webhook testleri, parola korumalı demolar ve isteğe bağlı Cloudflare özel alan adları. | Hâlâ üretim barındırma değil; bağlantı çalışırken yerel uygulamanız ve makineniz açık kalmalı. |
| ngrok | ngrok http 5173
|
Zaten ngrok, ayrılmış alan adları, trafik denetimi ve sağlayıcıya özel yönlendirme özellikleri kullanan ekipler. | Hesap ve plan detayları önemlidir; atıp kullanımlık hızlı tünelden daha fazla sağlayıcı kurulumu gerektirir. |
| Tailscale Funnel | tailscale funnel 3000
|
Zaten Tailscale kullanan ve tailnet cihazı için genel HTTPS uç noktası isteyenler. | Tailnet için Tailscale kurulumu ve Funnel etkinleştirmesi gerekir. |
| localtunnel | npx localtunnel --port 3000
|
Basit testler için hızlı Node tabanlı localhost paylaşımı. | Basit önizlemeler için faydalı; hassas bir şey için kullanmadan önce dikkatlice düşünün. |
| Yönlendirici port yönlendirmesi | Yönlendirici, DNS, TLS ve ters proxy yapılandır
|
Altyapıyı kasıtlı olarak işletirken kalıcı kendi kendine barındırma. | Daha fazla açık saldırı yüzeyi; yamalama, güvenlik duvarı kuralları, günlükler ve TLS sizin sorumluluğunuz olur. |
Webhook testi
Webhooklarla zaman kazandıran detaylar
Webhook sağlayıcıları dizüstünüzdeki http://localhost'u arayamaz. Genel tünel URL'sini arayabilirler. Bu URL'yi gerçek bir dış entegrasyon gibi ele alın: imzaları etkin tutun, tam geri çağırma yolunu kullanın ve yönlendirmeleri ile CORS'u kontrol edin.
Tam geri çağırma yolunu kullanın
Alıcınız /api/webhooks/stripe üzerinde dinliyorsa, sadece alan değil, aynı yol ile genel URL'yi yapıştırın.
İmza doğrulamayı etkin tutun
Genel bir tünel gerçek webhook imzalarını test etmeyi kolaylaştırır. Bu, imza doğrulamasını devre dışı bırakmak için bir neden değildir.
Temel URL'leri ve iletilen başlıkları izleyin
Genel URL localhost'a yönlendiriyorsa, genel temel URL'leri, iletilen başlıkları, güvenilen proxy'leri veya framework ana bilgisayar ayarlarını yapılandırın.
Temiz tarayıcı oturumundan test et
Önbelleğe alınmış localhost durumu, çerezler, CORS, yönlendirmeler veya karışık içerik sorunlarını gizlemesin diye gizli pencere veya ikinci cihaz kullanın.
Sorun giderme
Önce yaygın tünel sorunlarını çözün
Tünel başlıyor ama sayfa boş
Yerel URL'yi doğrudan açın, ardından varlıklar, API URL'leri, WebSocket URL'leri veya ortam değişkenlerinin hala localhost'a işaret edip etmediğini kontrol edin.
Genel URL localhost'a yönlendiriyor
Birçok framework yönlendirmeleri istek ana bilgisayarından oluşturur. İletilen başlıkları, güvenilen proxy'leri, genel orijini veya zorunlu geliştirme yönlendirmelerini düzeltin.
Bağlantı çalışmadan önce görünür
Cloudflare yönlendirmesi, DNS, GhostlyShare yerel proxy ve orijinal uygulama kısa bir süre uyum sağlamaya ihtiyaç duyabilir. Birkaç saniye bekleyin, yenileyin ve tekrar test edin.
HTTPS localhost sertifikaları hata oluşturur
Kısa önizlemeler için yerel HTTP uç noktasını tünelleyin. Uzun kurulumlarda tahmin etmek yerine orijin TLS'yi bilinçli yapılandırın.
Sıcak yeniden yükleme veya WebSocket hatası
WebSocket destekleyen bir araç kullanın ve uygulamanın ws veya wss URL'lerini sabit localhost değeri yerine genel ana bilgisayardan oluşturduğundan emin olun.
Güvenlik
Genel URL'yi göndermeden önce
Genel önizleme URL'si hâlâ herkese açıktır. Parola koruması kazara erişimi azaltabilir, ancak riskli yerel servisi güvenli yapmaz. En dar URL'yi paylaşın, test verisi kullanın ve inceleme veya webhook testi sonrası bağlantıyı durdurun.
Test verisi kullanın
Gerçek müşteri kayıtları, veritabanı yönetim ekranları, dahili panolar, gizli anahtarlar veya özel şirket verilerini açığa çıkarmayın.
Uygulama kimlik doğrulamayı etkin tutun
Bir özellik normalde giriş gerektiriyorsa, genel önizlemede de giriş gerektirmelidir.
Özel önizlemeler için parola koruması kullanın
Küçük inceleme grupları için genel erişim öncesi GhostlyShare parolası ekleyin ve bağlantıdan ayrı paylaşın.
Bağlantıları durdur ve yenile
Geçici bağlantıları kullanımdan sonra durdurun. URL veya parola bilet ya da sohbete sızarsa, yeniden kullanmak yerine yeni bir önizleme oluşturun.
SSS
Sıkça Sorulan Sorular
Tam Windows komutu nedir?
cloudflared kurulduktan sonra, cloudflared.exe tunnel --url http://localhost:PORT komutunu çalıştırın; PORT'u uygulamanızın yerel portu ile değiştirin, örn. 5173, 3000, 5080 veya 8080.
GhostlyShare sadece cloudflared için bir sarmalayıcı mı?
Hayır. GhostlyShare Cloudflare destekli tüneller kullanır, ancak uygulama algılama, rastgele veya özel genel bağlantılar, hazır olma durumu, erişimi durdurma ve isteğe bağlı parola koruması etrafında masaüstü iş akışı ekler.
GhostlyShare genel bağlantıyı parola ile koruyabilir mi?
Evet. Genel erişim öncesi parola korumasını etkinleştirin. Ziyaretçiler, GhostlyShare trafiği seçilen yerel uygulamaya yönlendirmeden önce parolayı girmelidir; ancak bu, uygun uygulama güvenliğinin yerini tutmaz.
Yönlendirici port yönlendirmesi gerekli mi?
Bu rehberdeki tünel iş akışları için hayır. cloudflared, GhostlyShare, ngrok, Tailscale Funnel ve benzeri araçlar makinenizden dışa bağlantı açar, bu yüzden genellikle gelen yönlendirici yönlendirmesine gerek yoktur.
Webhookları yerel tünel üzerinden test edebilir miyim?
Evet. Yerel webhook alıcısını başlatın, tünel üzerinden açığa çıkarın, genel HTTPS URL'sini ve doğru geri çağırma yolunu sağlayıcıya yapıştırın, test etkinliği gönderin ve isteği yerelde inceleyin.
Yönetim araçları veya veritabanlarını açığa çıkarmalı mıyım?
Genellikle hayır. Veritabanı konsolları, yönetim panoları, altyapı panelleri, hata ayıklama uç noktaları veya dahili servisleri, kasıtlı olarak güçlendirilmedikçe ve internetten erişilebilir olmaları amaçlanmadıkça açığa çıkarmayın.
Üretim trafiği için dizüstü tüneli kullanmalı mıyım?
Hayır. Gerçek bir dağıtım veya çevrimiçi kalması, güncellenmesi, izlenmesi ve arızalardan kurtulması amaçlanan yönetilen bir tünel kullanın.