İçeriğe geç
Localtonet Localtonet Panel

Başlıklar, yol yeniden yazma ve HTTP seçenekleri

Bu sayfa için yardım al
Bu sayfada 11 bölüm
  1. Başlamadan önce
  2. HTTP başlıkları
  3. Başlık ekleme
  4. Başlık türünü seçin
  5. Başlığı ekleyin
  6. Kaydedin
  7. Hazır setler
  8. Önerilen başlıklar
  9. Kurallar
  10. Host başlığı
  11. Yolu yeniden yazma
  12. Yolu Yeniden Yaz? ayarını Evet yapın
  13. Eklenecek yolu girin
  14. Kaydedin
  15. HTTP Zaman Aşımı
  16. Yalnızca HTTPS mi?
  17. HTTP/3 Aktif mi?
  18. Örnekler
  19. Başka bir sitedeki web uygulamasının API'nizi çağırmasına izin verme
  20. Bir alt yolda çalışan uygulamayı yayımlama
  21. Aynı ayarlar API ile
  22. Sorun giderme
  23. İlgili sayfalar

HTTP isteklerinin ve yanıtlarının bir tünelden nasıl geçtiğini değiştirin: sabit başlıklar ekleyin, hizmetinizin aldığı Host başlığını ayarlayın, her isteğin önüne bir yol ekleyin, istek zaman aşımını belirleyin ve herkese açık adres için yalnızca HTTPS'i veya HTTP/3'ü seçin.

Başlamadan önce #

  • Bir HTTP tüneli. Bkz. HTTP / HTTPS.
  • Ayarlar, tünelin ayarlar panelindedir: Tünellerim › HTTP sayfasını açın ve tünelin satırındaki Ayarlar düğmesini seçin.
AyarHTTPMCP Ağ Geçidi
BaşlıklarEvet–
Yolu Yeniden Yaz?Evet–
HTTP Zaman AşımıEvetEvet
Yalnızca HTTPS mi?EvetEvet
HTTP/3 Aktif mi?EvetEvet

Bu ayarların hiçbiri tüneli yeniden başlatmaz. Değişiklik, kaydettiğiniz anda çalışan tünele uygulanır.

HTTP başlıkları #

Başlıklar › Yönet, HTTP başlıkları penceresini açar. Tünelden geçen trafiğe sabit başlıklar ekler:

  • İstek başlıkları, her istekle birlikte yerel hizmetinize ulaşır.
  • Yanıt başlıkları, her yanıtla birlikte ziyaretçiye ulaşır.

Değerler, yazdığınız gibi aynen gönderilir.

Başlık ekleme #

  1. Başlık türünü seçin #

    Pencerenin üstünden İstek başlıkları veya Yanıt başlıkları sekmesini seçin. Her sekme kaç başlık içerdiğini gösterir.

  2. Başlığı ekleyin #

    Başlık ekle düğmesini seçip Ad ve Değer alanlarını doldurun veya makul bir başlangıç değeri olan bir satır almak için Öneriler altından bir ad seçin. Pencerenin tanıdığı bir başlık için satırdaki bilgi simgesi ne işe yaradığını açıklar.

  3. Kaydedin #

    Kaydet düğmesini seçin. Bir başlığı kaldırmak için satırındaki kaldır düğmesini, ardından Kaydet düğmesini seçin.

Hazır setler #

Yanıt başlıkları sekmesinde Hazır setler, bir başlık grubunu tek adımda ekler. Pencere ardından "NAME eklendi. Değerleri kontrol edip kaydedin." mesajını gösterir. Bir set, listede zaten bulunan bir başlığı yalnızca değeri boşsa doldurur.

SetEklediği başlıklarNe için kullanılır
CORS'a izin ver
  • Access-Control-Allow-Origin: *
  • Access-Control-Allow-Methods: GET, POST, PUT, PATCH, DELETE, OPTIONS
  • Access-Control-Allow-Headers: Content-Type, Authorization
Başka sitelerdeki web uygulamalarının bu tüneli çağırmasına izin verir.
Güvenlik başlıkları
  • Strict-Transport-Security: max-age=31536000; includeSubDomains
  • X-Content-Type-Options: nosniff
  • X-Frame-Options: SAMEORIGIN
  • Referrer-Policy: strict-origin-when-cross-origin
HSTS, nosniff, çerçeve koruması ve yönlendiren politikası.
Önbelleği kapatCache-Control: no-storeTarayıcıların ve proxy'lerin yanıtları önbelleğe almasını önler.
Arama motorlarından gizleX-Robots-Tag: noindex, nofollowArama motorlarından bu adresi listelememelerini ister.

