İçeriğe geç
Localtonet Localtonet Panel

OpenWrt'ye Localtonet kurma

Deneysel OpenWrt 24.10 ve 25.12+ x64 ve ARM64

Bu sayfa için yardım al
Bu sayfada 12 bölüm
  1. Başlamadan önce
  2. Desteklenen sürümler ve mimariler
  3. Desteklenmeyenler
  4. Mimariyi kontrol edin
  5. OpenWrt 24.10 (opkg)
  6. Depolama ve bellek
  7. Paketin kurduğu dosyalar
  8. Token dosyası ve yapılandırma
  9. Token dosyası
  10. UCI yapılandırması
  11. Hizmet
  12. Günlükler
  13. Yükseltme ve kaldırma
  14. OpenWrt 24.10 (opkg)
  15. OpenWrt'de VPN
  16. Sorun giderme
  17. İ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çimiPaket yöneticisiMimariler
24.10IPKopkgx64, ARM64
25.12 ve sonrasıAPK v3apkx64, 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 update veya apk update ile 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) #

Bash
opkg print-architecture

OpenWrt 25.12+ (apk)

Bash
apk --print-arch

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

Bash
df -h
free
  • Flash (overlay). Program dosyaları /usr/lib/localtonet altı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/bundle altına açar. OpenWrt'de /tmp RAM'de tutulur; bu nedenle bu alan yönlendiricinin belleğinden gider.

Paketin kurduğu dosyalar #

YolNe olduğu
/usr/bin/localtonetlocaltonet komutu.
/usr/lib/localtonetProgram dosyaları.
/etc/localtonet/auth-tokenToken dosyası. Siz değiştirene kadar DUMMY_AUTH_TOKEN yer tutucusunu içerir. Yalnızca root okuyabilir.
/etc/config/localtonetHizmetin UCI yapılandırması.
/etc/init.d/localtonetHizmet 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:

/etc/config/localtonet
config localtonet 'main'
    option enabled '0'
    option token_file '/etc/localtonet/auth-token'
SeçenekNe yaparDeğerler
enabledHizmetin 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:

Bash
uci show localtonet

Hizmet #

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

KomutNe 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 disableHizmetin açılışta başlamasını durdurur.
/etc/init.d/localtonet enableHizmetin açılışta yeniden başlamasını sağlar.

İstemciyi kapatıp paketi kurulu tutmak için:

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

Bash
logread -e localtonet
logread -f -e localtonet
SatırAnlamı
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 missingHizmet 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) #

Bash
opkg remove localtonet

OpenWrt 25.12+ (apk)

Bash
apk del localtonet

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

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

    2. AuthToken'ınızı ayarlayın. /etc/localtonet/auth-token dosyasını root olarak düzenleyin ve DUMMY_AUTH_TOKEN değ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-config

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

    Yükseltmek için yeni paketi kurun ve /etc/init.d/localtonet restart komutunu ç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.ipk dosyası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.ipk

    2. AuthToken'ınızı ayarlayın. /etc/localtonet/auth-token dosyasını root olarak düzenleyin ve DUMMY_AUTH_TOKEN değ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-config

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

    Yükseltmek için yeni paketi kurun ve /etc/init.d/localtonet restart komutunu ç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.apk dosyası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-untrusted gerekir.

    apk --print-arch
    apk update
    apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk

    2. AuthToken'ınızı ayarlayın. /etc/localtonet/auth-token dosyasını root olarak düzenleyin ve DUMMY_AUTH_TOKEN değ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-config

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

    Yükseltmek için yeni paketi kurun ve /etc/init.d/localtonet restart komutunu ç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.apk dosyası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-untrusted gerekir.

    apk --print-arch
    apk update
    apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk

    2. AuthToken'ınızı ayarlayın. /etc/localtonet/auth-token dosyasını root olarak düzenleyin ve DUMMY_AUTH_TOKEN değ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-config

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

    Yükseltmek için yeni paketi kurun ve /etc/init.d/localtonet restart komutunu ç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.

Bu sayfa için yardıma mı ihtiyacınız var? Topluluğa sorun veya bir destek talebi açın.

Destek