İçeriğe geç
Localtonet Localtonet Panel

Localtonet'i bir DEB veya RPM paketinden kurma

Bu sayfa için yardım al
Bu sayfada 9 bölüm
  1. Başlamadan önce
  2. Paketin kurduğu dosyalar
  3. Adımlar
  4. Paketi indirip kurun
  5. AuthToken'ınızı ayarlayın
  6. Yapılandırmayı kontrol edin
  7. Bir hizmeti etkinleştirin
  8. Bir tünel başlatın
  9. Tünel hizmeti veya VPN hizmeti
  10. Hizmetlerin çalışma biçimi
  11. Günlüğü okuma
  12. Yükseltme
  13. Kaldırma
  14. Sorun giderme
  15. İlgili sayfalar

DEB ve RPM paketleri Localtonet istemcisini iki systemd hizmetiyle birlikte kurar: biri tüneller, diğeri tüneller ve VPN içindir. Hizmetler AuthToken'ınızı bir dosyadan okur ve terminal olmadan çalışır; böylece istemci her açılışta başlar.

Başlamadan önce #

  • 64 bit bir Linux sistemi: paketler x64 ve ARM64 için vardır.
  • systemd 247 veya daha yeni ve OpenSSL 3; örneğin Debian 12, Ubuntu 22.04+ veya RHEL 9.
  • Root erişimi (sudo).
  • AuthToken'ınız. Panel'deki AuthToken kartında Kopyala düğmesini seçin veya Token'larım sayfasından bir token kopyalayın.

Diğer dağıtımlarda, 32 bit ARM'de veya sistem paketi istemediğinizde Linux sayfasında anlatılan kurulum betiğini veya arşivleri kullanın.

Paketin kurduğu dosyalar #

YolNe olduğu
/usr/bin/localtonetlocaltonet komutu.
/usr/lib/localtonet/İstemcinin kendisi.
/usr/lib/systemd/system/localtonet.serviceTünel hizmeti.
/usr/lib/systemd/system/localtonet-vpn.serviceVPN ve tünel hizmeti.
/etc/localtonet/auth-tokenToken dosyası. Yalnızca root okuyabilir. DUMMY_AUTH_TOKEN yer tutucusuyla kurulur.

Paketin adı localtonet'tir. OpenSSL 3, iproute2 (RPM'de iproute), iptables ve kmod gibi bağımlılıklarını paket yöneticiniz kurar. Paketi kurmak bir hizmeti etkinleştirmez veya başlatmaz: önce token'ı ayarlar, ardından ihtiyacınız olan hizmeti etkinleştirirsiniz.

Adımlar #

  1. Paketi indirip kurun #

    Bu sayfanın sonundaki listeden dağıtımınıza ve CPU'nuza uygun paketi seçin, ardından indirilen dosyayı apt (DEB) veya dnf (RPM) ile kurun. Her paketin altındaki Kurulum talimatları, o dosya için tam komutları gösterir.

  2. AuthToken'ınızı ayarlayın #

    /etc/localtonet/auth-token dosyasını root olarak bir metin düzenleyicisiyle düzenleyin ve DUMMY_AUTH_TOKEN yerine token'ınızı tek satır olarak yazın. Ardından dosyayı yalnızca root'un okuyabildiğinden emin olun:

    Terminal
    sudo chmod 600 /etc/localtonet/auth-token
  3. Yapılandırmayı kontrol edin #

    Terminal
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    Denetim, token dosyasını bağlanmadan okur. Dosya, boşluk içermeyen 33 karakterlik bir token içeriyorsa Localtonet headless configuration OK. yanıtını verir. Token'ın hesabınız için geçerli olup olmadığını Localtonet sunucularına sormaz.

  4. Bir hizmeti etkinleştirin #

    Tüneller için tünel hizmetini etkinleştirin ve günlüğünü okuyun:

    Terminal
    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Bu cihaz aynı zamanda bir VPN ağına katılıyorsa bunun yerine VPN hizmetini etkinleştirin. Bkz. Tünel hizmeti veya VPN hizmeti.

  5. Bir tünel başlatın #

    Token artık Token'larım sayfasında Çevrimiçi görünür. Panelde bu token için bir tünel oluşturun ve başlatın; bkz. Hızlı başlangıç.

Tünel hizmeti veya VPN hizmeti #

