Langsung ke konten
Localtonet Localtonet Dasbor

Memasang Localtonet di Linux

Bantuan untuk halaman ini
Di halaman ini 9 bagian
  1. Sebelum memulai
  2. Memasang dengan skrip
  3. Menjalankan skrip instalasi
  4. Periksa pemasangan
  5. Memasang secara manual
  6. Mengunduh dan mengekstrak
  7. Opsional: pindahkan ke PATH
  8. Jalankan klien
  9. Menjalankannya dengan token Anda
  10. Memeriksa sesi
  11. Menjalankan sebagai layanan systemd
  12. Memasang layanan
  13. Memeriksa bahwa layanan berjalan
  14. Perintah layanan
  15. Unit dan lognya
  16. Memutakhirkan
  17. Mengganti klien
  18. Memulai ulang layanan
  19. Mencopot pemasangan
  20. Pemecahan masalah
  21. Halaman terkait

Di Linux, klien Localtonet adalah satu program konsol. Pasang dengan skrip instalasi atau dari arsip ZIP, jalankan dengan AuthToken Anda, dan pasang sebagai layanan systemd jika klien harus dimulai setelah setiap reboot.

Sebelum memulai #

  • Akun Localtonet. Buat secara gratis jika Anda belum punya.
  • AuthToken Anda. Pilih Salin pada kartu AuthToken di Dasbor, atau salin token dari Token Saya.
  • curl atau wget, dan unzip.
  • Untuk layanan systemd: akses root dan distribusi yang memakai systemd.

Cara lain menjalankan Localtonet di Linux. Di Debian, Ubuntu, Fedora, dan RHEL Anda dapat memasang paket DEB atau RPM yang membawa layanannya sendiri. Ada panduan terpisah untuk Docker, router OpenWrt, dan Termux di Android.

Memasang dengan skrip #

  1. Menjalankan skrip instalasi #

    Terminal
    curl -fsSL https://localtonet.com/install.sh | sh

    Skrip mendeteksi CPU Anda (x64, ARM64, atau ARM) dan apakah sistem memakai glibc atau musl, mengunduh build yang sesuai, lalu memasangnya ke /usr/local/bin/localtonet. Skrip juga membuat tautan /usr/bin/localtonet, agar sudo localtonet berfungsi pada distribusi yang sudo-nya tidak mencari di /usr/local/bin.

    Skrip memakai sudo jika pengguna Anda tidak dapat menulis ke folder instalasi, itulah sebabnya skrip mungkin meminta kata sandi Anda. Jika unzip belum ada, skrip mencoba memasangnya dengan pengelola paket distribusi Anda.

  2. Periksa pemasangan #

    Skrip berakhir dengan menampilkan versi yang terpasang. Anda dapat menampilkannya lagi kapan saja:

    Terminal
    localtonet --version

Memasang secara manual #

Jika Anda lebih suka mengunduh langsung, ambil arsip untuk sistem Anda. Setiap ZIP berisi satu file, localtonet.

uname -m menampilkan jenis CPU Anda: x86_64 berarti x64, aarch64 berarti ARM64, dan armv7l berarti ARM.

  1. Mengunduh dan mengekstrak #

    Contoh ini memakai build glibc x64. Ganti nama file dengan arsip untuk sistem Anda.

    Terminal
    wget https://localtonet.com/download/localtonet-linux-x64.zip
    unzip localtonet-linux-x64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
  2. Opsional: pindahkan ke PATH #

    Tanpa langkah ini, Anda menjalankan klien lewat path-nya, ~/localtonet/localtonet. Setelahnya Anda dapat mengetik localtonet di folder mana pun.

    Terminal
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

Jalankan klien #

  1. Menjalankannya dengan token Anda #

    Terminal
    localtonet --authtoken <YOUR_TOKEN>

    Klien menyimpan token secara lokal untuk pengguna Anda. Lain kali Anda dapat menjalankannya cukup dengan localtonet. Jika Anda menjalankannya tanpa token tersimpan, klien bertanya Please Enter AuthToken or PIN.

  2. Memeriksa sesi #

    Terminal menampilkan Session Status: Connected di atas tabel dengan satu baris untuk setiap tunnel yang berjalan: IP/Url, Protocol, Client IP, Client Port, Ping, dan Status. Tabel kosong sampai Anda memulai tunnel di dasbor, lihat Mulai cepat.

    Tekan Ctrl + C untuk menghentikan klien. Tekan F12 untuk menghapus token tersimpan dan keluar.

Jika keluarannya bukan terminal, misalnya saat Anda mengalihkannya ke file, klien menulis satu baris biasa untuk setiap perubahan sebagai ganti tabel.

VPN memerlukan root. Jika perangkat menjadi bagian dari jaringan Manajer VPN dan klien berjalan tanpa root, baris VPN pada tabel menampilkan Admin rights required. Dalam kasus itu, jalankan klien dengan sudo atau sebagai layanan.

Menjalankan sebagai layanan systemd #

