Langsung ke konten
Localtonet Localtonet Dasbor

Mengirim tunnel melalui jaringan tertentu

Bantuan untuk halaman ini
Di halaman ini 10 bagian
  1. Sebelum memulai
  2. Langkah-langkah
  3. Mencantumkan jaringan perangkat
  4. Buka pengaturan Argumen tunnel
  5. Masukkan jaringan
  6. Simpan
  7. Argumen dalam bentuk teks
  8. Untuk apa jaringan yang dipilih digunakan
  9. Saat jaringan tidak tersedia
  10. Memilih jaringan untuk seluruh klien
  11. Contoh: dua proxy pada dua modem
  12. Pengaturan yang sama melalui API
  13. Pemecahan masalah
  14. Halaman terkait

Jika perangkat memiliki lebih dari satu koneksi internet, seperti jalur kedua atau modem USB, Anda dapat mengirim satu tunnel melalui jaringan tertentu. Tunnel lain tetap menggunakan koneksi default. Anda memilih jaringan dengan dua nilai: namanya dan alamat IP perangkat di jaringan tersebut.

Sebelum memulai #

  • Perangkat dengan sedikitnya dua jaringan aktif, dan klien Localtonet terinstal di dalamnya. Lihat Instal.
  • Tunnel dengan jenis yang memiliki pengaturan Argumen: HTTP, TCP - UDP, TLS, atau Server Proxy.
  • Di Linux, jalankan klien sebagai root atau dengan sudo tanpa kata sandi. Klien menambahkan aturan routing untuk jaringan yang dipilih dengan perintah ip; tanpa izin tersebut, trafik mungkin keluar melalui rute default.

Langkah-langkah #

  1. Mencantumkan jaringan perangkat #

    Di perangkat, jalankan:

    Terminal
    localtonet --network

    Perintah ini tidak memerlukan AuthToken. Perintah mencantumkan setiap jaringan aktif beserta alamat IP-nya, memeriksa akses internet pada setiap alamat IPv4, lalu keluar:

    Output
    NetworkName: Ethernet 2
    --net Ethernet 2 --ip 192.168.8.100   --> Internet available (public IP 203.0.113.25)
    --------------------------------------------------
    NetworkName: Wi-Fi
    --net Wi-Fi --ip 192.168.1.20   --> Internet available (public IP 198.51.100.7)
    --net Wi-Fi --ip 2001:db8::20   --> IPv6, internet check not available
    --------------------------------------------------

    Setiap baris yang diawali --net adalah pasangan siap pakai berisi nama jaringan dan alamat IP. Catat pasangan jaringan yang Anda inginkan. Baris yang berakhir dengan No internet access milik alamat yang pemeriksaan internetnya gagal. Setelah daftar, perintah mencetak penjelasan singkat tentang --net dan --ip.

  2. Buka pengaturan Argumen tunnel #

    Di dasbor, buka halaman jenis tunnel, pilih Pengaturan pada baris tunnel, lalu Argumen › Kelola. Dialog Pemilihan jaringan terbuka.

  3. Masukkan jaringan #

    Aktifkan Gunakan jaringan tertentu dan isi kedua kolom:

    KolomYang dimasukkanContoh
    Nama jaringanNama persis seperti yang dicetak localtonet --network setelah NetworkName:.Ethernet 2
    IP perangkat di jaringan tersebutAlamat IPv4 atau IPv6 perangkat di jaringan tersebut, dari baris --net jaringan itu.192.168.8.100

    Dikirim ke aplikasi menampilkan argumen yang dihasilkan, misalnya --net Ethernet 2 --ip 192.168.8.100.

  4. Simpan #

    Pilih Simpan. Tunnel yang berjalan dimulai ulang dan sejak itu menggunakan jaringan yang dipilih.

Argumen dalam bentuk teks #

Edit sebagai teks mengalihkan dialog ke satu kolom Argumen, dan Gunakan formulir mengalihkan kembali. Teksnya berbentuk seperti ini:

--net <NETWORK_NAME> --ip <IP_ADDRESS>
  • --net dan --ip harus diberikan bersamaan. Jika hanya salah satunya, tunnel tidak memiliki jaringan sendiri: tunnel menggunakan jaringan default, atau jaringan yang dipilih untuk seluruh klien.
  • Nama jaringan yang mengandung spasi dapat ditulis apa adanya, atau dalam tanda kutip: --net Wi-Fi 2 --ip 192.168.1.5 dan --net "Wi-Fi 2" --ip 192.168.1.5 memiliki arti yang sama.
  • Nama dicocokkan persis terlebih dahulu. Nama yang hanya berbeda huruf besar dan kecil diterima jika cocok dengan tepat satu jaringan.
  • Alamat IP harus alamat yang saat ini dimiliki perangkat di jaringan tersebut.

Untuk apa jaringan yang dipilih digunakan #

  • Koneksi tunnel dari perangkat ke server Localtonet.
  • Untuk tunnel proxy, trafik yang keluar dari perangkat langsung ke internet, beserta pencarian DNS-nya. Jika tunnel proxy memiliki Pengaturan Upstream, koneksi ke proxy upstream tidak diikat ke jaringan yang dipilih.
  • Koneksi ke layanan lokal Anda, jika layanan itu dijangkau melalui jaringan yang dipilih. Layanan di perangkat itu sendiri (127.0.0.1) atau di jaringan lokal lain dijangkau dengan cara biasa.

