Memasang Localtonet dari paket DEB atau RPM
Di halaman ini 9 bagian
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 #
| Path | Apa itu |
|---|---|
/usr/bin/localtonet | Perintah localtonet. |
/usr/lib/localtonet/ | Klien itu sendiri. |
/usr/lib/systemd/system/localtonet.service | Layanan tunnel. |
/usr/lib/systemd/system/localtonet-vpn.service | Layanan VPN dan tunnel. |
/etc/localtonet/auth-token | File 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 #
-
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) ataudnf(RPM). Petunjuk penyiapan di bawah setiap paket menampilkan perintah yang tepat untuk file tersebut. -
Atur AuthToken Anda #
Edit
/etc/localtonet/auth-tokensebagai root dengan editor teks dan gantiDUMMY_AUTH_TOKENdengan token Anda dalam satu baris. Lalu pastikan hanya root yang dapat membaca file tersebut:Terminalsudo chmod 600 /etc/localtonet/auth-token -
Periksa konfigurasi #
Terminalsudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-configPemeriksaan 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. -
Aktifkan layanan #
Untuk tunnel, aktifkan layanan tunnel dan baca lognya:
Terminalsudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceJika perangkat ini juga bergabung ke jaringan VPN, aktifkan layanan VPN sebagai gantinya. Lihat Layanan tunnel atau layanan VPN.
-
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.service | localtonet-vpn.service | |
|---|---|---|
| Gunakan untuk | Tunnel | VPN dan tunnel |
| Berjalan sebagai | Pengguna tanpa hak istimewa yang dibuat systemd untuk layanan | root, dibatasi pada kemampuan jaringan CAP_NET_ADMIN dan CAP_NET_RAW |
| Modul TUN | Tidak digunakan | Dimuat dengan modprobe tun sebelum klien dimulai |
| Direktori kerja | /var/lib/localtonet | /var/lib/localtonet-vpn |
Untuk memindahkan perangkat dari layanan tunnel ke layanan VPN:
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.serviceUntuk 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 #
| Perilaku | Detail |
|---|---|
| Mode headless | Kedua layanan menjalankan localtonet --headless. Dalam mode ini klien tidak pernah menampilkan prompt, dan tidak menyimpan token di pengaturannya sendiri. |
| Token | systemd meneruskan /etc/localtonet/auth-token ke layanan. Layanan tidak dimulai selama file tersebut tidak ada. |
| Mulai saat boot | Layanan yang diaktifkan dimulai setelah jaringan aktif. |
| Mulai ulang | systemd 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:
sudo journalctl -u localtonet.service -f| Baris | Artinya |
|---|---|
Connection: Connected | Status 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.
sudo systemctl restart localtonetsudo systemctl restart localtonet-vpn.serviceDi Token Saya, kolom Klien menampilkan versi yang terakhir dilaporkan perangkat dan lencana Perlu Pembaruan bila ada versi yang lebih baru.
Menghapus #
sudo apt remove localtonetsudo dnf remove localtonetMenghapus 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.
Halaman terkait #
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.deb2. Atur AuthToken Anda. Edit
/etc/localtonet/auth-tokensebagai root dan gantiDUMMY_AUTH_TOKENdengan 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-config3. Jalankan service. Setelah pemeriksaan konfigurasi berhasil:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceUntuk 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.serviceUntuk memperbarui, instal paket baru dan jalankan
sudo systemctl restart localtonet. Konfigurasi Anda tetap dipertahankan.Jika Anda menggunakan VPN, restart
localtonet-vpn.servicesebagai 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.deb2. Atur AuthToken Anda. Edit
/etc/localtonet/auth-tokensebagai root dan gantiDUMMY_AUTH_TOKENdengan 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-config3. Jalankan service. Setelah pemeriksaan konfigurasi berhasil:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceUntuk 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.serviceUntuk memperbarui, instal paket baru dan jalankan
sudo systemctl restart localtonet. Konfigurasi Anda tetap dipertahankan.Jika Anda menggunakan VPN, restart
localtonet-vpn.servicesebagai 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.rpm2. Atur AuthToken Anda. Edit
/etc/localtonet/auth-tokensebagai root dan gantiDUMMY_AUTH_TOKENdengan 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-config3. Jalankan service. Setelah pemeriksaan konfigurasi berhasil:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceUntuk 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.serviceUntuk memperbarui, instal paket baru dan jalankan
sudo systemctl restart localtonet. Konfigurasi Anda tetap dipertahankan.Jika Anda menggunakan VPN, restart
localtonet-vpn.servicesebagai 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.rpm2. Atur AuthToken Anda. Edit
/etc/localtonet/auth-tokensebagai root dan gantiDUMMY_AUTH_TOKENdengan 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-config3. Jalankan service. Setelah pemeriksaan konfigurasi berhasil:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceUntuk 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.serviceUntuk memperbarui, instal paket baru dan jalankan
sudo systemctl restart localtonet. Konfigurasi Anda tetap dipertahankan.Jika Anda menggunakan VPN, restart
localtonet-vpn.servicesebagai gantinya.