Langsung ke konten
Localtonet Localtonet Dasbor

Membuat tunnel HTTP

Bantuan untuk halaman ini
Di halaman ini 10 bagian
  1. Sebelum memulai
  2. Langkah-langkah
  3. Buka halaman HTTP
  4. Pilih jenis URL
  5. Pilih perangkat dan wilayah
  6. Masukkan alamat lokal
  7. Mulai tunnel
  8. Alamat publik Anda
  9. HTTPS dan sertifikat
  10. Header Host
  11. Pengaturan tunnel HTTP
  12. Contoh
  13. Membagikan aplikasi web
  14. Menerima webhook
  15. Halaman peringatan di paket Gratis
  16. Pemecahan masalah
  17. Halaman terkait

Tunnel HTTP memberi aplikasi web, API, atau penerima webhook di perangkat Anda sebuah alamat HTTPS publik. Localtonet menyediakan sertifikatnya, sehingga layanan lokal Anda tetap bisa memakai HTTP biasa.

Sebelum memulai #

  • Klien Localtonet sudah terpasang di perangkat dan terhubung dengan AuthToken. Jika belum, ikuti Panduan cepat.
  • Layanan web Anda sedang berjalan dan Anda tahu port-nya, misalnya 3000.
  • Untuk Subdomain kustom atau Domain kustom: Saldo di akun Anda. Untuk Domain kustom, Anda juga memerlukan domain yang sudah Anda tambahkan di Manajer DNS. Lihat Domain kustom.

Langkah-langkah #

  1. Buka halaman HTTP #

    Buka Tunnel Saya › HTTP lalu pilih Buat Tunnel HTTP untuk membuka formulir.

  2. Pilih jenis URL #

    Jenis URLAlamat yang Anda dapatkanYang diperlukan
    Subdomain acakNama yang dihasilkan otomatis pada domain yang dipilih, misalnya https://<RANDOM_NAME>.localto.net.Tidak ada tambahan
    Subdomain kustomNama yang Anda ketik di Subdomain, misalnya https://myapp.localto.net. Huruf, angka, dan tanda hubung diperbolehkan.Saldo
    Domain kustomDomain milik Anda sendiri, yang dipilih di Domain.Saldo dan sebuah domain di Manajer DNS
  3. Pilih perangkat dan wilayah #

    Di Token perangkat, pilih token yang dipakai aplikasi Localtonet di perangkat Anda. Di Wilayah server, pilih wilayah yang dekat dengan perangkat Anda agar latensinya lebih rendah.

  4. Masukkan alamat lokal #

    KolomYang dimasukkan
    Domainlocalto.net, atau salah satu domain milik Anda. Untuk Domain kustom, daftar ini hanya berisi domain milik Anda.
    SubdomainHanya untuk Subdomain kustom: nama di depan domain.
    Alamat IP lokalAlamat layanan di perangkat Anda. Gunakan 127.0.0.1 untuk perangkat ini. Formulir menerima alamat IPv4 atau IPv6, atau localhost.
    Port lokalPort yang didengarkan layanan lokal Anda, dari 1 hingga 65535.

    Pilih Buat tunnel. Tunnel muncul di bawah Tunnel Anda sebagai Tunnel # diikuti ID-nya.

  5. Mulai tunnel #

    Pilih tombol mulai di kolom Aksi. Saat tunnel berjalan, alamatnya di kolom URL menjadi tautan. Buka di browser. Permintaan ke alamat itu kini sampai ke layanan di perangkat Anda.

    Jika aplikasi Localtonet milik token tersebut sedang offline, sebuah dialog akan memberi tahu Anda. Jalankan aplikasinya, atau pilih Tetap mulai dan tunnel akan aktif begitu aplikasi terhubung.

Alamat publik Anda #

  • Alamatnya adalah https:// diikuti nama host di kolom URL.
  • Tunnel HTTP mempertahankan subdomain-nya sampai Anda menghapus tunnel tersebut. Menghentikan dan menjalankan ulang tidak mengubahnya.
  • Alamat tidak memiliki nomor port. Pengunjung membukanya seperti situs web lainnya.
  • Koneksi WebSocket dapat melewati tunnel HTTP.

