Langsung ke konten
Localtonet Localtonet Dasbor

Memasang Localtonet di OpenWrt

Eksperimental OpenWrt 24.10 dan 25.12+ x64 dan ARM64

Bantuan untuk halaman ini
Di halaman ini 12 bagian
  1. Sebelum memulai
  2. Versi dan arsitektur yang didukung
  3. Yang tidak didukung
  4. Periksa arsitektur
  5. OpenWrt 24.10 (opkg)
  6. Penyimpanan dan memori
  7. Yang dipasang oleh paket
  8. File token dan konfigurasi
  9. File token
  10. Konfigurasi UCI
  11. Layanan
  12. Log
  13. Upgrade dan penghapusan
  14. OpenWrt 24.10 (opkg)
  15. VPN di OpenWrt
  16. Pemecahan masalah
  17. 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 OpenWrtFormat paketPengelola paketArsitektur
24.10IPKopkgx64, ARM64
25.12 dan yang lebih baruAPK v3apkx64, 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 update atau apk 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) #

Bash
opkg print-architecture

OpenWrt 25.12+ (apk)

Bash
apk --print-arch

Router 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:

Bash
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 /tmp berada di RAM, sehingga ruang ini diambil dari memori router.

Yang dipasang oleh paket #

PathApa itu
/usr/bin/localtonetPerintah localtonet.
/usr/lib/localtonetFile program.
/etc/localtonet/auth-tokenFile token. Berisi placeholder DUMMY_AUTH_TOKEN sampai Anda menggantinya. Hanya dapat dibaca oleh root.
/etc/config/localtonetKonfigurasi UCI untuk layanan.
/etc/init.d/localtonetSkrip 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:

OutputArti
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:

/etc/config/localtonet
config localtonet 'main'
    option enabled '0'
    option token_file '/etc/localtonet/auth-token'
OpsiFungsinyaNilai
enabledApakah layanan menjalankan klien. Selama bernilai 0, menjalankan layanan tidak melakukan apa pun.0 (bawaan) atau 1
token_filePath file tempat klien membaca token.Bawaan /etc/localtonet/auth-token

Tampilkan nilai saat ini kapan saja:

Bash
uci show localtonet

Layanan #

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.

PerintahFungsinya
/etc/init.d/localtonet restartMenghentikan dan menjalankan klien. Jalankan setelah Anda mengubah file token atau konfigurasi.
/etc/init.d/localtonet stopMenghentikan klien sampai restart atau reboot berikutnya.
/etc/init.d/localtonet disableBerhenti menjalankan layanan saat boot.
/etc/init.d/localtonet enableMenjalankan layanan saat boot lagi.

Untuk mematikan klien tetapi tetap memasang paketnya:

Bash
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restart

Jika 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:

Bash
logread -e localtonet
logread -f -e localtonet
BarisArti
Localtonet - headless logKlien 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 missingLayanan 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) #

Bash
opkg remove localtonet

OpenWrt 25.12+ (apk)

Bash
apk del localtonet

Menghapus 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.

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.ipk

    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:

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

    3. 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 localtonet

    Untuk 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.ipk

    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:

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

    3. 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 localtonet

    Untuk 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.apk

    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:

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

    3. 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 localtonet

    Untuk 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.apk

    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:

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

    3. 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 localtonet

    Untuk 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.

Dukungan