Saat jaringan tidak tersedia #

Saat jaringan yang dipilih tidak ada, tunnel tidak beralih ke koneksi default: koneksinya tetap tertutup. Ini penting untuk proxy: trafik tidak boleh keluar melalui jalur yang berbeda dari yang Anda pilih.

  • Jika jaringan tidak ada saat tunnel dimulai, tunnel menunggunya.
  • Jika jaringan menghilang kemudian, koneksi tunnel tetap tertutup sampai pasangan nama jaringan dan alamat IP tersedia kembali. Klien memeriksa lagi setiap beberapa detik dan saat jaringan perangkat berubah, dan tunnel berlanjut sendiri.
  • Jika perangkat mendapat alamat IP yang berbeda di jaringan tersebut, pasangan tidak lagi cocok dan tunnel tetap tertutup. Berikan alamat tetap kepada perangkat di jaringan itu, atau perbarui pengaturannya.

Jalankan klien dengan token Anda dan --debug (localtonet --authtoken <YOUR_TOKEN> --debug) untuk melihat alasannya di output error. Barisnya diawali stempel waktu dan [debug][proxy], lalu menyebut tunnel dengan pengenal internalnya, masalahnya, dan pasangan yang ditunggu:

Output klien
[2026-11-14 10:15:30.123 UTC][debug][proxy] Tunnel <TUNNEL_IDENTIFIER>: Network interface 'Ethernet 2' was not found. Run 'localtonet --network' to list the interfaces. Its connections stay closed until --net Ethernet 2 --ip 192.168.8.100 is available.

Masalah lain yang dapat disebutkannya termasuk "'192.168.8.100' is not an address of network interface 'Ethernet 2'.", "Network interface 'Ethernet 2' is Down." dan "The --ip value is not an IP address."

Memilih jaringan untuk seluruh klien #

Untuk memilih satu jaringan bagi koneksi klien itu sendiri dan untuk setiap tunnel tanpa jaringan sendiri, berikan kedua opsi yang sama saat memulainya:

Terminal
localtonet --authtoken <YOUR_TOKEN> --net <NETWORK_NAME> --ip <IP_ADDRESS>
  • Kedua opsi wajib ada. Jika hanya satu, klien mencetak "--net and --ip must be given together; the default network is used." dan melanjutkan pada jaringan default.
  • Jika jaringan tidak tersedia saat dimulai, klien menunggunya hingga 30 detik lalu berhenti dengan menyebutkan alasannya, alih-alih berjalan di jaringan lain.
  • Tunnel yang memiliki jaringan sendiri di Argumen menggunakan jaringan itu. Opsi klien berlaku untuk tunnel yang tidak memilikinya.

Semua opsi baris perintah tercantum di Referensi CLI.

Contoh: dua proxy pada dua modem #

Sebuah komputer memiliki dua modem USB. localtonet --network mencetak --net Modem A --ip 192.168.8.100 dan --net Modem B --ip 192.168.9.100. Buat dua tunnel Server Proxy pada AuthToken perangkat. Pada yang pertama, buka Argumen › Kelola dan masukkan Modem A dan 192.168.8.100; pada yang kedua, masukkan Modem B dan 192.168.9.100. Kini setiap proxy keluar melalui modemnya sendiri, dan proxy berhenti meneruskan trafik saat modemnya dicabut.

Pengaturan yang sama melalui API #

Argumen tunnel dapat dibaca (GET) dan ditetapkan (PATCH) di /api/v2/tunnels/<TUNNEL_ID>/arguments. Kirim nilai kosong untuk menghapusnya. Nilai yang ditetapkan melalui API digunakan saat tunnel dimulai berikutnya. Lihat API.

Isi permintaan
{ "arguments": "--net Ethernet 2 --ip 192.168.8.100" }

Pemecahan masalah #

“Masukkan nama jaringan.” atau “Masukkan alamat IP perangkat di jaringan tersebut.”

Kedua kolom wajib diisi selama Gunakan jaringan tertentu aktif. Untuk berhenti menggunakan jaringan tertentu, nonaktifkan sakelar dan simpan.

“Masukkan alamat IP seperti 192.168.8.100.”

Kolom kedua berisi alamat IP perangkat di jaringan tersebut, bukan nama jaringan dan bukan alamat IP publik.

"Periksa koneksi perangkat."

Menyimpan memulai ulang tunnel yang berjalan, dan aplikasi Localtonet di perangkatnya tidak terhubung. Jalankan aplikasi, atau hentikan tunnel dan simpan lagi.

Tunnel dimulai tetapi tidak meneruskan trafik

Jaringan yang dipilih kemungkinan tidak tersedia. Jalankan localtonet --network di perangkat dan bandingkan nama serta alamat IP dengan pengaturan. Perbaiki pengaturannya, atau aktifkan kembali jaringannya.

Di Linux trafik masih keluar melalui rute default

Klien kemungkinan tidak dapat menambahkan aturan routing. Jalankan sebagai root atau izinkan sudo tanpa kata sandi untuk perintah ip, lalu mulai ulang klien. Klien tidak menambahkan aturan untuk jaringan yang tidak melaporkan gateway.

localtonet --network mencetak "No active network interface with an IP address was found."

Perangkat tidak memiliki jaringan yang aktif dan beralamat. Hubungkan jaringan lalu jalankan perintah lagi.

Dukungan