HTTPS dan sertifikat #

Pengunjung mengakses tunnel HTTP melalui HTTPS dengan sertifikat yang disediakan dan diperbarui oleh Localtonet. TLS berakhir di server Localtonet. Dari sana permintaan diteruskan melalui tunnel ke perangkat Anda, lalu aplikasi Localtonet menyampaikannya ke layanan Anda.

PengaturanFungsinyaKapan digunakan
Hanya HTTPS?Menyajikan URL publik hanya melalui HTTPS. Permintaan ke http:// dialihkan ke alamat yang sama di https://. Saat dimatikan, alamat menjawab di keduanya.Aktifkan untuk apa pun yang membawa data login atau data pribadi.
HTTP/3 Aktif?Memungkinkan klien mengakses URL publik melalui HTTP/3. Tunnel baru sudah mengaktifkannya.Matikan hanya jika klien bermasalah dengan HTTP/3.
SslStream?Memberi tahu aplikasi Localtonet agar terhubung ke layanan lokal Anda dengan TLS. Aplikasi menerima sertifikat layanan lokal apa adanya, sehingga sertifikat self-signed pun berfungsi.Aktifkan jika layanan lokal Anda sendiri memakai HTTPS, misalnya server pengembangan di https://localhost:5001.
Koneksi Legacy?Menghubungkan tunnel dengan metode lama, bukan metode normal.Coba ini jika tunnel tidak dapat terhubung dengan metode normal.

Sakelar ini ada di bawah Pengaturan pada panel Pengaturan tunnel. Mengubah SslStream? atau Koneksi Legacy? pada tunnel yang sedang berjalan akan memulai ulang tunnel tersebut, jadi aplikasi Localtonet harus terhubung.

Perlu enkripsi sampai ke layanan Anda sendiri? Pada tunnel HTTP, Localtonet mendekripsi lalu lintas di servernya. Gunakan tunnel TLS jika layanan Anda harus menampilkan sertifikatnya sendiri.

Header Host #

Layanan Anda menerima nama host yang dipakai pengunjung, yaitu alamat tunnel. Beberapa server web lokal memilih situs berdasarkan nama host dan menjawab dengan situs yang salah atau dengan galat. Dalam kasus itu, buka Header di pengaturan tunnel dan tambahkan header permintaan bernama Host dengan nama yang diharapkan server Anda. Layanan Anda kemudian menerima nama host ini, bukan alamat tunnel. Lihat Header dan penulisan ulang serta Virtual host.

Pengaturan tunnel HTTP #

Pilih tombol pengaturan di kolom Aksi untuk membuka panel Pengaturan tunnel. Di bawah Detail Tunnel Anda dapat mengganti nama tunnel serta mengubah alamat IP lokal dan port lokal. Tabel berikut mencantumkan hal lain yang ditawarkan tunnel HTTP dan di mana penjelasannya.

