Membuat tunnel HTTP
Di halaman ini 10 bagian
- Sebelum memulai
- Langkah-langkah
- Buka halaman HTTP
- Pilih jenis URL
- Pilih perangkat dan wilayah
- Masukkan alamat lokal
- Mulai tunnel
- Alamat publik Anda
- HTTPS dan sertifikat
- Header Host
- Pengaturan tunnel HTTP
- Contoh
- Membagikan aplikasi web
- Menerima webhook
- Halaman peringatan di paket Gratis
- Pemecahan masalah
- 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 #
-
Buka halaman HTTP #
Buka Tunnel Saya › HTTP lalu pilih Buat Tunnel HTTP untuk membuka formulir.
-
Pilih jenis URL #
Jenis URL Alamat yang Anda dapatkan Yang diperlukan Subdomain acak Nama yang dihasilkan otomatis pada domain yang dipilih, misalnya https://<RANDOM_NAME>.localto.net.Tidak ada tambahan Subdomain kustom Nama yang Anda ketik di Subdomain, misalnya https://myapp.localto.net. Huruf, angka, dan tanda hubung diperbolehkan.Saldo Domain kustom Domain milik Anda sendiri, yang dipilih di Domain. Saldo dan sebuah domain di Manajer DNS -
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.
-
Masukkan alamat lokal #
Kolom Yang dimasukkan Domain localto.net, atau salah satu domain milik Anda. Untuk Domain kustom, daftar ini hanya berisi domain milik Anda.Subdomain Hanya untuk Subdomain kustom: nama di depan domain. Alamat IP lokal Alamat layanan di perangkat Anda. Gunakan 127.0.0.1untuk perangkat ini. Formulir menerima alamat IPv4 atau IPv6, ataulocalhost.Port lokal Port yang didengarkan layanan lokal Anda, dari 1 hingga 65535. Pilih Buat tunnel. Tunnel muncul di bawah Tunnel Anda sebagai
Tunnel #diikuti ID-nya. -
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.
| Pengaturan | Fungsinya | Kapan 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.
| Pengaturan | Fungsinya | Selengkapnya |
|---|---|---|
| Load Balance | Membagi lalu lintas ke beberapa perangkat atau memakai target cadangan. | Load balancing |
| Tampilkan Perintah SSH | Jalankan 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 |
| Header | Mengelola header permintaan dan respons HTTP kustom untuk tunnel ini. | Header dan penulisan ulang |
| Timeout HTTP | Atur 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 IP | Kendalikan alamat IP klien mana yang dapat mengakses tunnel ini. | Kontrol akses |
| Penyedia SSO | Pengunjung 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 Aksi | Membuka 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 Bandwidth | Menghentikan 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 Tunnel | Memeriksa permintaan, meninjau start, stop, dan perubahan pengaturan, serta melihat pemeriksaan kesehatan. | Log dan inspeksi |
| Argumen | Mengarahkan tunnel ini melalui jaringan tertentu di perangkat Anda. | Pemilihan jaringan |
| Port Keluar | Memakai port keluar yang tetap untuk koneksi server aplikasi Localtonet, untuk firewall yang ketat. | Port |
| Catatan Tunnel | Simpan 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.
| Kolom | Nilai |
|---|---|
| Jenis URL | Subdomain acak |
| Domain | localto.net |
| Alamat IP lokal | 127.0.0.1 |
| Port lokal | 3000 |
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:
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>Uji dari komputer mana pun:
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-warningdengan nilai apa pun. Ini cocok untuk skrip dan klien API Anda sendiri. - Tambahkan Saldo ke akun Anda. Lihat Paket dan Saldo.
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://.