Langsung ke konten
Localtonet Localtonet Dasbor

Header, penulisan ulang path, dan opsi HTTP

Bantuan untuk halaman ini
Di halaman ini 11 bagian
  1. Sebelum memulai
  2. Header HTTP
  3. Menambahkan header
  4. Pilih jenis header
  5. Tambahkan header
  6. Simpan
  7. Set siap pakai
  8. Header yang disarankan
  9. Aturan
  10. Header Host
  11. Tulis ulang path
  12. Ubah Tulis Ulang Path? ke Ya
  13. Masukkan path yang ditambahkan
  14. Simpan
  15. Timeout HTTP
  16. Hanya HTTPS?
  17. HTTP/3 Aktif?
  18. Contoh
  19. Mengizinkan aplikasi web di situs lain memanggil API Anda
  20. Memublikasikan aplikasi yang berada di sub-path
  21. Pengaturan yang sama melalui API
  22. Pemecahan masalah
  23. 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 #

PengaturanHTTPMCP Gateway
HeaderYa–
Tulis Ulang Path?Ya–
Timeout HTTPYaYa
Hanya HTTPS?YaYa
HTTP/3 Aktif?YaYa

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 #

  1. Pilih jenis header #

    Pilih Header permintaan atau Header respons di bagian atas dialog. Setiap tab menunjukkan jumlah header yang dimilikinya.

  2. 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.

  3. 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.

SetHeader yang ditambahkanGunakan untuk
Izinkan CORS
  • Access-Control-Allow-Origin: *
  • Access-Control-Allow-Methods: GET, POST, PUT, PATCH, DELETE, OPTIONS
  • Access-Control-Allow-Headers: Content-Type, Authorization
Memungkinkan aplikasi web di situs lain memanggil tunnel ini.
Header keamanan
  • 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, perlindungan frame, dan kebijakan referrer.
Matikan cachingCache-Control: no-storeMencegah browser dan proxy menyimpan respons dalam cache.
Sembunyikan dari mesin pencariX-Robots-Tag: noindex, nofollowMeminta mesin pencari agar tidak mencantumkan alamat ini.

Header yang disarankan #

HeaderTipeYang dikatakan dialog tentangnya
HostPermintaanLayanan Anda menerima nama host ini, bukan alamat tunnel. Berguna saat web server lokal memilih situs berdasarkan nama host.
AuthorizationPermintaanMengirim kredensial yang sama ke layanan Anda pada setiap permintaan.
X-API-KeyPermintaanKunci tetap untuk layanan yang mengharapkannya di header.
X-Forwarded-ProtoPermintaanMemberi tahu aplikasi Anda bahwa pengunjung menggunakan HTTPS, sehingga aplikasi membuat tautan dan pengalihan https://.
OriginPermintaanSebagian layanan hanya menerima permintaan dari origin yang dikenal.
Access-Control-Allow-OriginResponsSitus web mana yang boleh memanggil tunnel ini dari browser. * mengizinkan situs mana pun.
Access-Control-Allow-CredentialsResponsMemungkinkan browser mengirim cookie. Tidak berfungsi bersama Access-Control-Allow-Origin: *.
Strict-Transport-SecurityResponsMemberi tahu browser agar selalu memakai HTTPS untuk alamat ini.
X-Frame-OptionsResponsMencegah situs lain menampilkan halaman Anda dalam frame.
Content-Security-PolicyResponsMengatur dari mana halaman boleh memuat skrip, gaya, dan gambar. Kebijakan yang ketat dapat merusak halaman, jadi ujilah.
Cache-ControlResponsno-store mencegah browser dan proxy menyimpan respons dalam cache.
X-Robots-TagResponsMeminta 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.

  1. Ubah Tulis Ulang Path? ke Ya #

    Dialog Tulis ulang path terbuka.

  2. Masukkan path yang ditambahkan #

    Ketik di Path yang ditambahkan, misalnya /api atau /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.

  3. Simpan #

    Pilih Simpan.

Dengan /api sebagai path:

Pengunjung membukaLayanan 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.

ItemNilai
TimeoutBilangan bulat dari 1 hingga 600 detik. Biarkan kosong untuk default server.
PresetDefault 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.

Dukungan