Menjalankan Localtonet sebagai layanan
Di halaman ini 8 bagian
Pasang klien Localtonet sebagai layanan latar belakang agar dimulai bersama perangkat, tetap berjalan setelah Anda keluar, dan tidak membutuhkan terminal yang terbuka. Satu perintah mendaftarkannya ke layanan Windows, launchd di macOS, atau systemd di Linux.
Sebelum memulai #
- Klien konsol sudah terpasang di perangkat: Windows, macOS, atau Linux.
- AuthToken untuk perangkat ini dari Token Saya.
- Hak administrator: terminal yang dibuka dengan Jalankan sebagai administrator di Windows,
sudodi macOS dan Linux. - Di Linux, distribusi yang memakai systemd. Termux tidak didukung; gunakan aplikasi Android di sana.
Dipasang dari paket DEB atau RPM, di OpenWrt, atau di Docker? Semuanya punya cara sendiri untuk mulai saat boot. Lihat Paket DEB dan RPM, OpenWrt, dan Docker, bukan halaman ini.
Memasang layanan #
Jalankan klien sekali dengan --install-service dan token Anda. Ganti <YOUR_TOKEN> dengan AuthToken Anda. Selalu sertakan --authtoken pada perintah ini: layanan terhubung dengan token yang dipakai saat memasangnya.
Windows #
Buka Command Prompt atau PowerShell sebagai Administrator di folder yang berisi localtonet, lalu jalankan:
localtonet --install-service --authtoken <YOUR_TOKEN>Klien membuat layanan Windows dengan mulai otomatis dan menjalankannya. Layanan terlihat di services.msc dengan deskripsi Localtonet Service. Jika layanan gagal, Windows memulainya lagi setelah satu menit.
macOS
sudo localtonet --install-service --authtoken <YOUR_TOKEN>Klien menulis job launchd ke /Library/LaunchDaemons/<SERVICE_NAME>.plist, memuatnya, dan menjalankannya. Job dimulai saat boot, dan launchd memulainya lagi bila keluar dengan kesalahan.
Linux
sudo localtonet --install-service --authtoken <YOUR_TOKEN>Klien menulis unit systemd ke /etc/systemd/system/<SERVICE_NAME>.service, mengaktifkannya, dan menjalankannya. Unit dimulai saat boot, dan systemd memulainya lagi lima detik setelah kegagalan.
Jika sudo tidak dapat menemukan localtonet, jalankan dengan path-nya, misalnya sudo ./localtonet dari folder yang berisinya.
Bila berhasil, klien mencetak nama layanan:
[CLI] Installed service 'Localtonet_AbCdEfGhI'Pemasangan juga memulai layanan, jadi tidak perlu perintah start terpisah. Sekarang Anda dapat membuat dan memulai tunnel untuk token ini di dasbor.
Nama layanan #
Layanan dinamai Localtonet_ diikuti sembilan karakter pertama token, misalnya Localtonet_AbCdEfGhI. Halaman ini menulisnya sebagai <SERVICE_NAME>. Karena nama berasal dari token, Anda dapat memasang satu layanan per token di perangkat yang sama, dan setiap perintah manajemen membutuhkan token yang sama untuk menemukan layanannya.
Yang dijalankan layanan #
Layanan menjalankan file localtonet yang sama dari lokasi yang sama, dengan opsi yang Anda berikan pada perintah pemasangan. Dua hal berikut ini konsekuensinya:
- Jangan pindahkan atau hapus file. Definisi layanan memuat path lengkapnya. Di Linux, jika file berada di dalam
/root, installer menyalinnya ke/usr/local/lib/<SERVICE_NAME>/dan layanan menjalankan salinan itu. - Opsi lain disimpan. Opsi seperti
--netdan--ipatau--proxy envpada perintah pemasangan disimpan di layanan dan dipakai pada setiap start. Lihat Referensi CLI.
Mengelola layanan #
Gunakan token yang sama dengan salah satu opsi ini. Di macOS dan Linux, awali dengan sudo. Di Windows, gunakan terminal Administrator untuk semuanya kecuali status.
| Perintah | Fungsinya | Keluaran saat berhasil |
|---|---|---|
localtonet --status-service --authtoken <YOUR_TOKEN> | Menampilkan status layanan. | [CLI] Service '<SERVICE_NAME>' status: Running |
localtonet --stop-service --authtoken <YOUR_TOKEN> | Menghentikan layanan. Tunnelnya menjadi offline. Layanan dimulai lagi pada boot berikutnya. | [CLI] Stopped service '<SERVICE_NAME>'. |
localtonet --start-service --authtoken <YOUR_TOKEN> | Memulai layanan yang berhenti. | [CLI] Started service '<SERVICE_NAME>'. |
localtonet --remove-service --authtoken <YOUR_TOKEN> | Menghentikan layanan dan menghapus pendaftarannya. File localtonet itu sendiri tetap ada. | [CLI] Removed service '<SERVICE_NAME>'. |
Status adalah salah satu nilai berikut:
| Status | Artinya |
|---|---|
Running | Layanan sedang berjalan. |
Stopped | Layanan terpasang tetapi tidak berjalan. |
Installing | Layanan sedang dimulai. |
NotFound | Tidak ada layanan yang terpasang untuk token ini. |
Paused | Hanya Windows: layanan dijeda. |
Error | Layanan gagal, atau statusnya tidak dapat dibaca. |
Unknown | Pengelola layanan mengembalikan status yang tidak dikenali klien. |
Anda juga dapat memakai alat sistem operasi dengan nama layanan:
Windows #
Buka services.msc dan cari <SERVICE_NAME>, atau gunakan sc di terminal Administrator:
sc query <SERVICE_NAME>
sc stop <SERVICE_NAME>
sc start <SERVICE_NAME>macOS
sudo launchctl print system/<SERVICE_NAME>Linux
systemctl status <SERVICE_NAME>
sudo systemctl restart <SERVICE_NAME>Tempat layanan terdaftar dan tempat lognya #
| Sistem | Pendaftaran | Log |
|---|---|---|
| Windows | Layanan Windows bernama <SERVICE_NAME>, tipe start otomatis, berjalan di bawah akun LocalSystem. | Layanan tidak memiliki jendela konsol dan installer tidak menyiapkan file log. Periksa status layanan, serta perangkat dan tunnelnya di dasbor. |
| macOS | /Library/LaunchDaemons/<SERVICE_NAME>.plist, job launchd tingkat sistem. | /var/log/<SERVICE_NAME>.out.log dan /var/log/<SERVICE_NAME>.err.log |
| Linux | /etc/systemd/system/<SERVICE_NAME>.service, diaktifkan untuk multi-user.target. | Jurnal systemd: journalctl -u <SERVICE_NAME> -f |
Layanan tidak mencetak tabel tunnel yang ditampilkan klien di terminal. Untuk status perangkat dan tunnelnya, gunakan dasbor.
Mengganti token #
Untuk mengganti token sebuah perangkat, hapus layanan dengan token lama lalu pasang lagi dengan token baru:
sudo localtonet --remove-service --authtoken <OLD_TOKEN>
sudo localtonet --install-service --authtoken <NEW_TOKEN>Hal yang perlu diketahui #
- Satu klien per token. Selama layanan berjalan, jangan memulai klien Localtonet lain dengan token yang sama, di perangkat ini maupun perangkat lain. Klien kedua yang terhubung dengan token itu memutus klien pertama.
- Memperbarui klien. Layanan terus menjalankan file yang ditunjuk definisinya. Hentikan layanan, ganti file itu dengan versi baru, lalu mulai layanan lagi.
- Kata sandi proxy tidak disimpan. Perintah pemasangan menolak URL proxy yang berisi kata sandi dan opsi
--proxy-user. Pasang dengan--proxy envdan atur variabel proxy di lingkungan layanan. - Terminal Perangkat. Jika perangkat menjalankan Localtonet sebagai layanan, jalankan
localtonet --terminal enabledari terminal Administrator atau dengansudo, agar layanan dapat memakai hasilnya. Lihat Terminal Perangkat.
Pemecahan masalah #
| Pesan | Penyebab dan solusi |
|---|---|
[CLI] Install failed: '…' requires elevated (admin/root) privileges. | Perintah dijalankan tanpa hak administrator. Buka terminal sebagai Administrator di Windows, atau gunakan sudo di macOS dan Linux. Di Windows dan Linux, pesan yang sama muncul untuk start, stop, dan hapus. |
[CLI] Install failed: diikuti Service '<SERVICE_NAME>' already exists. (Windows), Systemd unit already exists for … (Linux), atau Plist already exists for … (macOS) | Layanan untuk token ini sudah terpasang. Gunakan --start-service untuk memulainya, atau --remove-service terlebih dahulu bila Anda ingin memasangnya lagi. |
Service installation cannot persist proxy passwords. Use --proxy env and supply credentials in the service's runtime environment. | Perintah pemasangan memuat --proxy-user atau URL proxy dengan kata sandi. Gunakan --proxy env sebagai gantinya. |
[CLI] Start failed: … di Windows tepat setelah pemasangan | Layanan sudah berjalan, karena pemasangan memulainya. Periksa dengan --status-service. |
Status adalah NotFound | Tidak ada layanan untuk token yang Anda berikan. Pastikan itu token yang Anda pakai untuk memasang layanan. |
Status adalah Running tetapi perangkat offline di dasbor | Periksa tokennya: salin lagi dari Token Saya, hapus layanan, lalu pasang lagi. Pastikan juga tidak ada klien lain yang memakai token yang sama. |