Layanan memulai Localtonet setelah setiap reboot, menjaganya tetap berjalan setelah Anda logout, dan tidak memerlukan terminal yang terbuka. Perintah layanan memerlukan root.

  1. Memasang layanan #

    Terminal
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>

    Perintah ini menulis unit systemd untuk token ini, mengaktifkannya, dan langsung memulainya. Perintah menjawab dengan nama unit:

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX> adalah 9 karakter pertama token Anda. Setiap token memiliki unitnya sendiri, jadi perintah layanan lainnya memerlukan --authtoken yang sama untuk menemukannya.

  2. Memeriksa bahwa layanan berjalan #

    Terminal
    sudo localtonet --status-service --authtoken <YOUR_TOKEN>

    Layanan yang berjalan menjawab [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. Di dasbor, token menampilkan Online di Token Saya.

Perintah layanan #

Jalankan setiap perintah dengan sudo dan tambahkan --authtoken <YOUR_TOKEN>.

PerintahFungsinya
--install-serviceMenulis file unit, mengaktifkan unit, dan memulainya.
--start-serviceMemulai unit, misalnya setelah Anda menghentikannya.
--stop-serviceMenghentikan unit. Unit tetap aktif dan dimulai lagi setelah reboot.
--status-serviceMenampilkan status, misalnya Running, Stopped, atau Error saat unit gagal.
--remove-serviceMenghentikan dan menonaktifkan unit, lalu menghapus file unit.

Layanan dipasang dengan opsi yang Anda berikan bersama --install-service. Opsi-opsinya tercantum di Referensi CLI.

Unit dan lognya #

File unit berada di /etc/systemd/system/Localtonet_<TOKEN_PREFIX>.service. systemd memulai ulang klien lima detik setelah terjadi kegagalan. Karena ini unit systemd biasa, Anda juga dapat mengelolanya dengan systemctl dan membaca keluarannya dengan journalctl:

Terminal
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -f

Unit menjalankan file localtonet dari path yang dimilikinya saat Anda memasang layanan. Satu pengecualian: jika path itu berada di bawah /root/, perintah pemasangan menyalin file ke /usr/local/lib/Localtonet_<TOKEN_PREFIX>/ dan layanan menjalankan salinan tersebut.

Memutakhirkan #

  1. Mengganti klien #

    Jalankan skrip instalasi lagi. Aman untuk dijalankan ulang dan menimpa klien yang terpasang dengan versi terbaru. Setelah pemasangan manual, unduh arsip terbaru dan ganti file localtonet.

    Terminal
    curl -fsSL https://localtonet.com/install.sh | sh
  2. Memulai ulang layanan #

    Layanan yang berjalan tetap memakai versi lama sampai dimulai ulang.

    Terminal
    sudo systemctl restart Localtonet_<TOKEN_PREFIX>

    Jika layanan menjalankan salinan di bawah /usr/local/lib/, hapus layanan dan pasang lagi dengan klien yang baru.

Di Token Saya, kolom Klien menampilkan versi yang terakhir dilaporkan perangkat dan lencana Perlu Pembaruan saat versi yang lebih baru tersedia.

Mencopot pemasangan #

  1. Jika Anda memasang layanan, hapus layanan itu: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Untuk menghapus token tersimpan, jalankan klien dan tekan F12.
  3. Hapus klien: sudo rm /usr/local/bin/localtonet /usr/bin/localtonet setelah pemasangan dengan skrip, atau folder tempat Anda mengekstrak arsip.

Pemecahan masalah #

Install script: Unsupported architecture

Skrip memiliki build untuk x64 (x86_64), ARM64 (aarch64), dan ARM 32-bit (armv7l). Jenis CPU lain tidak didukung oleh build Linux.

Install script: Neither curl nor wget found

Pasang curl atau wget dengan pengelola paket Anda lalu jalankan skrip lagi.

Install script: Failed to install 'unzip'

Skrip tidak dapat memasang unzip sendiri. Pasang dengan pengelola paket Anda lalu jalankan skrip lagi.

Installed but not found in PATH

Buka shell baru, atau jalankan klien lewat path lengkapnya, /usr/local/bin/localtonet.

sudo: localtonet: command not found

Setelah pemasangan manual, klien tidak berada di path pencarian sudo. Gunakan path lengkap, misalnya sudo ~/localtonet/localtonet --install-service --authtoken <YOUR_TOKEN>, atau pindahkan file ke /usr/local/bin terlebih dahulu.

Install failed: 'Linux systemd service installation' requires elevated (admin/root) privileges.

Perintah dijalankan tanpa root. Ulangi dengan sudo. Hal yang sama berlaku untuk --start-service, --stop-service, dan --remove-service.

Install failed: Systemd unit already exists for 'Localtonet_…'

Layanan untuk token ini sudah terpasang. Periksa dengan --status-service. Untuk memasangnya lagi, jalankan --remove-service terlebih dahulu.

Perintah layanan gagal di sistem tanpa systemd

Mode layanan memakai systemd. Di sistem tanpa systemd, jalankan klien dengan cara lain, misalnya di dalam kontainer Docker. Klien konsol memiliki mode headless untuk keperluan ini: --headless berjalan tanpa prompt dan membaca token dari file yang ditentukan dengan --authtoken-file. Lihat Referensi CLI.

Wrong Token!

Klien mengharapkan AuthToken 33 karakter dari Token Saya, atau PIN 6 digit yang belum kedaluwarsa. Salin token sekali lagi dan masukkan pada prompt.

This token is used in another localtonet application!

Klien Localtonet lain di mesin ini sudah berjalan dengan token yang sama. Tutup klien itu, atau jalankan yang ini dengan token berbeda. Gunakan satu klien yang berjalan untuk setiap token.

Dukungan