PengaturanFungsinyaSelengkapnya
Load BalanceMembagi lalu lintas ke beberapa perangkat atau memakai target cadangan.Load balancing
Tampilkan Perintah SSHJalankan tunnel ini dengan SSH biasa, tanpa memasang aplikasi Localtonet.SSH tanpa instalasi
Hanya HTTPS?, HTTP/3 Aktif?, SslStream?, Koneksi Legacy?Bagaimana pengunjung dan layanan Anda terhubung.Halaman ini, di atas
Tulis Ulang Path?Mengubah path permintaan sebelum sampai ke layanan lokal Anda.Header dan penulisan ulang
HeaderMengelola header permintaan dan respons HTTP kustom untuk tunnel ini.Header dan penulisan ulang
Timeout HTTPAtur berapa lama server menunggu respons dari aplikasi lokal Anda, dari 1 sampai 600 detik.Header dan penulisan ulang
Basic Auth?Meminta nama pengguna dan kata sandi dari pengunjung.Kontrol akses
Pembatasan IPKendalikan alamat IP klien mana yang dapat mengakses tunnel ini.Kontrol akses
Penyedia SSOPengunjung masuk dengan salah satu penyedia identitas Anda sebelum dapat membuka tunnel. Tombol SSO di bagian atas halaman mengelola penyedianya.Single Sign-On
Tombol WAF di kolom AksiMembuka Pengaturan WAF. Tombol ini menunjukkan apakah Web Application Firewall belum dikonfigurasi, aktif, atau tidak aktif.Web Application Firewall
Tanggal Kedaluwarsa, Batas Kecepatan, Batas Bandwidth, Pemakaian Bandwidth, Trafik BandwidthMenghentikan tunnel pada tanggal tertentu, membatasi kecepatannya, membatasi datanya, mengatur ulang penghitung data, dan melihat trafik dari waktu ke waktu.Batas dan kedaluwarsa
Log Permintaan, Log Aktivitas, Kesehatan TunnelMemeriksa permintaan, meninjau start, stop, dan perubahan pengaturan, serta melihat pemeriksaan kesehatan.Log dan inspeksi
ArgumenMengarahkan tunnel ini melalui jaringan tertentu di perangkat Anda.Pemilihan jaringan
Port KeluarMemakai port keluar yang tetap untuk koneksi server aplikasi Localtonet, untuk firewall yang ketat.Port
Catatan TunnelSimpan catatan pribadi untuk membantu Anda mengenali tunnel ini.Referensi pengaturan

Penyedia SSO tidak ditampilkan untuk tunnel milik sebuah tim.

Contoh #

Membagikan aplikasi web #

Aplikasi Anda berjalan di komputer yang sama dengan klien Localtonet dan mendengarkan di port 3000.

KolomNilai
Jenis URLSubdomain acak
Domainlocalto.net
Alamat IP lokal127.0.0.1
Port lokal3000

Buat tunnel, jalankan, lalu kirim alamat dari kolom URL kepada orang yang perlu melihat aplikasi. Untuk meminta kata sandi terlebih dahulu, aktifkan Basic Auth?.

Jika aplikasi berjalan di mesin lain di jaringan Anda, masukkan alamat mesin itu di Alamat IP lokal, misalnya 192.168.1.20. Perangkat yang menjalankan klien Localtonet harus dapat menjangkaunya.

Menerima webhook #

Penyedia webhook memerlukan alamat HTTPS publik untuk mengirim event. Buat tunnel HTTP ke port penerima Anda, jalankan, lalu masukkan alamat tunnel ditambah path endpoint Anda di sisi penyedia:

URL Webhook
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>

Uji dari komputer mana pun:

Terminal
curl -X POST https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH> \
  -H "Content-Type: application/json" \
  -d '{"event":"test"}'

Untuk melihat apa yang masuk, pilih ikon di kolom Webhook pada tunnel (Lihat log permintaan & respons). Tunnel harus sudah dijalankan. Lihat Log dan inspeksi.

Di paket Gratis, tambahkan Saldo sebelum Anda mengandalkan webhook. Permintaan ke tunnel HTTP akun Gratis akan menampilkan halaman peringatan terlebih dahulu, dan penyedia webhook tidak dapat melewatinya. Lihat bagian berikutnya.

Halaman peringatan di paket Gratis #

Jika sebuah akun tidak memiliki Saldo, pengunjung baru tunnel HTTP-nya melihat halaman Localtonet berjudul "You are about to navigate to:" dengan tombol Cancel dan Visit Site. Halaman ini ada untuk mencegah penyalahgunaan. Visit Site menyimpan cookie di browser pengunjung lalu membuka situs Anda. Selama browser menyimpan cookie itu, pengunjung tidak ditanya lagi.

Halaman itu sendiri menyebutkan dua cara untuk menghilangkannya:

  • Kirim header permintaan bernama localtonet-skip-warning dengan nilai apa pun. Ini cocok untuk skrip dan klien API Anda sendiri.
  • Tambahkan Saldo ke akun Anda. Lihat Paket dan Saldo.
Terminal
curl -H "localtonet-skip-warning: 1" https://<YOUR_SUBDOMAIN>.localto.net/

