Langsung ke konten
Localtonet Localtonet Dasbor

Memasang Localtonet dari paket DEB atau RPM

Bantuan untuk halaman ini
Di halaman ini 9 bagian
  1. Sebelum memulai
  2. Yang dipasang oleh paket
  3. Langkah-langkah
  4. Unduh dan pasang paket
  5. Atur AuthToken Anda
  6. Periksa konfigurasi
  7. Aktifkan layanan
  8. Memulai tunnel
  9. Layanan tunnel atau layanan VPN
  10. Cara layanan berjalan
  11. Membaca log
  12. Pembaruan
  13. Menghapus
  14. Pemecahan masalah
  15. Halaman terkait

Paket DEB dan RPM memasang klien Localtonet beserta dua layanan systemd, satu untuk tunnel dan satu untuk tunnel plus VPN. Layanan membaca AuthToken Anda dari sebuah file dan berjalan tanpa terminal, sehingga klien mulai pada setiap boot.

Sebelum memulai #

  • Sistem Linux 64-bit: paket tersedia untuk x64 dan ARM64.
  • systemd 247 atau lebih baru dan OpenSSL 3, seperti Debian 12, Ubuntu 22.04+, atau RHEL 9.
  • Akses root (sudo).
  • AuthToken Anda. Pilih Salin pada kartu AuthToken di Dasbor, atau salin token dari Token Saya.

Pada distribusi lain, pada ARM 32-bit, atau saat Anda tidak ingin memakai paket sistem, gunakan skrip instalasi atau arsip yang dijelaskan di Linux.

Yang dipasang oleh paket #

PathApa itu
/usr/bin/localtonetPerintah localtonet.
/usr/lib/localtonet/Klien itu sendiri.
/usr/lib/systemd/system/localtonet.serviceLayanan tunnel.
/usr/lib/systemd/system/localtonet-vpn.serviceLayanan VPN dan tunnel.
/etc/localtonet/auth-tokenFile token. Hanya root yang dapat membacanya. File ini dipasang dengan placeholder DUMMY_AUTH_TOKEN.

Paket ini bernama localtonet. Dependensinya, di antaranya OpenSSL 3, iproute2 (iproute pada RPM), iptables, dan kmod, dipasang oleh package manager Anda. Memasang paket tidak mengaktifkan atau memulai layanan: Anda mengatur token lebih dulu lalu mengaktifkan layanan yang Anda perlukan.

Langkah-langkah #

  1. Unduh dan pasang paket #

    Pilih paket untuk distribusi dan CPU Anda dari daftar di akhir halaman ini, lalu pasang file yang diunduh dengan apt (DEB) atau dnf (RPM). Petunjuk penyiapan di bawah setiap paket menampilkan perintah yang tepat untuk file tersebut.

  2. Atur AuthToken Anda #

    Edit /etc/localtonet/auth-token sebagai root dengan editor teks dan ganti DUMMY_AUTH_TOKEN dengan token Anda dalam satu baris. Lalu pastikan hanya root yang dapat membaca file tersebut:

    Terminal
    sudo chmod 600 /etc/localtonet/auth-token
  3. Periksa konfigurasi #

    Terminal
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    Pemeriksaan membaca file token tanpa terhubung. Hasilnya Localtonet headless configuration OK. bila file berisi token 33 karakter tanpa spasi. Pemeriksaan ini tidak menanyakan ke server Localtonet apakah token valid untuk akun Anda.

  4. Aktifkan layanan #

    Untuk tunnel, aktifkan layanan tunnel dan baca lognya:

    Terminal
    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Jika perangkat ini juga bergabung ke jaringan VPN, aktifkan layanan VPN sebagai gantinya. Lihat Layanan tunnel atau layanan VPN.

  5. Memulai tunnel #

    Token sekarang menampilkan Online di Token Saya. Buat dan mulai tunnel untuknya di dasbor, lihat Mulai cepat.

Layanan tunnel atau layanan VPN #

Kedua layanan menjalankan klien yang sama dan keduanya melayani tunnel Anda. Perbedaannya ada pada hak akses saat berjalan. Aktifkan salah satunya: kedua layanan saling bertentangan, dan memulai yang satu menghentikan yang lain.