Önerilen başlıklar #

BaşlıkTürPencerenin bu konuda söyledikleri
HostİstekHizmetiniz, tünel adresi yerine bu ana makine adını alır. Yerel bir web sunucusu siteyi ana makine adına göre seçiyorsa kullanışlıdır.
AuthorizationİstekHer istekle aynı kimlik bilgilerini hizmetinize gönderir.
X-API-KeyİstekBaşlıkta bir anahtar bekleyen hizmetler için sabit bir anahtar.
X-Forwarded-ProtoİstekUygulamanıza ziyaretçilerin HTTPS kullandığını bildirir; böylece uygulama https:// bağlantıları ve yönlendirmeleri oluşturur.
OriginİstekBazı hizmetler yalnızca bilinen bir kaynaktan gelen istekleri kabul eder.
Access-Control-Allow-OriginYanıtHangi web sitelerinin bu tüneli tarayıcıdan çağırabileceği. * her siteye izin verir.
Access-Control-Allow-CredentialsYanıtTarayıcıların çerez göndermesine izin verir. Access-Control-Allow-Origin: * ile birlikte çalışmaz.
Strict-Transport-SecurityYanıtTarayıcılara bu adres için her zaman HTTPS kullanmalarını söyler.
X-Frame-OptionsYanıtDiğer sitelerin sayfalarınızı bir çerçeve içinde göstermesini engeller.
Content-Security-PolicyYanıtSayfaların betikleri, stilleri ve görselleri nereden yükleyebileceğini denetler. Katı bir politika sayfaları bozabilir; bu yüzden test edin.
Cache-ControlYanıtno-store, tarayıcıların ve proxy'lerin yanıtları önbelleğe almasını önler.
X-Robots-TagYanıtArama motorlarından bu adresi listelememelerini ister.

Öneriler ayrıca istekler için User-Agent, Accept-Language ve Cache-Control, yanıtlar için Access-Control-Allow-Methods, Access-Control-Allow-Headers, X-Content-Type-Options, Referrer-Policy ve Permissions-Policy başlıklarını da içerir. Başka herhangi bir başlık adını da yazabilirsiniz.

Kurallar #

  • Başlık adları harf, rakam ve tire içerebilir, örneğin X-Api-Key, ve en fazla 256 karakter uzunluğunda olabilir.
  • Bir ad her sekmede bir kez bulunabilir. Aynı adlı ikinci bir satır "NAME bu listede zaten var." mesajıyla reddedilir.
  • Bir satırın adı olmalıdır. Boş bir satır kaydederken yok sayılır.

Host başlığı #

Varsayılan olarak hizmetiniz, bir isteğin ana makine adı olarak tünel adresini alır. Başka bir ana makine adı göndermek için HTTP başlıkları penceresine Host istek başlığını ekleyin ve değerini hizmetinizin beklediği ada, örneğin localhost veya shop.internal olarak ayarlayın.

Bunu, yerel bir web sunucusu siteyi ana makine adına göre seçtiğinde kullanın; örneğin Apache veya nginx sanal ana makinesi, ana makine bağlamaları olan IIS ya da yalnızca localhost için yanıt veren bir geliştirme sunucusu. Tam bir örnek için Sanal ana makineler sayfasına bakın.

Yolu yeniden yazma #

Yol yeniden yazma, her isteğin yerel hizmetinize ulaşmadan önce önüne bir yol ekler. Ziyaretçiler kısa adresi kullanmaya devam eder.

  1. Yolu Yeniden Yaz? ayarını Evet yapın #

    Yolu yeniden yaz penceresi açılır.

  2. Eklenecek yolu girin #

    Bunu Eklenecek yol alanına yazın, örneğin /api veya /app/v2, ya da Yaygın yollar arasından birini seçin. Yol bir eğik çizgiyle başlar; eğik çizgiyi yazmazsanız sizin için eklenir. Örnek kutusu, örnek bir istek için sonucu gösterir.

  3. Kaydedin #

    Kaydet düğmesini seçin.

Yol olarak /api kullanıldığında:

Ziyaretçinin açtığıHizmetinizin aldığı
https://<YOUR_TUNNEL_ADDRESS>/orders?id=7/api/orders?id=7

Bir tünelin tek bir yolu olur ve en fazla 200 karakter uzunluğunda olabilir. Boşluk içeremez ve yalnızca / olamaz. Kaldırmak için Yolu Yeniden Yaz? ayarını Hayır yapın ve Yol yeniden yazma kapatılsın mı? sorusunu onaylayın: kayıtlı yol silinir ve istekler hizmetinize özgün yollarıyla ulaşır.