Pemecahan masalah #

Dialog menyebut token offline, atau saya mendapat "Aplikasi Localtonet untuk AuthToken … tidak terhubung."

Klien Localtonet yang memakai token tunnel ini tidak berjalan atau tidak dapat menjangkau Localtonet. Jalankan klien di perangkat dengan token yang sama. Dialog akan menjalankan tunnel dengan sendirinya begitu aplikasi terhubung. Dengan Tetap mulai, tunnel diaktifkan dan baru berjalan kemudian.

"Jalankan atau perbarui aplikasi Localtonet."

Tunnel tidak dapat dijalankan di perangkat. Pastikan klien sedang berjalan, dan pasang versi terbaru dari halaman Unduhan jika versinya sudah lama.

Browser menampilkan "Tunnel Recently Started or Stopped"

Permintaan sampai ke Localtonet, tetapi tunnel tidak menerima koneksi. Tunnel baru saja dijalankan atau sedang berhenti. Periksa apakah tunnel sudah dijalankan dan kolom Koneksi menampilkan ON, lalu muat ulang halaman.

Browser menampilkan halaman galat Localtonet yang menyebut alamat lokal saya

Halaman itu menyatakan bahwa trafik sudah diteruskan ke agen Localtonet, tetapi agen gagal terhubung ke layanan upstream di IP dan port lokal Anda. Judulnya adalah galatnya, misalnya ConnectionRefused. Tidak ada yang mendengarkan di alamat itu. Jalankan layanan Anda, lalu periksa alamat IP lokal dan port lokal di bawah Detail Tunnel. Anda dapat menguji layanan di perangkat itu sendiri dengan membuka alamat lokal di browser.

"Anda perlu membeli saldo untuk menggunakan fitur ini."

Subdomain kustom dan Domain kustom memerlukan Saldo. Gunakan Subdomain acak, atau tambahkan Saldo di Saldo.

"You need a total balance of … to create another tunnel of this type."

Saldo Anda tidak cukup untuk tunnel lain. Di paket Gratis Anda hanya dapat membuat satu tunnel secara total, apa pun jenisnya. Hapus tunnel yang ada sebelum membuat yang lain, atau tambahkan Saldo.

"… sudah ada." atau "… tidak diizinkan."

Tunnel lain memakai subdomain itu, atau namanya dicadangkan oleh Localtonet. Pilih subdomain yang berbeda.

"PERINGATAN! Anda tidak memiliki Domain apa pun!"

Anda memilih Domain kustom tetapi belum menambahkan domain. Tambahkan dulu di Manajer DNS. Jika Anda melihat "… sudah digunakan oleh tunnel lain.", domain tersebut sudah dipakai salah satu tunnel Anda. Satu domain kustom hanya dapat melayani satu tunnel.

"Perbarui batas bandwidth atau hapus pemakaian bandwidth." atau "Perbarui tanggal kedaluwarsa."

Tunnel sudah mencapai batas bandwidth atau tanggal kedaluwarsanya sendiri dan tidak dapat dijalankan. Ubah batas atau tanggalnya di pengaturan tunnel, atau atur ulang penghitung dengan Pemakaian Bandwidth. Lihat Batas dan kedaluwarsa.

"Periksa koneksi perangkat."

Anda mengubah pengaturan yang memulai ulang tunnel yang sedang berjalan saat aplikasi Localtonet offline. Hubungkan aplikasi lalu simpan pengaturan lagi, atau hentikan tunnel terlebih dahulu.

Aplikasi saya menjawab dengan situs yang salah, atau membuat tautan dan pengalihan http://

Aplikasi Anda menentukan berdasarkan nama host atau skema yang diterimanya. Di bawah Header, tambahkan header permintaan Host jika aplikasi mengharapkan nama host yang tetap. Tambahkan header permintaan X-Forwarded-Proto dengan nilai https untuk memberi tahu aplikasi bahwa pengunjung memakai HTTPS, sehingga aplikasi membuat tautan dan pengalihan https://.

Dukungan