OpenWrt'ye Localtonet kurma
Deneysel OpenWrt 24.10 ve 25.12+ x64 ve ARM64
Bu sayfada 12 bölüm
- Başlamadan önce
- Desteklenen sürümler ve mimariler
- Desteklenmeyenler
- Mimariyi kontrol edin
- OpenWrt 24.10 (opkg)
- Depolama ve bellek
- Paketin kurduğu dosyalar
- Token dosyası ve yapılandırma
- Token dosyası
- UCI yapılandırması
- Hizmet
- Günlükler
- Yükseltme ve kaldırma
- OpenWrt 24.10 (opkg)
- OpenWrt'de VPN
- Sorun giderme
- İlgili sayfalar
Localtonet istemcisini doğrudan bir OpenWrt yönlendiricide çalıştırın. Paket; istemciyi, bir token dosyasını, bir UCI yapılandırmasını ve yönlendirici ile birlikte başlayan bir hizmeti kurar.
OpenWrt paketleri deneyseldir. Bunlar imzalı bir OpenWrt paket kaynağından gelen paketler değil, elle kurduğunuz imzasız dosyalardır. Güvenmeden önce yazılım sürümü uyumluluğunu, tünellerinizi ve VPN'i kendi cihazınızda kontrol edin.
Başlamadan önce #
- Desteklenen bir OpenWrt sürümüne ve CPU mimarisine sahip bir yönlendirici (bir sonraki bölüme bakın).
- Yönlendiriciye SSH ile root erişimi.
- Kurulum sırasında yönlendiricide internet erişimi. Paket yöneticisi bağımlılıkları yazılımınızın kendi paket kaynaklarından indirir.
- Yeterli boş depolama alanı ve bellek (bkz. Depolama ve bellek).
- Token'larım sayfasından, başka bir cihazın kullanmadığı bir AuthToken.
Desteklenen sürümler ve mimariler #
OpenWrt sürümler arasında paket yöneticisini değiştirdiği için iki paket biçimi vardır. Yazılımınıza uygun olanı seçin:
| OpenWrt sürümü | Paket biçimi | Paket yöneticisi | Mimariler |
|---|---|---|---|
| 24.10 | IPK | opkg | x64, ARM64 |
| 25.12 ve sonrası | APK v3 | apk | x64, ARM64 |
Burada APK bir OpenWrt paketi anlamına gelir. Bu .apk dosyaları Android uygulaması değildir ve bir telefona kurulamaz. Android için bkz. Android.
Desteklenmeyenler #
- MIPS, MIPSEL ve ARMv7 yönlendiriciler. Bu mimariler için paket yoktur.
- Paket kaynağından kurulum. Paketler yerel dosyalardır; yönlendiriciniz bunları
opkg updateveyaapk updateile bulamaz ya da güncelleyemez. - Bir paketi farklı bir mimariye zorlamak. Paket yöneticisinin mimari denetimini asla atlamayın.
Mimariyi kontrol edin #
Paketin mimarisi yazılımınızla eşleşmelidir. Yönlendiriciye hangi mimarileri kabul ettiğini sorun:
OpenWrt 24.10 (opkg) #
opkg print-architectureOpenWrt 25.12+ (apk)
apk --print-archBir x64 yönlendirici x86_64 bildirir. ARM64 yönlendiriciler aarch64_ ile başlayan bir ad bildirir ve bu ad yazılım derlemeleri arasında farklılık gösterir. Her paket, derlendiği tam paket mimarisini belirten kısa bir talimat dosyasıyla birlikte gelir; örneğin x86_64 veya aarch64_generic. İndirmeler sayfasında OpenWrt altından paketinizi seçin ve okumak için Paket kurulum talimatları bağlantısını açın. Bu mimariyi yönlendiricinizin bildirdiğiyle karşılaştırın. Eşleşmiyorsa paketi kurmayın.
Depolama ve bellek #
Paket, istemciyi kendi çalışma zamanıyla birlikte içerir; bu nedenle tipik bir OpenWrt paketinden çok daha büyüktür. Kurmadan önce yönlendiriciyi kontrol edin:
df -h
free- Flash (overlay). Program dosyaları
/usr/lib/localtonetaltına kurulur. Küçük bir flash çipine sahip bir yönlendirici, bunları sığdırmak için extroot (kök overlay olarak harici depolama) gerektirebilir. - RAM ve
/tmp. İstemci başladığında yerel kitaplıklarını/tmp/localtonet/bundlealtına açar. OpenWrt'de/tmpRAM'de tutulur; bu nedenle bu alan yönlendiricinin belleğinden gider.
Paketin kurduğu dosyalar #
| Yol | Ne olduğu |
|---|---|
/usr/bin/localtonet | localtonet komutu. |
/usr/lib/localtonet | Program dosyaları. |
/etc/localtonet/auth-token | Token dosyası. Siz değiştirene kadar DUMMY_AUTH_TOKEN yer tutucusunu içerir. Yalnızca root okuyabilir. |
/etc/config/localtonet | Hizmetin UCI yapılandırması. |
/etc/init.d/localtonet | Hizmet betiği (procd). |
Paket şunlara bağımlıdır: libc, libgcc1, libstdcpp6, libopenssl3, zlib, ca-bundle, kmod-tun, ip-full, bash, iptables-nft ve ip6tables-nft. Paket yöneticisi eksik olanları yazılımınızın paket kaynaklarından kurar; kurulum talimatlarının önce paket listelerini yenilemesinin nedeni budur. kmod-tun, kurulu yazılımın çekirdeğiyle eşleşmelidir; bu nedenle onu her zaman o yazılımın kendi paket kaynaklarından alın.
Token dosyası ve yapılandırma #
Paketi kurmak hiçbir şeyi bağlamaz. Hizmet, iki şeyi yapana kadar kapalı kalır: token'ınızı token dosyasına koymak ve hizmeti UCI'da etkinleştirmek. Paketiniz için tam komutlar bu sayfanın sonundaki Kurulum talimatları bölümündedir; bu bölüm onların ne yaptığını açıklar.
Token dosyası #
/etc/localtonet/auth-token, AuthToken'ınızı tek satırda tutar ve başka hiçbir şey içermez. DUMMY_AUTH_TOKEN yer tutucusunu token'ınızla değiştirin; örneğin vi ile. Dosyayı yalnızca root okuyabilecek şekilde tutun (mod 600).
Kurulum talimatları ardından istemciyi bir kez --headless --authtoken-file /etc/localtonet/auth-token --check-config ile çalıştırır. Bu, Localtonet'e bağlanmadan dosyayı denetler:
| Çıktı | Anlamı |
|---|---|
Localtonet headless configuration OK. | Dosya, düzgün biçimli bir token içeriyor: 33 karakter, boşluk yok. Denetim, token'ın hesabınız için geçerli olduğunu kanıtlamaz. |
Invalid Localtonet headless configuration. Check the token file or environment settings. | Dosya yok, hâlâ yer tutucuyu içeriyor veya token 33 karakter uzunluğunda değil. |
UCI yapılandırması #
Hizmet ayarlarını /etc/config/localtonet dosyasından okur. Yeni bir kurulum şunu içerir:
config localtonet 'main'
option enabled '0'
option token_file '/etc/localtonet/auth-token'| Seçenek | Ne yapar | Değerler |
|---|---|---|
enabled | Hizmetin istemciyi başlatıp başlatmadığı. 0 iken hizmeti başlatmak hiçbir şey yapmaz. | 0 (varsayılan) veya 1 |
token_file | İstemcinin token'ı okuduğu dosyanın yolu. | Varsayılan /etc/localtonet/auth-token |
Geçerli değerleri istediğiniz zaman gösterin:
uci show localtonetHizmet #
İstemci, localtonet adlı bir procd hizmeti olarak çalışır. Paketi kurmak onu açılışta başlayacak şekilde kaydeder, ancak istemciyi yalnızca enabled değeri 1 olduğunda ve token dosyası boş olmadığında başlatır. enabled değerini 1 yapıp değişikliği uyguladıktan (commit) sonra hizmeti bir kez yeniden başlatın; bundan sonra yönlendirici ile birlikte başlar.
| Komut | Ne yapar |
|---|---|
/etc/init.d/localtonet restart | İstemciyi durdurur ve başlatır. Token dosyasını veya yapılandırmayı değiştirdikten sonra çalıştırın. |
/etc/init.d/localtonet stop | İstemciyi bir sonraki yeniden başlatmaya veya yeniden açılışa kadar durdurur. |
/etc/init.d/localtonet disable | Hizmetin açılışta başlamasını durdurur. |
/etc/init.d/localtonet enable | Hizmetin açılışta yeniden başlamasını sağlar. |
İstemciyi kapatıp paketi kurulu tutmak için:
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restartİstemci beklenmedik biçimde durursa procd onu yeniden başlatır.
İstemci bağlandıktan sonra panelde yönlendiricinin token'ı ile tüneller oluşturun ve başlatın. Bir tünelin Yerel IP adresi, yönlendiricinin kendisindeki bir hizmet için 127.0.0.1 veya yönlendiricinin arkasındaki herhangi bir cihazın yerel ağ adresi olabilir; örneğin 192.168.1.20.
Günlükler #
İstemci, OpenWrt sistem günlüğüne yazar. Satırlarını gösterin veya canlı izleyin:
logread -e localtonet
logread -f -e localtonet| Satır | Anlamı |
|---|---|
Localtonet - headless log | İstemci başladı. |
Connection: … | Localtonet bağlantısının durumu. |
AuthTokenName: … | Yönlendiricinin oturum açtığı token'ın adı. |
OPEN …, ADDED …, STATUS …, CLOSED … | Bu token'a ait bir tünel bulundu, eklendi, durumu değişti veya kaldırıldı. |
Authentication failed: AuthToken was rejected. | Localtonet, token dosyasındaki token'ı kabul etmedi. |
AuthToken file missing | Hizmet etkin, ancak token dosyası yok veya boş. |
Yükseltme ve kaldırma #
Yükseltmek için daha yeni paketi eskisinin üzerine kurun ve hizmeti yeniden başlatın. Token dosyası ve UCI yapılandırması korunur. Her iki dosya da OpenWrt'nin bir yazılım yükseltmesi sırasında koruduğu dosyalar listesindedir; ancak yeni yazılımı yazdıktan sonra paketin kendisinin yeniden kurulması gerekir.
İstemciyi kaldırmak için:
OpenWrt 24.10 (opkg) #
opkg remove localtonetOpenWrt 25.12+ (apk)
apk del localtonetPaketi kaldırmak hizmeti durdurur ve açılış sırasından çıkarır.
OpenWrt'de VPN #
Paket, VPN özelliğinin yönlendiricide ihtiyaç duyduğu bileşenleri getirir: kmod-tun, ip-full, bash, iptables-nft ve ip6tables-nft. Yönlendirme ve güvenlik duvarı davranışı yazılımınıza ve kendi güvenlik duvarı kurallarınıza bağlıdır; bu nedenle VPN'e güvenmeden önce cihazınızda test edin. Özelliğin kendisi için bkz. VPN Yöneticisi.
Sorun giderme #
Paket yöneticisi paketi mimari nedeniyle reddediyor
Paket, yazılımınızdan farklı bir mimari için derlenmiş. opkg print-architecture veya apk --print-arch çıktısını, paketin talimat dosyasında (İndirmeler sayfasındaki Paket kurulum talimatları) belirtilen mimariyle karşılaştırın. Kurulumu zorlamayın. MIPS, MIPSEL ve ARMv7 yönlendiriciler desteklenmez.
apk, dosyayı güvenilmez diye kurmayı reddediyor
APK paketleri imzasız yerel dosyalardır. Kurmak için, paketin kurulum talimatlarında gösterildiği gibi --allow-untrusted seçeneği gerekir.
Bir bağımlılık bulunamadığı için kurulum başarısız oluyor
Önce paket listelerini yenileyin (opkg update veya apk update) ve yönlendiricinin internet erişimi olduğundan emin olun. Bağımlılıklar yazılımınızın kendi paket kaynaklarından gelir.
Hizmet etkin ama günlükte hiçbir şey görünmüyor
uci show localtonet komutunu kontrol edin. enabled hâlâ 0 ise 1 yapın, değişikliği uygulayın ve hizmeti yeniden başlatın. Günlükte AuthToken file missing görünüyorsa token'ınızı token_file ile belirtilen dosyaya koyun.
İstemci başlamıyor veya yönlendiricinin belleği tükeniyor
Boş flash alanını ve belleği df -h ve free ile kontrol edin. İstemcinin /usr/lib/localtonet altında ve /tmp içinde yere ihtiyacı vardır.
İlgili sayfalar #
OpenWrt
Deneysel. OpenWrt 24.10 için IPK'yı, 25.12+ için APK v3'ü seçin. Bu APK dosyaları Android uygulaması değil, OpenWrt paketleridir.
Yalnızca x64 ve ARM64. Paket mimarisi donanım yazılımınızla eşleşmelidir; paketin kurulum talimatlarını ve opkg print-architecture ya da apk --print-arch çıktısını kontrol edin. MIPS, MIPSEL ve ARMv7 bu paketlerle desteklenmez. Kurmadan önce kullanılabilir depolama alanını ve RAM'i kontrol edin.
-
OpenWrt 24.10 · x64 · IPK
Kurulum talimatları
1. İndirilen paketi kurun.
localtonet-openwrt-24.10-x64.ipkdosyasının bulunduğu dizinde bir terminal açın.Bu komutları yönlendiricide root olarak çalıştırın. Kurmadan önce paket mimarisinin donanım yazılımınızla eşleştiğini doğrulayın.
opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-x64.ipk2. AuthToken'ınızı ayarlayın.
/etc/localtonet/auth-tokendosyasını root olarak düzenleyin veDUMMY_AUTH_TOKENdeğerini tek satırda kendi token'ınızla değiştirin. Ardından dosyayı koruma altına alın ve yapılandırmayı kontrol edin:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Hizmeti başlatın. Yapılandırma kontrolü başarılı olduktan sonra:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetYükseltmek için yeni paketi kurun ve
/etc/init.d/localtonet restartkomutunu çalıştırın. Yapılandırmanız korunur. -
OpenWrt 24.10 · ARM64 · IPK
Kurulum talimatları
1. İndirilen paketi kurun.
localtonet-openwrt-24.10-arm64.ipkdosyasının bulunduğu dizinde bir terminal açın.Bu komutları yönlendiricide root olarak çalıştırın. Kurmadan önce paket mimarisinin donanım yazılımınızla eşleştiğini doğrulayın.
opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-arm64.ipk2. AuthToken'ınızı ayarlayın.
/etc/localtonet/auth-tokendosyasını root olarak düzenleyin veDUMMY_AUTH_TOKENdeğerini tek satırda kendi token'ınızla değiştirin. Ardından dosyayı koruma altına alın ve yapılandırmayı kontrol edin:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Hizmeti başlatın. Yapılandırma kontrolü başarılı olduktan sonra:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetYükseltmek için yeni paketi kurun ve
/etc/init.d/localtonet restartkomutunu çalıştırın. Yapılandırmanız korunur. -
OpenWrt 25.12+ · x64 · APK v3
Kurulum talimatları
1. İndirilen paketi kurun.
localtonet-openwrt-25.12-x64.apkdosyasının bulunduğu dizinde bir terminal açın.Bu komutları yönlendiricide root olarak çalıştırın. Kurmadan önce paket mimarisinin donanım yazılımınızla eşleştiğini doğrulayın.
Bu yerel APK paketi imzasızdır; bu nedenle kurulum için
--allow-untrustedgerekir.apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk2. AuthToken'ınızı ayarlayın.
/etc/localtonet/auth-tokendosyasını root olarak düzenleyin veDUMMY_AUTH_TOKENdeğerini tek satırda kendi token'ınızla değiştirin. Ardından dosyayı koruma altına alın ve yapılandırmayı kontrol edin:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Hizmeti başlatın. Yapılandırma kontrolü başarılı olduktan sonra:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetYükseltmek için yeni paketi kurun ve
/etc/init.d/localtonet restartkomutunu çalıştırın. Yapılandırmanız korunur. -
OpenWrt 25.12+ · ARM64 · APK v3
Kurulum talimatları
1. İndirilen paketi kurun.
localtonet-openwrt-25.12-arm64.apkdosyasının bulunduğu dizinde bir terminal açın.Bu komutları yönlendiricide root olarak çalıştırın. Kurmadan önce paket mimarisinin donanım yazılımınızla eşleştiğini doğrulayın.
Bu yerel APK paketi imzasızdır; bu nedenle kurulum için
--allow-untrustedgerekir.apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk2. AuthToken'ınızı ayarlayın.
/etc/localtonet/auth-tokendosyasını root olarak düzenleyin veDUMMY_AUTH_TOKENdeğerini tek satırda kendi token'ınızla değiştirin. Ardından dosyayı koruma altına alın ve yapılandırmayı kontrol edin:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Hizmeti başlatın. Yapılandırma kontrolü başarılı olduktan sonra:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetYükseltmek için yeni paketi kurun ve
/etc/init.d/localtonet restartkomutunu çalıştırın. Yapılandırmanız korunur.
Kurmadan önce paketinize ait kurulum talimatlarını okuyun. Paketler imzasızdır; donanım yazılımı uyumluluğu, tüneller ve VPN hedef cihazda doğrulanmalıdır. Uyumsuz bir mimariyi asla zorlamayın.