HTTP Zaman Aşımı #

HTTP Zaman Aşımı › Yönet, İstek zaman aşımı penceresini açar. Zaman aşımı, tünelin hizmetinizin bir isteğe yanıt vermesi için ne kadar bekleyeceğidir. Bu sürenin ardından ziyaretçi bir zaman aşımı hatası alır.

ÖğeDeğerler
Zaman aşımı1 ile 600 saniye arasında bir tam sayı. Sunucu varsayılanı için boş bırakın.
Hazır ayarlarSunucu varsayılanı, 30 sn, 1 dk, 2 dk, 5 dk, 10 dk

Yavaş raporlar, büyük yüklemeler veya uzun yoklama için zaman aşımını artırın. Standart değere dönmek için Sunucu varsayılanı seçeneğini seçin.

Yalnızca HTTPS mi? #

Herkese açık URL'nin yalnızca HTTPS ile sunulması için Yalnızca HTTPS mi? ayarını Evet yapın ve Yalnızca HTTPS açılsın mı? sorusunu onaylayın. Oturum açma veya kişisel veri taşıyan her şey için kullanın; böylece kimse tünele düz HTTP ile ulaşamaz.

HTTP/3 Aktif mi? #

İstemcilerin herkese açık URL'ye HTTP/3 ile ulaşabilmesi için HTTP/3 Aktif mi? ayarını Evet yapın. HTTP/3'ü desteklemeyen istemciler önceki HTTP sürümlerini kullanmaya devam eder.

Örnekler #

Başka bir sitedeki web uygulamasının API'nizi çağırmasına izin verme #

Ön yüzünüz https://app.example.com adresinde çalışıyor ve bir tünelin arkasındaki bir API'yi çağırıyor. Başlıklar › Yönet bölümünü açın, Yanıt başlıkları sekmesine gidin ve CORS'a izin ver düğmesini seçin. API'yi yalnızca o site çağırabilecekse Access-Control-Allow-Origin başlığındaki * değerini https://app.example.com ile değiştirin, ardından Kaydet düğmesini seçin.

Bir alt yolda çalışan uygulamayı yayımlama #

Uygulama sunucunuz uygulamayı /app/v2 altında sunuyor ve ziyaretçilerin yalın tünel adresini açmasını istiyorsunuz. Yolu Yeniden Yaz? ayarını açın ve /app/v2 girin. /login adresini açan bir ziyaretçi, hizmetinizde /app/v2/login adresine ulaşır.

Aynı ayarlar API ile #

Bu ayarlara /api/v2/tunnels/<TUNNEL_ID>/ altından da erişilebilir: headers, host-header, path-rewrite, http-timeout, https-only ve http3. Bkz. API.

Sorun giderme #

"Başlık adları harf, rakam ve tire içerebilir, örneğin X-Api-Key."

Ad, başlık adında izin verilmeyen bir karakter içeriyor; örneğin boşluk veya iki nokta. Ad alanına yalnızca adı, geri kalanını Değer alanına girin.

"Bu başlık için bir ad ekleyin veya satırı kaldırın."

Bir satırın değeri var ama adı yok. Adı doldurun veya satırı kaldırın.

"Yalnızca yolu girin, http:// ve ana makine adı olmadan."

Eklenecek yol alanı, tam bir URL değil, /api gibi bir yol alır.

"1 ile 600 arasında bir tam sayı girin veya Sunucu varsayılanı'nı seçin."

Zaman aşımı 1 ile 600 saniye arasında olmalıdır. Daha uzun süren bir iş için isteğe önce yanıt verin ve istemcinin sonucu daha sonra istemesine izin verin.

CORS başlığım çerezlerle çalışmıyor

Access-Control-Allow-Credentials, Access-Control-Allow-Origin: * ile birlikte çalışmaz. Access-Control-Allow-Origin değerini çağıran sitenin tam kaynağı olarak ayarlayın.

Yerel hizmetim HTTPS kullanıyor ve tünel hata gösteriyor

Bu bir başlık sorunu değildir. Tünele yerel hizmetinizin kendisinin HTTPS kullandığını bildiren Yerel HTTPS (SslStream)? ayarını açın. Bkz. Ayarlar başvurusu.

Bu sayfa için yardıma mı ihtiyacınız var? Topluluğa sorun veya bir destek talebi açın.

Destek