Her iki hizmet de aynı istemciyi çalıştırır ve ikisi de tünellerinize hizmet verir. Fark, çalıştıkları yetkilerdedir. Birini etkinleştirin: iki hizmet birbiriyle çakışır ve birini başlatmak diğerini durdurur.

localtonet.servicelocaltonet-vpn.service
Kullanım amacıTünellerVPN ve tüneller
Çalıştığı kullanıcısystemd'nin hizmet için oluşturduğu ayrıcalıksız bir kullanıcıroot; CAP_NET_ADMIN ve CAP_NET_RAW ağ yetenekleriyle sınırlı
TUN modülüKullanılmazİstemci başlamadan önce modprobe tun ile yüklenir
Çalışma dizini/var/lib/localtonet/var/lib/localtonet-vpn

Bir cihazı tünel hizmetinden VPN hizmetine geçirmek için:

Terminal
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service

Geri dönmek için localtonet-vpn.service hizmetini devre dışı bırakın ve localtonet.service hizmetini aynı şekilde etkinleştirin. VPN ağlarının kendisi panelde kurulur; bkz. VPN Yöneticisi.

Hizmetlerin çalışma biçimi #

DavranışAyrıntılar
Headless modHer iki hizmet de localtonet --headless komutunu başlatır. Bu modda istemci hiçbir zaman soru sormaz ve token'ı kendi ayarlarında saklamaz.
Tokensystemd, /etc/localtonet/auth-token dosyasını hizmete iletir. Dosya yokken hizmet başlamaz.
Açılışta başlamaEtkinleştirilmiş bir hizmet, ağ hazır olduktan sonra başlar.
Yeniden başlatmasystemd, bir hatadan on saniye sonra istemciyi yeniden başlatır. İstemci geçersiz bir token dosyası nedeniyle durduysa yeniden başlatmaz. Dosyayı düzeltin ve hizmeti kendiniz yeniden başlatın.

Günlüğü okuma #

Headless modda istemci, her değişiklik için bir satır olacak şekilde journal'a düz satırlar yazar:

Terminal
sudo journalctl -u localtonet.service -f
SatırAnlamı
Connection: ConnectedOturumun durumu. Diğer değerler Connecting ve Disconnected'dır.
AuthTokenName: …İstemcinin oturum açtığı token'ın adı.
OPEN …, ADDED …Bu cihazda çalışan bir tünel; herkese açık adresi, protokolü ve yerel hedefiyle.
STATUS …Bir tünelin durumu değişti.
CLOSED …Bir tünel durduruldu veya kaldırıldı.
Authentication failed: AuthToken was rejected.Dosyadaki token kabul edilmiyor. Token'ı Token'larım sayfasından yeniden kopyalayın.

Bu satırlardan biri token içerecekse istemci, onun yerine [redacted] yazar.

Yükseltme #

Yeni paketi indirin ve ilk seferdeki gibi kurun, ardından kullandığınız hizmeti yeniden başlatın. Token dosyanız korunur.

Tünel hizmeti
sudo systemctl restart localtonet
VPN hizmeti
sudo systemctl restart localtonet-vpn.service

Token'larım sayfasında İstemci sütunu, cihazın en son bildirdiği sürümü gösterir; daha yeni bir sürüm varsa Güncelleme gerekli rozeti de görünür.

Kaldırma #

Debian, Ubuntu
sudo apt remove localtonet
Fedora, RHEL
sudo dnf remove localtonet

Paketi kaldırmak her iki hizmeti de durdurur ve devre dışı bırakır. Token dosyası bir yapılandırma dosyasıdır ve paket yöneticileri bu dosyalara dikkatli davranır: kaldırmadan sonra /etc/localtonet/auth-token dosyasının veya bir yedek kopyasının hâlâ orada olup olmadığını kontrol edin ve token'ın makinede kalmasını istemiyorsanız silin.

Sorun giderme #

Invalid Localtonet headless configuration. Check the token file or environment settings.

Token dosyası kullanılamıyor. /etc/localtonet/auth-token dosyasının var olduğunu, DUMMY_AUTH_TOKEN yer tutucusunun kalmadığını ve dosyanın yalnızca boşluksuz, tek satırlık 33 karakterlik token'ı içerdiğini kontrol edin. Dosyayı yalnızca root okuyabildiği için denetimi sudo ile çalıştırın.

Hizmet etkin ama çalışmıyor