localtonet.servicelocaltonet-vpn.service
Gunakan untukTunnelVPN dan tunnel
Berjalan sebagaiPengguna tanpa hak istimewa yang dibuat systemd untuk layananroot, dibatasi pada kemampuan jaringan CAP_NET_ADMIN dan CAP_NET_RAW
Modul TUNTidak digunakanDimuat dengan modprobe tun sebelum klien dimulai
Direktori kerja/var/lib/localtonet/var/lib/localtonet-vpn

Untuk memindahkan perangkat dari layanan tunnel ke layanan VPN:

Terminal
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service

Untuk kembali, nonaktifkan localtonet-vpn.service dan aktifkan localtonet.service dengan cara yang sama. Jaringan VPN itu sendiri diatur di dasbor, lihat Manajer VPN.

Cara layanan berjalan #

PerilakuDetail
Mode headlessKedua layanan menjalankan localtonet --headless. Dalam mode ini klien tidak pernah menampilkan prompt, dan tidak menyimpan token di pengaturannya sendiri.
Tokensystemd meneruskan /etc/localtonet/auth-token ke layanan. Layanan tidak dimulai selama file tersebut tidak ada.
Mulai saat bootLayanan yang diaktifkan dimulai setelah jaringan aktif.
Mulai ulangsystemd memulai ulang klien sepuluh detik setelah kegagalan. systemd tidak memulai ulang klien bila klien berhenti karena file token tidak valid. Perbaiki file lalu mulai ulang layanan sendiri.

Membaca log #

Dalam mode headless, klien menulis baris teks biasa ke journal, satu baris untuk setiap perubahan:

Terminal
sudo journalctl -u localtonet.service -f
BarisArtinya
Connection: ConnectedStatus sesi. Nilai lainnya adalah Connecting dan Disconnected.
AuthTokenName: …Nama token yang dipakai klien untuk login.
OPEN …, ADDED …Tunnel yang berjalan di perangkat ini, dengan alamat publik, protokol, dan target lokalnya.
STATUS …Status sebuah tunnel berubah.
CLOSED …Sebuah tunnel dihentikan atau dihapus.
Authentication failed: AuthToken was rejected.Token di file tidak diterima. Salin lagi dari Token Saya.

Jika salah satu baris ini berisi token, klien menuliskan [redacted] sebagai gantinya.

Pembaruan #

Unduh paket baru dan pasang dengan cara yang sama seperti pertama kali, lalu mulai ulang layanan yang Anda pakai. File token Anda dipertahankan.

Layanan tunnel
sudo systemctl restart localtonet
Layanan VPN
sudo systemctl restart localtonet-vpn.service

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

Menghapus #

Debian, Ubuntu
sudo apt remove localtonet
Fedora, RHEL
sudo dnf remove localtonet

Menghapus paket menghentikan dan menonaktifkan kedua layanan. File token adalah file konfigurasi, dan package manager memperlakukannya dengan hati-hati: setelah penghapusan, periksa apakah /etc/localtonet/auth-token atau salinan yang tersimpan masih ada, dan hapus jika Anda tidak ingin token tetap berada di mesin.

Pemecahan masalah #

Invalid Localtonet headless configuration. Check the token file or environment settings.

File token tidak dapat dipakai. Pastikan /etc/localtonet/auth-token ada, placeholder DUMMY_AUTH_TOKEN sudah hilang, dan file hanya berisi token 33 karakter, tanpa spasi dan dalam satu baris. Jalankan pemeriksaan dengan sudo, karena hanya root yang dapat membaca file tersebut.

Layanan diaktifkan tetapi tidak berjalan

Jalankan systemctl status localtonet.service. Layanan tidak dimulai selama /etc/localtonet/auth-token tidak ada, dan tidak dimulai ulang setelah berhenti karena file token tidak valid. Perbaiki file, jalankan pemeriksaan konfigurasi, lalu jalankan sudo systemctl restart localtonet.service.

Log menampilkan: Authentication failed: AuthToken was rejected.

File memiliki format yang benar tetapi token tidak diterima. Salin lagi token dari Token Saya, simpan ke file token, lalu mulai ulang layanan.

Layanan tunnel berhenti saat saya memulai layanan VPN

Itu memang disengaja. Kedua layanan saling bertentangan, sehingga systemd menghentikan yang satu saat yang lain dimulai. Layanan VPN juga melayani tunnel Anda.

