Referensi pengaturan tunnel
Di halaman ini 15 bagian
- Buka pengaturan sebuah tunnel
- Buka halaman jenis tunnel
- Pilih Pengaturan pada baris tunnel
- Mengubah pengaturan
- Cara perubahan diterapkan
- Jenis tunnel mana yang memiliki pengaturan apa
- Fungsi setiap pengaturan
- Detail tunnel
- Catatan Tunnel
- SslStream?
- PROXY Protocol?
- Koneksi Legacy?
- IP Server Lokal
- IP Tunnel
- Pengaturan di daftar tunnel
- Mengganti server
- Mengganti AuthToken
- Web Application Firewall
- Pengaturan yang sama melalui API
- Pemecahan masalah
- Halaman terkait
Setiap tunnel memiliki panel pengaturan di dasbor. Halaman ini menunjukkan cara membukanya, mencantumkan setiap pengaturan, menjelaskan jenis tunnel mana yang memilikinya, dan menautkan ke halaman yang menjelaskannya secara rinci.
Buka pengaturan sebuah tunnel #
-
Buka halaman jenis tunnel #
Di menu dasbor, buka Tunnel Saya lalu pilih jenisnya: Tunnel Saya › HTTP, TCP - UDP, TLS, Server File, Server Proxy, Proxy Rotasi atau MCP Gateway.
-
Pilih Pengaturan pada baris tunnel #
Temukan tunnel di bawah Tunnel Anda lalu pilih Pengaturan pada kolom Aksi. Panel Pengaturan tunnel terbuka di sisi halaman.
-
Mengubah pengaturan #
Panel ini terdiri dari bagian berikut:
- Detail Tunnel: detail seperti alamat tunnel, tanggal pembuatan, dan nama AuthToken, serta nilai yang dapat Anda ubah dengan memilihnya: judul pada setiap jenis tunnel, dan juga alamat lokal serta port lokal pada tunnel HTTP, TCP - UDP, dan TLS.
- Target load balancing milik tunnel, pada jenis tunnel yang mendukungnya. Lihat Load balancing.
- Tampilkan Perintah SSH, pada jenis tunnel yang dapat dimulai dengan SSH biasa. Lihat SSH tanpa instalasi.
- Pengaturan: satu baris untuk setiap pengaturan. Setiap baris memiliki sakelar Ya / Tidak atau tombol (Kelola, Ubah, Tampilkan, atau Bersihkan) yang membuka dialog. Ikon informasi di samping label menjelaskan pengaturan tersebut dalam satu kalimat.
Sebagian besar sakelar meminta konfirmasi sebelum mengubah apa pun, misalnya Aktifkan hanya HTTPS? dengan tombol Aktifkan dan Batal. Mengaktifkan Basic Auth? atau Tulis Ulang Path? akan membuka dialog, dan mengaktifkan Dicadangkan? pada tunnel yang sedang berjalan akan mencadangkan port tanpa pertanyaan.
Cara perubahan diterapkan #
Sebagian pengaturan diterapkan ke tunnel yang sedang berjalan tanpa mengganggunya. Pengaturan lain menghentikan tunnel lalu memulainya kembali dengan nilai baru, yang memerlukan waktu sejenak dan memutus koneksi yang sedang terbuka.
| Diterapkan tanpa restart | Me-restart tunnel yang sedang berjalan |
|---|---|
| Hanya HTTPS?, Tulis Ulang Path?, HTTP/3 Aktif?, Dicadangkan?, Header, Timeout HTTP, Catatan Tunnel, Pembatasan IP, Tanggal Kedaluwarsa, Port Keluar, Batas Bandwidth, Pemakaian Bandwidth, sakelar WAF | Judul, alamat lokal, dan port lokal di Detail Tunnel, Basic Auth?, SslStream?, PROXY Protocol?, Koneksi Legacy?, Port Server, Argumen, IP Server Lokal, Batas Kecepatan, penggantian server, penggantian AuthToken |
Pengaturan yang me-restart tunnel hanya dapat disimpan pada tunnel yang sedang berjalan jika aplikasi Localtonet di perangkatnya terhubung. Jika tidak, dasbor menjawab "Periksa koneksi perangkat." dan mempertahankan nilai lama. Pada tunnel yang dihentikan, nilai disimpan dan dipakai saat tunnel dimulai berikutnya.
Jenis tunnel mana yang memiliki pengaturan apa #
Labelnya sama dengan yang ditampilkan bagian Pengaturan. "Ya" berarti jenis tunnel tersebut memiliki barisnya.
| Pengaturan | HTTP | TCP - UDP | TLS | Server File | Server Proxy | Proxy Rotasi | MCP Gateway |
|---|---|---|---|---|---|---|---|
| Hanya HTTPS? | Ya | – | – | – | – | – | Ya |
| Tulis Ulang Path? | Ya | – | – | – | – | – | – |
| Basic Auth? | Ya | – | – | Ya, tipe Default | – | – | Ya |
| SslStream? | Ya | Ya, tidak untuk UDP | Ya | – | – | – | – |
| HTTP/3 Aktif? | Ya | – | – | – | – | – | Ya |
| Dicadangkan? | – | Ya | – | – | Ya | Ya | – |
| PROXY Protocol? | – | Ya, tidak untuk UDP | – | – | – | – | – |
| Koneksi Legacy? | Ya | Ya | Ya | Ya | Ya | – | Ya |
| Mode SSL | – | – | Ya | – | – | – | – |
| Penyedia SSO | Ya, tidak pada tunnel tim | – | – | – | – | – | – |
| Token Gateway | – | – | – | – | – | – | Ya |
| Header | Ya | – | – | – | – | – | – |
| Timeout HTTP | Ya | – | – | – | – | – | Ya |
| Port Server | – | Ya | – | – | Ya, tidak untuk VLESS | Ya | – |
| Catatan Tunnel | Ya | Ya | Ya | Ya | Ya | Ya | Ya |
| IP Server Lokal | Hanya server lokal | Hanya server lokal | Hanya server lokal | – | Hanya server lokal | – | Hanya server lokal |
| Argumen | Ya | Ya | Ya | – | Ya | – | – |
| Pembatasan IP | Ya | Ya | Ya | Ya | Ya | Ya | Ya |
| Tanggal Kedaluwarsa | Ya | Ya | Ya | Ya | Ya | – | Ya |
| Batas Kecepatan | Ya | Ya | Ya | Ya | Ya | – | Ya |
| Port Keluar | Ya | Ya | Ya | Ya | Ya | Ya | Ya |
| Batas Bandwidth | Ya | Ya | Ya | Ya | Ya | – | Ya |
| Trafik Bandwidth | Ya | Ya | Ya | Ya | Ya | Ya | Ya |
| Pemakaian Bandwidth | Ya | Ya | Ya | Ya | Ya | – | Ya |
| IP Tunnel | – | Ya | Ya | – | Ya | Ya | – |
| Log Permintaan | Ya | Ya | Ya | Ya | Ya | – | Ya |
| Log Aktivitas | Ya | Ya | Ya | Ya | Ya | Ya | Ya |
| Kesehatan Tunnel | Ya | Ya | Ya | – | Ya | Ya | Ya |
Halaman Server Proxy dan Proxy Rotasi memiliki baris tambahan tersendiri, seperti Autentikasi Proxy, Kontrol Akses, Pengaturan Upstream, Akses VPN, Tes Kecepatan, Token Tunnel, dan Hanya Terhubung dengan Ipv4?. Semuanya dijelaskan di Server Proxy dan Proxy Rotasi. Tunnel yang memakai server Lokal tidak memiliki baris Port Keluar. "Hanya server lokal" juga mencakup tunnel yang kolom Server-nya menampilkan VPN.
Fungsi setiap pengaturan #
| Pengaturan | Fungsinya | Detail |
|---|---|---|
| Hanya HTTPS? | Menyajikan URL publik hanya melalui HTTPS. | Header dan penulisan ulang |
| Tulis Ulang Path? | Menambahkan path di depan setiap permintaan sebelum mencapai layanan lokal Anda. | Header dan penulisan ulang |
| Basic Auth? | Meminta pengunjung memasukkan nama pengguna dan kata sandi. | Kontrol akses |
| SslStream? | Memberi tahu tunnel bahwa layanan lokal Anda sendiri menggunakan HTTPS atau TLS. | Halaman ini |
| HTTP/3 Aktif? | Memungkinkan klien mengakses URL publik melalui HTTP/3. | Header dan penulisan ulang |
| Dicadangkan? | Mempertahankan port server yang sama saat tunnel di-restart. | Port |
| PROXY Protocol? | Meneruskan alamat klien asli ke layanan Anda dalam header PROXY protocol. | Halaman ini |
| Koneksi Legacy? | Metode koneksi alternatif yang dapat dicoba ketika tunnel tidak dapat terhubung dengan metode normal. | Halaman ini |
| Mode SSL | Menentukan apakah Localtonet menangani HTTPS untuk tunnel TLS atau meneruskan lalu lintas terenkripsi apa adanya ke layanan Anda. | TLS |
| Penyedia SSO | Mewajibkan pengunjung masuk dengan salah satu penyedia identitas Anda sebelum dapat membuka tunnel. | Single Sign-On |
| Token Gateway | Menampilkan token yang dikirim klien MCP Anda untuk terhubung ke gateway. | MCP Gateway |
| Header | Menambahkan header permintaan dan respons yang tetap. | Header dan penulisan ulang |
| Timeout HTTP | Menetapkan berapa lama tunnel menunggu layanan Anda menjawab sebuah permintaan. | Header dan penulisan ulang |
| Port Server | Mengubah port yang dituju orang saat terhubung ke server Localtonet. | Port |
| Catatan Tunnel | Pengingat pribadi tentang kegunaan tunnel. | Halaman ini |
| IP Server Lokal | Alamat tempat server lokal Anda dapat dijangkau. | Halaman ini |
| Argumen | Mengirim tunnel melalui jaringan tertentu pada perangkat. | Pemilihan jaringan |
| Pembatasan IP | Menentukan alamat IP mana yang dapat terhubung ke tunnel. | Kontrol akses |
| Tanggal Kedaluwarsa | Menghentikan tunnel pada tanggal yang ditetapkan. | Batas dan kedaluwarsa |
| Batas Kecepatan | Membatasi kecepatan unggah dan unduh. | Batas dan kedaluwarsa |
| Port Keluar | Menjaga port tujuan koneksi keluar aplikasi Localtonet tetap, untuk firewall yang ketat. | Port |
| Batas Bandwidth | Menghentikan tunnel setelah memindahkan sejumlah data tertentu. | Batas dan kedaluwarsa |
| Trafik Bandwidth | Menampilkan grafik data yang melewati tunnel. | Batas dan kedaluwarsa |
| Pemakaian Bandwidth | Mengatur ulang penghitung data tunnel ke nol. | Batas dan kedaluwarsa |
| IP Tunnel | Menampilkan alamat IP server tempat tunnel berjalan. | Halaman ini |
| Log Permintaan | Menampilkan permintaan atau koneksi yang tercatat untuk tunnel. | Log dan inspeksi |
| Log Aktivitas | Mencantumkan awal, penghentian, dan perubahan pengaturan. | Log dan inspeksi |
| Kesehatan Tunnel | Menampilkan hasil pemeriksaan kesehatan berkala. | Log dan inspeksi |
Detail tunnel #
Pilih sebuah nilai di Detail Tunnel untuk mengubahnya. Menyimpan salah satu dari ketiganya akan me-restart tunnel yang sedang berjalan. Alamat lokal dan port lokal dapat diubah di sini pada tunnel HTTP, TCP - UDP, dan TLS; jenis tunnel lainnya hanya menampilkan judul.
| Dialog | Yang dimasukkan | Aturan |
|---|---|---|
| Ganti nama tunnel | Nama yang mudah Anda kenali di daftar tunnel, misalnya "Office NAS". | Wajib diisi. Maksimal 30 karakter: dialog menghitung hingga 100, tetapi judul yang lebih panjang dari 30 ditolak dengan pesan "Judul tidak boleh lebih dari 30 karakter." |
| Alamat lokal | Tempat aplikasi Localtonet menemukan layanan Anda. Gunakan 127.0.0.1 jika layanan berjalan di perangkat yang sama dengan aplikasi. Untuk menjangkau perangkat lain di jaringan Anda, masukkan alamatnya, misalnya 192.168.1.20. | Alamat IPv4, alamat IPv6, atau nama host. Tanpa http://, tanpa path, tanpa port. |
| Port lokal | Port yang didengarkan layanan Anda, pada perangkat yang menjalankannya. | Angka dari 1 sampai 65535. |
Catatan Tunnel #
Catatan Tunnel › Kelola membuka dialog Catatan. Catatan adalah pengingat tentang kegunaan tunnel, dan hanya akun Anda yang dapat melihatnya.
- Catatan dapat berisi hingga 499 karakter. Dialog menghitungnya saat Anda mengetik.
- Pilihan di bawah Label menaruh label di depan catatan: Produksi, Staging, Pengujian, Demo, atau Sementara. Catatan kemudian diawali dengan, misalnya,
Staging -. Memilih label lain akan menggantikan label yang ada.
SslStream? #
Aktifkan SslStream? jika layanan lokal Anda sendiri menggunakan HTTPS atau TLS, misalnya server pengembangan yang hanya mendengarkan di https://localhost. Biarkan nonaktif untuk layanan yang memakai HTTP biasa atau TCP biasa. Tunnel HTTP, TCP, dan TLS memiliki sakelar ini; tunnel UDP tidak.
PROXY Protocol? #
Dengan PROXY Protocol? aktif, tunnel meneruskan alamat klien asli ke layanan Anda dalam header PROXY protocol. Aktifkan hanya jika layanan Anda sudah diatur untuk membaca header tersebut, karena layanan yang tidak mengharapkannya akan melihat byte yang tidak dikenal di awal setiap koneksi. Tunnel TCP memiliki sakelar ini; tunnel UDP tidak.
Koneksi Legacy? #
Koneksi Legacy? mengalihkan tunnel ke metode koneksi alternatif. Coba jika tunnel tidak dapat terhubung dengan metode normal, dan nonaktifkan kembali jika tidak membantu.
IP Server Lokal #
Baris ini hanya muncul pada tunnel yang kolom Server-nya menampilkan Lokal atau VPN. Dialog IP server lokal berisi alamat tempat server lokal Anda dapat dijangkau: sebuah Alamat IPv4 dan, secara opsional, sebuah Alamat IPv6. Kosongkan IPv6 jika Anda tidak menggunakannya. Setidaknya satu alamat wajib diisi. Alamat yang hanya berfungsi di perangkat itu sendiri, seperti 127.0.0.1, 0.0.0.0, atau ::1, ditolak dengan pesan "IP server lokal harus dapat dijangkau dari luar."
IP Tunnel #
IP Tunnel › Tampilkan membuka dialog IP Server yang berisi alamat IPv4 dan, jika server memilikinya, alamat IPv6 dari server tempat tunnel berjalan. Klien dapat terhubung ke tunnel dengan alamat ini sebagai pengganti nama domain.
Alamat IP server dapat berubah. Gunakan nama domain di aplikasi dan skrip sebisa mungkin.
Pengaturan di daftar tunnel #
Dua pengaturan diubah dari daftar tunnel, bukan dari panel.
Mengganti server #
Pilih kode server di kolom Server, pilih server lain di dialog Ganti Server, lalu pilih Kirim. Tunnel yang sedang berjalan di-restart di server baru.
- Mengganti server memerlukan Saldo. Tanpa Saldo, dasbor menjawab "Anda perlu membeli saldo untuk menggunakan fitur ini."
- Jika port server tunnel sudah dipakai di server baru, Anda mendapat pesan "Port tunnel Anda (PORT) tidak tersedia di server yang dipilih. Ubah port terlebih dahulu." Ubah port seperti dijelaskan di Port, lalu coba lagi.
- Tunnel yang kolom Server-nya menampilkan Lokal atau VPN tidak dapat dipindahkan.
Saat server diganti, pembaruan DNS dapat memakan waktu hingga 3 jam.
Mengganti AuthToken #
Pilih nama token di kolom AuthToken untuk membuka Ganti AuthToken, pilih AuthToken lain, lalu pilih Kirim. Ini memindahkan tunnel ke perangkat yang menjalankan aplikasi Localtonet dengan token tersebut.
- Tunnel yang sedang berjalan dihentikan, menunggu 2 detik, lalu dimulai kembali dengan AuthToken yang dipilih. Tunnel yang dihentikan tetap berhenti.
- Jika aplikasi dengan token baru tidak terhubung, token tetap diganti dan Anda mendapat pesan "AuthToken telah diperbarui, tetapi tunnel tidak dapat dimulai ulang. Hubungkan aplikasi Localtonet dengan token yang dipilih lalu mulai tunnel."
- Tunnel Proxy Rotasi memakai grup AuthToken. Ubah grupnya sebagai gantinya.
AuthToken dijelaskan di AuthToken.
Web Application Firewall #
Tunnel HTTP dan MCP Gateway juga memiliki tombol perisai di kolom Aksi. Tombol ini membuka firewall tunnel. Lihat Web Application Firewall.
Pengaturan yang sama melalui API #
Sebagian besar pengaturan juga dapat dibaca dan diubah dengan API, di bawah path tunnel. Autentikasi dan referensi lengkap ada di API.
| Pengaturan | Path setelah /api/v2/tunnels/<TUNNEL_ID>/ |
|---|---|
| Pembatasan IP | ip-restrictions |
| Header | headers, host-header |
| Basic Auth | authentication |
| Tanggal Kedaluwarsa | expiration |
| Port Server | server-port |
| Timeout HTTP | http-timeout |
| Batas Kecepatan | rate-limit |
| Batas Bandwidth dan pemakaian | bandwidth-limit, bandwidth-usage, bandwidth-usage/reset |
| Argumen | arguments |
| Hanya HTTPS?, HTTP/3 Aktif?, Tulis Ulang Path? | https-only, http3, path-rewrite |
| SslStream?, PROXY Protocol?, Mode SSL | ssl-stream, proxy-protocol, pass-through |
| Catatan Tunnel | note |
| Server | server |
Pemecahan masalah #
"Periksa koneksi perangkat."
Pengaturan ini me-restart tunnel, dan aplikasi Localtonet di perangkat tunnel tidak terhubung. Jalankan aplikasi di perangkat, tunggu hingga kolom Koneksi menampilkan ON, lalu simpan lagi. Anda juga dapat menghentikan tunnel terlebih dahulu: pada tunnel yang dihentikan, nilai disimpan tanpa restart.
"Anda perlu membeli saldo untuk menggunakan fitur ini."
Pengaturan ini memerlukan Saldo pada akun. Ini berlaku untuk port yang dicadangkan, port server kustom, port keluar tetap, pembatasan IP, dan penggantian server. Lihat Paket dan Saldo.
"Anda tidak memiliki izin untuk memperbarui tunnel ini."
Anda bekerja dalam tim dan peran Anda tidak mencakup pengubahan tunnel. Minta pemilik tim untuk memberi Anda izin tersebut. Lihat Manajemen Tim.
Ada baris tabel yang tidak muncul di panel saya
Panel hanya menampilkan baris sesuai jenis tunnel, dan beberapa baris bergantung pada tunnelnya sendiri: IP Server Lokal memerlukan server Lokal atau VPN, Penyedia SSO tidak ditampilkan pada tunnel tim, dan tunnel UDP tidak memiliki SslStream? dan PROXY Protocol?.