systemctl status localtonet.service komutunu çalıştırın. /etc/localtonet/auth-token dosyası yokken hizmet başlamaz ve geçersiz bir token dosyası nedeniyle durduktan sonra yeniden başlatılmaz. Dosyayı düzeltin, yapılandırma denetimini çalıştırın, ardından sudo systemctl restart localtonet.service komutunu çalıştırın.

Günlükte şu yazıyor: Authentication failed: AuthToken was rejected.

Dosyanın biçimi doğru ama token kabul edilmiyor. Token'ı Token'larım sayfasından yeniden kopyalayın, token dosyasına kaydedin ve hizmeti yeniden başlatın.

VPN hizmetini başlattığımda tünel hizmeti durdu

Bu beklenen bir durumdur. İki hizmet çakıştığı için biri başladığında systemd diğerini durdurur. VPN hizmeti tünellerinize de hizmet verir.

Paket dağıtımıma kurulmuyor

Paketler systemd 247 veya daha yeni ve OpenSSL 3 gerektirir. Daha eski sürümlerde paket yöneticisi bu bağımlılıkları karşılayamaz. Bunun yerine Linux sayfasındaki kurulum betiğini veya bir arşivi kullanın.

Paketler aşağıda listelenmiştir. Dosya adıyla birlikte komutlar için bir paketin altındaki Kurulum talimatları bağlantısını seçin.

Linux paketleri

x64 ve ARM64 için kurulabilir DEB ve RPM paketleri. systemd 247 veya üzeri ve OpenSSL 3 gerektirir; örneğin Debian 12, Ubuntu 22.04+ veya RHEL 9.

  • Debian / Ubuntu · x64
    Kurulum talimatları

    1. İndirilen paketi kurun. localtonet-linux-x64.deb dosyasının bulunduğu dizinde bir terminal açın.

    sudo apt install ./localtonet-linux-x64.deb

    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:

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

    3. Hizmeti başlatın. Yapılandırma kontrolü başarılı olduktan sonra:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    VPN için VPN hizmetine geçin:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Yükseltmek için yeni paketi kurun ve sudo systemctl restart localtonet komutunu çalıştırın. Yapılandırmanız korunur.

    VPN kullanıyorsanız bunun yerine localtonet-vpn.service hizmetini yeniden başlatın.

  • Debian / Ubuntu · ARM64
    Kurulum talimatları

    1. İndirilen paketi kurun. localtonet-linux-arm64.deb dosyasının bulunduğu dizinde bir terminal açın.

    sudo apt install ./localtonet-linux-arm64.deb

    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:

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

    3. Hizmeti başlatın. Yapılandırma kontrolü başarılı olduktan sonra:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    VPN için VPN hizmetine geçin:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Yükseltmek için yeni paketi kurun ve sudo systemctl restart localtonet komutunu çalıştırın. Yapılandırmanız korunur.

    VPN kullanıyorsanız bunun yerine localtonet-vpn.service hizmetini yeniden başlatın.

  • Fedora / RHEL · x64
    Kurulum talimatları

    1. İndirilen paketi kurun. localtonet-linux-x64.rpm dosyasının bulunduğu dizinde bir terminal açın.

    sudo dnf install ./localtonet-linux-x64.rpm

    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:

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

    3. Hizmeti başlatın. Yapılandırma kontrolü başarılı olduktan sonra:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    VPN için VPN hizmetine geçin:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Yükseltmek için yeni paketi kurun ve sudo systemctl restart localtonet komutunu çalıştırın. Yapılandırmanız korunur.

    VPN kullanıyorsanız bunun yerine localtonet-vpn.service hizmetini yeniden başlatın.

  • Fedora / RHEL · ARM64
    Kurulum talimatları

    1. İndirilen paketi kurun. localtonet-linux-arm64.rpm dosyasının bulunduğu dizinde bir terminal açın.

    sudo dnf install ./localtonet-linux-arm64.rpm

    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:

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

    3. Hizmeti başlatın. Yapılandırma kontrolü başarılı olduktan sonra:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    VPN için VPN hizmetine geçin:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Yükseltmek için yeni paketi kurun ve sudo systemctl restart localtonet komutunu çalıştırın. Yapılandırmanız korunur.

    VPN kullanıyorsanız bunun yerine localtonet-vpn.service hizmetini yeniden başlatın.

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

Destek