Başlıklar, yol yeniden yazma ve HTTP seçenekleri
Bu sayfada 11 bölüm
- Başlamadan önce
- HTTP başlıkları
- Başlık ekleme
- Başlık türünü seçin
- Başlığı ekleyin
- Kaydedin
- Hazır setler
- Önerilen başlıklar
- Kurallar
- Host başlığı
- Yolu yeniden yazma
- Yolu Yeniden Yaz? ayarını Evet yapın
- Eklenecek yolu girin
- Kaydedin
- HTTP Zaman Aşımı
- Yalnızca HTTPS mi?
- HTTP/3 Aktif mi?
- Örnekler
- Başka bir sitedeki web uygulamasının API'nizi çağırmasına izin verme
- Bir alt yolda çalışan uygulamayı yayımlama
- Aynı ayarlar API ile
- Sorun giderme
- İ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.
| Ayar | HTTP | MCP Ağ Geçidi |
|---|---|---|
| Başlıklar | Evet | – |
| Yolu Yeniden Yaz? | Evet | – |
| HTTP Zaman Aşımı | Evet | Evet |
| Yalnızca HTTPS mi? | Evet | Evet |
| HTTP/3 Aktif mi? | Evet | Evet |
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 #
-
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.
-
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.
-
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.
| Set | Eklediği başlıklar | Ne için kullanılır |
|---|---|---|
| CORS'a izin ver |
| Başka sitelerdeki web uygulamalarının bu tüneli çağırmasına izin verir. |
| Güvenlik başlıkları |
| HSTS, nosniff, çerçeve koruması ve yönlendiren politikası. |
| Önbelleği kapat | Cache-Control: no-store | Tarayıcıların ve proxy'lerin yanıtları önbelleğe almasını önler. |
| Arama motorlarından gizle | X-Robots-Tag: noindex, nofollow | Arama motorlarından bu adresi listelememelerini ister. |
Önerilen başlıklar #
| Başlık | Tür | Pencerenin bu konuda söyledikleri |
|---|---|---|
Host | İstek | Hizmetiniz, 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 | İstek | Her istekle aynı kimlik bilgilerini hizmetinize gönderir. |
X-API-Key | İstek | Başlıkta bir anahtar bekleyen hizmetler için sabit bir anahtar. |
X-Forwarded-Proto | İstek | Uygulamanıza ziyaretçilerin HTTPS kullandığını bildirir; böylece uygulama https:// bağlantıları ve yönlendirmeleri oluşturur. |
Origin | İstek | Bazı hizmetler yalnızca bilinen bir kaynaktan gelen istekleri kabul eder. |
Access-Control-Allow-Origin | Yanıt | Hangi web sitelerinin bu tüneli tarayıcıdan çağırabileceği. * her siteye izin verir. |
Access-Control-Allow-Credentials | Yanıt | Tarayıcıların çerez göndermesine izin verir. Access-Control-Allow-Origin: * ile birlikte çalışmaz. |
Strict-Transport-Security | Yanıt | Tarayıcılara bu adres için her zaman HTTPS kullanmalarını söyler. |
X-Frame-Options | Yanıt | Diğer sitelerin sayfalarınızı bir çerçeve içinde göstermesini engeller. |
Content-Security-Policy | Yanıt | Sayfaların betikleri, stilleri ve görselleri nereden yükleyebileceğini denetler. Katı bir politika sayfaları bozabilir; bu yüzden test edin. |
Cache-Control | Yanıt | no-store, tarayıcıların ve proxy'lerin yanıtları önbelleğe almasını önler. |
X-Robots-Tag | Yanıt | Arama 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.
-
Yolu Yeniden Yaz? ayarını Evet yapın #
Yolu yeniden yaz penceresi açılır.
-
Eklenecek yolu girin #
Bunu Eklenecek yol alanına yazın, örneğin
/apiveya/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. -
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.
| Öğe | Değerler |
|---|---|
| Zaman aşımı | 1 ile 600 saniye arasında bir tam sayı. Sunucu varsayılanı için boş bırakın. |
| Hazır ayarlar | Sunucu 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.