Header, penulisan ulang path, dan opsi HTTP
Di halaman ini 11 bagian
- Sebelum memulai
- Header HTTP
- Menambahkan header
- Pilih jenis header
- Tambahkan header
- Simpan
- Set siap pakai
- Header yang disarankan
- Aturan
- Header Host
- Tulis ulang path
- Ubah Tulis Ulang Path? ke Ya
- Masukkan path yang ditambahkan
- Simpan
- Timeout HTTP
- Hanya HTTPS?
- HTTP/3 Aktif?
- Contoh
- Mengizinkan aplikasi web di situs lain memanggil API Anda
- Memublikasikan aplikasi yang berada di sub-path
- Pengaturan yang sama melalui API
- Pemecahan masalah
- Halaman terkait
Ubah cara permintaan dan respons HTTP melewati tunnel: tambahkan header tetap, atur header Host yang diterima layanan Anda, tambahkan path di depan setiap permintaan, atur timeout permintaan, dan pilih hanya HTTPS atau HTTP/3 untuk alamat publik.
Sebelum memulai #
- Tunnel HTTP. Lihat HTTP / HTTPS.
- Pengaturannya ada di panel pengaturan tunnel: buka Tunnel Saya › HTTP dan pilih Pengaturan di baris tunnel.
| Pengaturan | HTTP | MCP Gateway |
|---|---|---|
| Header | Ya | – |
| Tulis Ulang Path? | Ya | – |
| Timeout HTTP | Ya | Ya |
| Hanya HTTPS? | Ya | Ya |
| HTTP/3 Aktif? | Ya | Ya |
Tidak satu pun dari pengaturan ini memulai ulang tunnel. Perubahan diterapkan pada tunnel yang sedang berjalan segera setelah Anda menyimpannya.
Header HTTP #
Header › Kelola membuka dialog Header HTTP. Dialog ini menambahkan header tetap ke lalu lintas yang melewati tunnel:
- Header permintaan sampai ke layanan lokal Anda pada setiap permintaan.
- Header respons sampai ke pengunjung pada setiap respons.
Nilai dikirim persis seperti yang Anda ketik.
Menambahkan header #
-
Pilih jenis header #
Pilih Header permintaan atau Header respons di bagian atas dialog. Setiap tab menunjukkan jumlah header yang dimilikinya.
-
Tambahkan header #
Pilih Tambah header dan isi Nama dan Nilai, atau pilih sebuah nama di bawah Saran untuk mendapatkan baris dengan nilai awal yang masuk akal. Untuk header yang dikenal dialog, ikon informasi di baris menjelaskan fungsinya.
-
Simpan #
Pilih Simpan. Untuk menghapus header, pilih tombol hapus di barisnya, lalu Simpan.
Set siap pakai #
Di tab Header respons, Set siap pakai menambahkan sekelompok header sekaligus. Dialog kemudian menampilkan "NAME ditambahkan. Periksa nilainya, lalu simpan." Sebuah set mengisi header yang sudah ada di daftar hanya jika nilainya kosong.
| Set | Header yang ditambahkan | Gunakan untuk |
|---|---|---|
| Izinkan CORS |
| Memungkinkan aplikasi web di situs lain memanggil tunnel ini. |
| Header keamanan |
| HSTS, nosniff, perlindungan frame, dan kebijakan referrer. |
| Matikan caching | Cache-Control: no-store | Mencegah browser dan proxy menyimpan respons dalam cache. |
| Sembunyikan dari mesin pencari | X-Robots-Tag: noindex, nofollow | Meminta mesin pencari agar tidak mencantumkan alamat ini. |
Header yang disarankan #
| Header | Tipe | Yang dikatakan dialog tentangnya |
|---|---|---|
Host | Permintaan | Layanan Anda menerima nama host ini, bukan alamat tunnel. Berguna saat web server lokal memilih situs berdasarkan nama host. |
Authorization | Permintaan | Mengirim kredensial yang sama ke layanan Anda pada setiap permintaan. |
X-API-Key | Permintaan | Kunci tetap untuk layanan yang mengharapkannya di header. |
X-Forwarded-Proto | Permintaan | Memberi tahu aplikasi Anda bahwa pengunjung menggunakan HTTPS, sehingga aplikasi membuat tautan dan pengalihan https://. |
Origin | Permintaan | Sebagian layanan hanya menerima permintaan dari origin yang dikenal. |
Access-Control-Allow-Origin | Respons | Situs web mana yang boleh memanggil tunnel ini dari browser. * mengizinkan situs mana pun. |
Access-Control-Allow-Credentials | Respons | Memungkinkan browser mengirim cookie. Tidak berfungsi bersama Access-Control-Allow-Origin: *. |
Strict-Transport-Security | Respons | Memberi tahu browser agar selalu memakai HTTPS untuk alamat ini. |
X-Frame-Options | Respons | Mencegah situs lain menampilkan halaman Anda dalam frame. |
Content-Security-Policy | Respons | Mengatur dari mana halaman boleh memuat skrip, gaya, dan gambar. Kebijakan yang ketat dapat merusak halaman, jadi ujilah. |
Cache-Control | Respons | no-store mencegah browser dan proxy menyimpan respons dalam cache. |
X-Robots-Tag | Respons | Meminta mesin pencari agar tidak mencantumkan alamat ini. |
Saran juga mencakup User-Agent, Accept-Language, dan Cache-Control untuk permintaan, serta Access-Control-Allow-Methods, Access-Control-Allow-Headers, X-Content-Type-Options, Referrer-Policy, dan Permissions-Policy untuk respons. Anda juga dapat mengetik nama header lain.
Aturan #
- Nama header dapat memakai huruf, angka, dan tanda hubung, misalnya
X-Api-Key, dan panjangnya hingga 256 karakter. - Sebuah nama hanya boleh muncul sekali per tab. Baris kedua dengan nama yang sama ditolak dengan "NAME sudah ada di daftar ini."
- Setiap baris memerlukan nama. Baris kosong diabaikan saat Anda menyimpan.
Header Host #
Secara default, layanan Anda menerima alamat tunnel sebagai nama host permintaan. Untuk mengirim nama host lain, tambahkan header permintaan Host di dialog Header HTTP dan atur nilainya ke nama yang diharapkan layanan Anda, misalnya localhost atau shop.internal.
Gunakan ini saat web server lokal memilih situs berdasarkan nama host, seperti virtual host Apache atau nginx, IIS dengan host binding, atau server pengembangan yang hanya menjawab untuk localhost. Lihat Virtual host untuk contoh lengkap.
Tulis ulang path #
Penulisan ulang path menambahkan path di depan setiap permintaan sebelum sampai ke layanan lokal Anda. Pengunjung tetap memakai alamat yang singkat.
-
Ubah Tulis Ulang Path? ke Ya #
Dialog Tulis ulang path terbuka.
-
Masukkan path yang ditambahkan #
Ketik di Path yang ditambahkan, misalnya
/apiatau/app/v2, atau pilih salah satu dari Path umum. Path diawali garis miring; jika Anda tidak menyertakannya, garis miring ditambahkan untuk Anda. Kotak Contoh menunjukkan hasilnya untuk permintaan contoh. -
Simpan #
Pilih Simpan.
Dengan /api sebagai path:
| Pengunjung membuka | Layanan Anda menerima |
|---|---|
https://<YOUR_TUNNEL_ADDRESS>/orders?id=7 | /api/orders?id=7 |
Sebuah tunnel memiliki satu path, hingga 200 karakter. Path tidak boleh berisi spasi dan tidak boleh hanya /. Untuk menghapusnya, ubah Tulis Ulang Path? ke Tidak dan konfirmasikan Nonaktifkan penulisan ulang path?: path yang tersimpan dihapus dan permintaan sampai ke layanan Anda dengan path aslinya.
Timeout HTTP #
Timeout HTTP › Kelola membuka dialog Timeout permintaan. Timeout adalah lamanya tunnel menunggu layanan Anda menjawab sebuah permintaan. Setelah itu, pengunjung mendapat error timeout.
| Item | Nilai |
|---|---|
| Timeout | Bilangan bulat dari 1 hingga 600 detik. Biarkan kosong untuk default server. |
| Preset | Default server, 30 d, 1 mnt, 2 mnt, 5 mnt, 10 mnt |
Naikkan timeout untuk laporan yang lambat, unggahan besar, atau long polling. Pilih Default server untuk kembali ke nilai standar.
Hanya HTTPS? #
Ubah Hanya HTTPS? ke Ya dan konfirmasikan Aktifkan hanya HTTPS? untuk menyajikan URL publik hanya melalui HTTPS. Gunakan untuk apa pun yang membawa login atau data pribadi, agar tidak ada yang mengakses tunnel melalui HTTP biasa.
HTTP/3 Aktif? #
Ubah HTTP/3 Aktif? ke Ya agar klien dapat mengakses URL publik melalui HTTP/3. Klien yang tidak mendukung HTTP/3 tetap memakai versi HTTP yang lebih lama.
Contoh #
Mengizinkan aplikasi web di situs lain memanggil API Anda #
Front end Anda berjalan di https://app.example.com dan memanggil API di balik tunnel. Buka Header › Kelola, masuk ke Header respons, lalu pilih Izinkan CORS. Ganti * pada Access-Control-Allow-Origin dengan https://app.example.com jika hanya situs itu yang boleh memanggil API, lalu pilih Simpan.
Memublikasikan aplikasi yang berada di sub-path #
Application server Anda menyajikan aplikasi di bawah /app/v2, dan Anda ingin pengunjung membuka alamat tunnel biasa. Aktifkan Tulis Ulang Path? dan masukkan /app/v2. Pengunjung yang membuka /login sampai ke /app/v2/login di layanan Anda.
Pengaturan yang sama melalui API #
Pengaturan ini juga tersedia di bawah /api/v2/tunnels/<TUNNEL_ID>/: headers, host-header, path-rewrite, http-timeout, https-only, dan http3. Lihat API.
Pemecahan masalah #
"Nama header dapat memakai huruf, angka, dan tanda hubung, misalnya X-Api-Key."
Nama berisi karakter yang tidak diizinkan dalam nama header, seperti spasi atau titik dua. Masukkan hanya namanya di Nama dan sisanya di Nilai.
"Tambahkan nama untuk header ini, atau hapus barisnya."
Sebuah baris memiliki nilai tetapi tidak memiliki nama. Isi namanya atau hapus barisnya.
"Masukkan path-nya saja, tanpa http:// dan nama host."
Path yang ditambahkan menerima path seperti /api, bukan URL lengkap.
"Masukkan bilangan bulat dari 1 hingga 600, atau pilih Default server."
Timeout harus antara 1 dan 600 detik. Untuk pekerjaan yang lebih lama, jawab permintaan lebih dulu dan biarkan klien meminta hasilnya nanti.
Header CORS saya tidak berfungsi dengan cookie
Access-Control-Allow-Credentials tidak berfungsi bersama Access-Control-Allow-Origin: *. Atur Access-Control-Allow-Origin ke origin persis dari situs yang memanggil.
Layanan lokal saya memakai HTTPS dan tunnel menampilkan error
Itu bukan masalah header. Aktifkan SslStream?, yang memberi tahu tunnel bahwa layanan lokal Anda sendiri memakai HTTPS. Lihat Referensi pengaturan.