Paket tidak dapat dipasang di distribusi saya

Paket memerlukan systemd 247 atau lebih baru dan OpenSSL 3. Pada rilis yang lebih lama, package manager tidak dapat memenuhi dependensi ini. Gunakan skrip instalasi atau arsip dari halaman Linux sebagai gantinya.

Paket tercantum di bawah. Pilih Petunjuk penyiapan di bawah sebuah paket untuk melihat perintah dengan nama filenya.

Paket Linux

Paket DEB dan RPM yang dapat diinstal untuk x64 dan ARM64. Memerlukan systemd 247 atau lebih baru dan OpenSSL 3, misalnya Debian 12, Ubuntu 22.04+, atau RHEL 9.

  • Debian / Ubuntu · x64
    Petunjuk penyiapan

    1. Instal paket yang telah diunduh. Buka terminal di direktori yang berisi localtonet-linux-x64.deb.

    sudo apt install ./localtonet-linux-x64.deb

    2. Atur AuthToken Anda. Edit /etc/localtonet/auth-token sebagai root dan ganti DUMMY_AUTH_TOKEN dengan token Anda dalam satu baris. Lalu lindungi file tersebut dan periksa konfigurasinya:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Jalankan service. Setelah pemeriksaan konfigurasi berhasil:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Untuk VPN, beralihlah ke service VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Untuk memperbarui, instal paket baru dan jalankan sudo systemctl restart localtonet. Konfigurasi Anda tetap dipertahankan.

    Jika Anda menggunakan VPN, restart localtonet-vpn.service sebagai gantinya.

  • Debian / Ubuntu · ARM64
    Petunjuk penyiapan

    1. Instal paket yang telah diunduh. Buka terminal di direktori yang berisi localtonet-linux-arm64.deb.

    sudo apt install ./localtonet-linux-arm64.deb

    2. Atur AuthToken Anda. Edit /etc/localtonet/auth-token sebagai root dan ganti DUMMY_AUTH_TOKEN dengan token Anda dalam satu baris. Lalu lindungi file tersebut dan periksa konfigurasinya:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Jalankan service. Setelah pemeriksaan konfigurasi berhasil:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Untuk VPN, beralihlah ke service VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Untuk memperbarui, instal paket baru dan jalankan sudo systemctl restart localtonet. Konfigurasi Anda tetap dipertahankan.

    Jika Anda menggunakan VPN, restart localtonet-vpn.service sebagai gantinya.

  • Fedora / RHEL · x64
    Petunjuk penyiapan

    1. Instal paket yang telah diunduh. Buka terminal di direktori yang berisi localtonet-linux-x64.rpm.

    sudo dnf install ./localtonet-linux-x64.rpm

    2. Atur AuthToken Anda. Edit /etc/localtonet/auth-token sebagai root dan ganti DUMMY_AUTH_TOKEN dengan token Anda dalam satu baris. Lalu lindungi file tersebut dan periksa konfigurasinya:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Jalankan service. Setelah pemeriksaan konfigurasi berhasil:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Untuk VPN, beralihlah ke service VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Untuk memperbarui, instal paket baru dan jalankan sudo systemctl restart localtonet. Konfigurasi Anda tetap dipertahankan.

    Jika Anda menggunakan VPN, restart localtonet-vpn.service sebagai gantinya.

  • Fedora / RHEL · ARM64
    Petunjuk penyiapan

    1. Instal paket yang telah diunduh. Buka terminal di direktori yang berisi localtonet-linux-arm64.rpm.

    sudo dnf install ./localtonet-linux-arm64.rpm

    2. Atur AuthToken Anda. Edit /etc/localtonet/auth-token sebagai root dan ganti DUMMY_AUTH_TOKEN dengan token Anda dalam satu baris. Lalu lindungi file tersebut dan periksa konfigurasinya:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Jalankan service. Setelah pemeriksaan konfigurasi berhasil:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Untuk VPN, beralihlah ke service VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Untuk memperbarui, instal paket baru dan jalankan sudo systemctl restart localtonet. Konfigurasi Anda tetap dipertahankan.

    Jika Anda menggunakan VPN, restart localtonet-vpn.service sebagai gantinya.

Dukungan