Localtonet'i bir DEB veya RPM paketinden kurma
Bu sayfada 9 bölüm
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 #
| Yol | Ne olduğu |
|---|---|
/usr/bin/localtonet | localtonet komutu. |
/usr/lib/localtonet/ | İstemcinin kendisi. |
/usr/lib/systemd/system/localtonet.service | Tünel hizmeti. |
/usr/lib/systemd/system/localtonet-vpn.service | VPN ve tünel hizmeti. |
/etc/localtonet/auth-token | Token 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 #
-
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) veyadnf(RPM) ile kurun. Her paketin altındaki Kurulum talimatları, o dosya için tam komutları gösterir. -
AuthToken'ınızı ayarlayın #
/etc/localtonet/auth-tokendosyasını root olarak bir metin düzenleyicisiyle düzenleyin veDUMMY_AUTH_TOKENyerine token'ınızı tek satır olarak yazın. Ardından dosyayı yalnızca root'un okuyabildiğinden emin olun:Terminalsudo chmod 600 /etc/localtonet/auth-token -
Yapılandırmayı kontrol edin #
Terminalsudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-configDenetim, 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. -
Bir hizmeti etkinleştirin #
Tüneller için tünel hizmetini etkinleştirin ve günlüğünü okuyun:
Terminalsudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceBu cihaz aynı zamanda bir VPN ağına katılıyorsa bunun yerine VPN hizmetini etkinleştirin. Bkz. Tünel hizmeti veya VPN hizmeti.
-
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.service | localtonet-vpn.service | |
|---|---|---|
| Kullanım amacı | Tüneller | VPN 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:
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.serviceGeri 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 mod | Her iki hizmet de localtonet --headless komutunu başlatır. Bu modda istemci hiçbir zaman soru sormaz ve token'ı kendi ayarlarında saklamaz. |
| Token | systemd, /etc/localtonet/auth-token dosyasını hizmete iletir. Dosya yokken hizmet başlamaz. |
| Açılışta başlama | Etkinleştirilmiş bir hizmet, ağ hazır olduktan sonra başlar. |
| Yeniden başlatma | systemd, 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:
sudo journalctl -u localtonet.service -f| Satır | Anlamı |
|---|---|
Connection: Connected | Oturumun 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.
sudo systemctl restart localtonetsudo systemctl restart localtonet-vpn.serviceToken'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 #
sudo apt remove localtonetsudo dnf remove localtonetPaketi 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.
İlgili sayfalar #
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.debdosyasının bulunduğu dizinde bir terminal açın.sudo apt install ./localtonet-linux-x64.deb2. 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:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Hizmeti başlatın. Yapılandırma kontrolü başarılı olduktan sonra:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceVPN 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.serviceYükseltmek için yeni paketi kurun ve
sudo systemctl restart localtonetkomutunu çalıştırın. Yapılandırmanız korunur.VPN kullanıyorsanız bunun yerine
localtonet-vpn.servicehizmetini yeniden başlatın. -
Debian / Ubuntu · ARM64
Kurulum talimatları
1. İndirilen paketi kurun.
localtonet-linux-arm64.debdosyasının bulunduğu dizinde bir terminal açın.sudo apt install ./localtonet-linux-arm64.deb2. 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:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Hizmeti başlatın. Yapılandırma kontrolü başarılı olduktan sonra:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceVPN 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.serviceYükseltmek için yeni paketi kurun ve
sudo systemctl restart localtonetkomutunu çalıştırın. Yapılandırmanız korunur.VPN kullanıyorsanız bunun yerine
localtonet-vpn.servicehizmetini yeniden başlatın. -
Fedora / RHEL · x64
Kurulum talimatları
1. İndirilen paketi kurun.
localtonet-linux-x64.rpmdosyasının bulunduğu dizinde bir terminal açın.sudo dnf install ./localtonet-linux-x64.rpm2. 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:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Hizmeti başlatın. Yapılandırma kontrolü başarılı olduktan sonra:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceVPN 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.serviceYükseltmek için yeni paketi kurun ve
sudo systemctl restart localtonetkomutunu çalıştırın. Yapılandırmanız korunur.VPN kullanıyorsanız bunun yerine
localtonet-vpn.servicehizmetini yeniden başlatın. -
Fedora / RHEL · ARM64
Kurulum talimatları
1. İndirilen paketi kurun.
localtonet-linux-arm64.rpmdosyasının bulunduğu dizinde bir terminal açın.sudo dnf install ./localtonet-linux-arm64.rpm2. 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:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Hizmeti başlatın. Yapılandırma kontrolü başarılı olduktan sonra:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceVPN 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.serviceYükseltmek için yeni paketi kurun ve
sudo systemctl restart localtonetkomutunu çalıştırın. Yapılandırmanız korunur.VPN kullanıyorsanız bunun yerine
localtonet-vpn.servicehizmetini yeniden başlatın.