Memasang Localtonet di OpenWrt
Eksperimental OpenWrt 24.10 dan 25.12+ x64 dan ARM64
Di halaman ini 12 bagian
- Sebelum memulai
- Versi dan arsitektur yang didukung
- Yang tidak didukung
- Periksa arsitektur
- OpenWrt 24.10 (opkg)
- Penyimpanan dan memori
- Yang dipasang oleh paket
- File token dan konfigurasi
- File token
- Konfigurasi UCI
- Layanan
- Log
- Upgrade dan penghapusan
- OpenWrt 24.10 (opkg)
- VPN di OpenWrt
- Pemecahan masalah
- Halaman terkait
Jalankan klien Localtonet langsung di router OpenWrt. Paket ini memasang klien, file token, konfigurasi UCI, dan layanan yang berjalan bersama router.
Paket OpenWrt masih eksperimental. Paket ini adalah file tanpa tanda tangan yang Anda pasang secara manual, bukan paket dari feed OpenWrt yang bertanda tangan. Periksa kompatibilitas firmware, tunnel, dan VPN di perangkat Anda sendiri sebelum mengandalkannya.
Sebelum memulai #
- Router dengan versi OpenWrt dan arsitektur CPU yang didukung (lihat bagian berikutnya).
- Akses root ke router melalui SSH.
- Akses internet di router selama pemasangan. Pengelola paket mengunduh dependensi dari feed paket milik firmware Anda sendiri.
- Penyimpanan dan memori kosong yang cukup (lihat Penyimpanan dan memori).
- Sebuah AuthToken dari Token Saya yang tidak dipakai perangkat lain.
Versi dan arsitektur yang didukung #
OpenWrt mengganti pengelola paketnya antarrilis, sehingga ada dua format paket. Pilih yang sesuai dengan firmware Anda:
| Versi OpenWrt | Format paket | Pengelola paket | Arsitektur |
|---|---|---|---|
| 24.10 | IPK | opkg | x64, ARM64 |
| 25.12 dan yang lebih baru | APK v3 | apk | x64, ARM64 |
APK di sini berarti paket OpenWrt. File .apk ini bukan aplikasi Android dan tidak dapat dipasang di ponsel. Untuk Android, lihat Android.
Yang tidak didukung #
- Router MIPS, MIPSEL, dan ARMv7. Tidak ada paket untuk arsitektur ini.
- Pemasangan dari feed paket. Paketnya adalah file lokal; router Anda tidak menemukan atau memperbaruinya melalui
opkg updateatauapk update. - Memaksakan paket ke arsitektur yang berbeda. Jangan pernah menimpa pemeriksaan arsitektur pada pengelola paket.
Periksa arsitektur #
Arsitektur paket harus cocok dengan firmware Anda. Tanyakan kepada router arsitektur apa yang diterimanya:
OpenWrt 24.10 (opkg) #
opkg print-architectureOpenWrt 25.12+ (apk)
apk --print-archRouter x64 melaporkan x86_64. Router ARM64 melaporkan nama yang diawali aarch64_, dan nama itu berbeda antarbuild firmware. Setiap paket dilengkapi file petunjuk singkat yang menyebutkan arsitektur paket persis yang dipakai saat membangunnya, misalnya x86_64 atau aarch64_generic. Di halaman Unduhan, pilih paket Anda di bawah OpenWrt dan buka Petunjuk penyiapan paket untuk membacanya. Bandingkan arsitektur itu dengan yang dilaporkan router Anda. Jika tidak cocok, jangan pasang paketnya.
Penyimpanan dan memori #
Paket ini berisi klien beserta runtime-nya sendiri, sehingga ukurannya jauh lebih besar daripada paket OpenWrt pada umumnya. Periksa router sebelum memasang:
df -h
free- Flash (overlay). File program dipasang di
/usr/lib/localtonet. Router dengan chip flash kecil mungkin memerlukan extroot (penyimpanan eksternal sebagai root overlay) agar muat. - RAM dan
/tmp. Saat klien dimulai, klien mengekstrak pustaka native-nya ke/tmp/localtonet/bundle. Di OpenWrt/tmpberada di RAM, sehingga ruang ini diambil dari memori router.
Yang dipasang oleh paket #
| Path | Apa itu |
|---|---|
/usr/bin/localtonet | Perintah localtonet. |
/usr/lib/localtonet | File program. |
/etc/localtonet/auth-token | File token. Berisi placeholder DUMMY_AUTH_TOKEN sampai Anda menggantinya. Hanya dapat dibaca oleh root. |
/etc/config/localtonet | Konfigurasi UCI untuk layanan. |
/etc/init.d/localtonet | Skrip layanan (procd). |
Paket ini bergantung pada libc, libgcc1, libstdcpp6, libopenssl3, zlib, ca-bundle, kmod-tun, ip-full, bash, iptables-nft, dan ip6tables-nft. Pengelola paket memasang yang belum ada dari feed firmware Anda, itulah sebabnya petunjuk penyiapan menyegarkan daftar paket terlebih dahulu. kmod-tun harus cocok dengan kernel firmware yang terpasang, jadi selalu ambil dari feed firmware tersebut.
File token dan konfigurasi #
Memasang paket tidak menghubungkan apa pun. Layanan tetap mati sampai Anda melakukan dua hal: memasukkan token ke file token dan mengaktifkan layanan di UCI. Perintah persis untuk paket Anda ada di Petunjuk penyiapan di akhir halaman ini; bagian ini menjelaskan apa yang dilakukannya.
File token #
/etc/localtonet/auth-token berisi AuthToken Anda dalam satu baris dan tidak ada yang lain. Ganti placeholder DUMMY_AUTH_TOKEN dengan token Anda, misalnya dengan vi. Pertahankan agar file hanya dapat dibaca oleh root (mode 600).
Petunjuk penyiapan kemudian menjalankan klien sekali dengan --headless --authtoken-file /etc/localtonet/auth-token --check-config. Ini memeriksa file tanpa terhubung ke Localtonet:
| Output | Arti |
|---|---|
Localtonet headless configuration OK. | File berisi token yang bentuknya benar: 33 karakter, tanpa spasi. Pemeriksaan ini tidak membuktikan bahwa token valid untuk akun Anda. |
Invalid Localtonet headless configuration. Check the token file or environment settings. | File tidak ada, masih berisi placeholder, atau token tidak sepanjang 33 karakter. |
Konfigurasi UCI #
Layanan membaca pengaturannya dari /etc/config/localtonet. Instalasi baru berisi:
config localtonet 'main'
option enabled '0'
option token_file '/etc/localtonet/auth-token'| Opsi | Fungsinya | Nilai |
|---|---|---|
enabled | Apakah layanan menjalankan klien. Selama bernilai 0, menjalankan layanan tidak melakukan apa pun. | 0 (bawaan) atau 1 |
token_file | Path file tempat klien membaca token. | Bawaan /etc/localtonet/auth-token |
Tampilkan nilai saat ini kapan saja:
uci show localtonetLayanan #
Klien berjalan sebagai layanan procd bernama localtonet. Memasang paket mendaftarkannya agar berjalan saat boot, tetapi layanan hanya menjalankan klien jika enabled bernilai 1 dan file token tidak kosong. Setelah Anda mengatur enabled ke 1 dan melakukan commit, mulai ulang layanan satu kali; setelah itu layanan berjalan bersama router.
| Perintah | Fungsinya |
|---|---|
/etc/init.d/localtonet restart | Menghentikan dan menjalankan klien. Jalankan setelah Anda mengubah file token atau konfigurasi. |
/etc/init.d/localtonet stop | Menghentikan klien sampai restart atau reboot berikutnya. |
/etc/init.d/localtonet disable | Berhenti menjalankan layanan saat boot. |
/etc/init.d/localtonet enable | Menjalankan layanan saat boot lagi. |
Untuk mematikan klien tetapi tetap memasang paketnya:
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restartJika klien berhenti tiba-tiba, procd menjalankannya lagi.
Setelah klien terhubung, buat dan jalankan tunnel di dasbor dengan token router. Alamat IP lokal tunnel dapat berupa 127.0.0.1 untuk layanan di router itu sendiri, atau alamat LAN perangkat mana pun di belakang router, misalnya 192.168.1.20.
Log #
Klien menulis ke log sistem OpenWrt. Tampilkan barisnya, atau ikuti secara langsung:
logread -e localtonet
logread -f -e localtonet| Baris | Arti |
|---|---|
Localtonet - headless log | Klien telah dimulai. |
Connection: … | Status koneksi ke Localtonet. |
AuthTokenName: … | Nama token yang dipakai router untuk masuk. |
OPEN …, ADDED …, STATUS …, CLOSED … | Sebuah tunnel milik token ini ditemukan, ditambahkan, berubah status, atau dihapus. |
Authentication failed: AuthToken was rejected. | Localtonet tidak menerima token di file token. |
AuthToken file missing | Layanan sudah diaktifkan, tetapi file token tidak ada atau kosong. |
Upgrade dan penghapusan #
Untuk upgrade, pasang paket yang lebih baru di atas yang lama lalu mulai ulang layanan. File token dan konfigurasi UCI dipertahankan. Kedua file itu juga ada di daftar file yang dipertahankan OpenWrt saat upgrade firmware, tetapi paketnya sendiri harus dipasang lagi setelah Anda mem-flash firmware baru.
Untuk menghapus klien:
OpenWrt 24.10 (opkg) #
opkg remove localtonetOpenWrt 25.12+ (apk)
apk del localtonetMenghapus paket menghentikan layanan dan mengeluarkannya dari urutan boot.
VPN di OpenWrt #
Paket ini menarik semua yang dibutuhkan fitur VPN di router: kmod-tun, ip-full, bash, iptables-nft, dan ip6tables-nft. Perilaku routing dan firewall bergantung pada firmware dan aturan firewall Anda sendiri, jadi uji VPN di perangkat Anda sebelum bergantung padanya. Lihat Manajer VPN untuk fiturnya sendiri.
Pemecahan masalah #
Pengelola paket menolak paket karena arsitekturnya
Paket dibangun untuk arsitektur yang berbeda dari firmware Anda. Bandingkan output opkg print-architecture atau apk --print-arch dengan arsitektur yang disebut di file petunjuk paket (Petunjuk penyiapan paket di halaman Unduhan). Jangan paksa pemasangan. Router MIPS, MIPSEL, dan ARMv7 tidak didukung.
apk menolak memasang file karena tidak tepercaya
Paket APK adalah file lokal tanpa tanda tangan. Memasangnya memerlukan opsi --allow-untrusted, seperti yang ditunjukkan di petunjuk penyiapan paket.
Pemasangan gagal karena dependensi tidak ditemukan
Segarkan daftar paket terlebih dahulu (opkg update atau apk update) dan pastikan router memiliki akses internet. Dependensi berasal dari feed firmware Anda sendiri.
Layanan sudah diaktifkan tetapi tidak ada yang muncul di log
Periksa uci show localtonet. Jika enabled masih 0, ubah ke 1, commit, dan mulai ulang layanan. Jika log menampilkan AuthToken file missing, masukkan token Anda ke file yang disebut oleh token_file.
Klien tidak berjalan atau router kehabisan memori
Periksa ruang flash dan memori yang tersisa dengan df -h dan free. Klien memerlukan ruang di bawah /usr/lib/localtonet dan di /tmp.
Halaman terkait #
OpenWrt
Eksperimental. Pilih IPK untuk OpenWrt 24.10 atau APK v3 untuk 25.12+. File APK ini adalah paket OpenWrt, bukan aplikasi Android.
Hanya x64 dan ARM64. Arsitektur paket harus sesuai dengan firmware Anda; periksa petunjuk penyiapan paket dan opkg print-architecture atau apk --print-arch. MIPS, MIPSEL, dan ARMv7 tidak didukung oleh paket ini. Periksa ruang penyimpanan dan RAM yang tersedia sebelum menginstal.
-
OpenWrt 24.10 · x64 · IPK
Petunjuk penyiapan
1. Instal paket yang telah diunduh. Buka terminal di direktori yang berisi
localtonet-openwrt-24.10-x64.ipk.Jalankan perintah ini di router sebagai root. Pastikan arsitektur paket sesuai dengan firmware Anda sebelum menginstal.
opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-x64.ipk2. 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:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Jalankan service. Setelah pemeriksaan konfigurasi berhasil:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetUntuk memperbarui, instal paket baru dan jalankan
/etc/init.d/localtonet restart. Konfigurasi Anda tetap dipertahankan. -
OpenWrt 24.10 · ARM64 · IPK
Petunjuk penyiapan
1. Instal paket yang telah diunduh. Buka terminal di direktori yang berisi
localtonet-openwrt-24.10-arm64.ipk.Jalankan perintah ini di router sebagai root. Pastikan arsitektur paket sesuai dengan firmware Anda sebelum menginstal.
opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-arm64.ipk2. 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:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Jalankan service. Setelah pemeriksaan konfigurasi berhasil:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetUntuk memperbarui, instal paket baru dan jalankan
/etc/init.d/localtonet restart. Konfigurasi Anda tetap dipertahankan. -
OpenWrt 25.12+ · x64 · APK v3
Petunjuk penyiapan
1. Instal paket yang telah diunduh. Buka terminal di direktori yang berisi
localtonet-openwrt-25.12-x64.apk.Jalankan perintah ini di router sebagai root. Pastikan arsitektur paket sesuai dengan firmware Anda sebelum menginstal.
Paket APK lokal ini tidak ditandatangani, sehingga instalasi memerlukan
--allow-untrusted.apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk2. 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:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Jalankan service. Setelah pemeriksaan konfigurasi berhasil:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetUntuk memperbarui, instal paket baru dan jalankan
/etc/init.d/localtonet restart. Konfigurasi Anda tetap dipertahankan. -
OpenWrt 25.12+ · ARM64 · APK v3
Petunjuk penyiapan
1. Instal paket yang telah diunduh. Buka terminal di direktori yang berisi
localtonet-openwrt-25.12-arm64.apk.Jalankan perintah ini di router sebagai root. Pastikan arsitektur paket sesuai dengan firmware Anda sebelum menginstal.
Paket APK lokal ini tidak ditandatangani, sehingga instalasi memerlukan
--allow-untrusted.apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk2. 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:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Jalankan service. Setelah pemeriksaan konfigurasi berhasil:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetUntuk memperbarui, instal paket baru dan jalankan
/etc/init.d/localtonet restart. Konfigurasi Anda tetap dipertahankan.
Baca petunjuk penyiapan untuk paket Anda sebelum menginstal. Paket tidak ditandatangani; kompatibilitas firmware, tunnel, dan VPN perlu diuji pada perangkat yang dituju. Jangan pernah memaksakan arsitektur yang tidak sesuai.