İçeriğe geç
Localtonet Localtonet Panel

Komut satırı başvurusu

Bu sayfa için yardım al
Bu sayfada 14 bölüm
  1. Başlamadan önce
  2. Sözdizimi
  3. Hızlı genel bakış
  4. Kimlik doğrulama
  5. --authtoken
  6. --ephemeral-token
  7. Hizmet yönetimi
  8. Headless mod
  9. --headless
  10. --authtoken-file
  11. --check-config
  12. Headless günlüğü
  13. Ağ seçimi
  14. --network
  15. --net ve --ip
  16. Giden proxy
  17. --proxy
  18. --proxy-user
  19. Proxy ortam değişkenleri
  20. --http-transport
  21. Cihaz Terminali
  22. --terminal
  23. --terminal-user
  24. --pairing-key
  25. localtonet ssh
  26. Tanılama ve bilgi
  27. --debug
  28. --version
  29. --help
  30. Ortam değişkenleri
  31. Çıkış kodları
  32. Örnekler
  33. İlgili sayfalar

localtonet konsol istemcisinin tüm seçenekleri: token ile oturum açma, hizmet olarak çalıştırma, soru sormadan çalıştırma, ağ veya giden proxy seçme ve Cihaz Terminali komutları.

Başlamadan önce #

Bu sayfa; Windows, macOS ve Linux için konsol istemcisini, Docker imajındaki istemciyi ve Linux paketlerini kapsar. İstemciyi kurulum genel bakışından yükleyebilirsiniz. Tüneller komut satırında oluşturulmaz: tünelleri panelde, API ile veya MCP sunucusu ile oluşturur, başlatır ve durdurursunuz. İstemci, bir cihazı hesabınıza bağlar ve trafiği taşır.

Sözdizimi #

Bash
localtonet [options]
localtonet ssh <DEVICE> [--key <KEY>] [--stdio] [-- <COMMAND>]
  • Seçenekler herhangi bir sırada verilebilir. Seçenek adlarında büyük/küçük harf ayrımı yoktur; yalnızca localtonet ssh seçenekleri bunun dışındadır.
  • Bir seçeneğin değeri, seçenekten sonra bir boşluk veya eşittir işaretiyle verilir: --authtoken <YOUR_TOKEN> ile --authtoken=<YOUR_TOKEN> aynıdır.
  • Değer gerektiren bir seçenekte değer eksikse <option> requires a value. hatası verilir.
  • --proxy, --proxy-user ve --http-transport yalnızca bir kez verilebilir.
  • <YOUR_TOKEN> gibi yer tutucular kendi değerlerinizin yerini tutar. Bunları açılı ayraçlar olmadan yazın.

Seçenek verilmezse istemci etkileşimli olarak başlar: kayıtlı token'ı kullanır veya sizden bir token ister, bağlanır ve canlı bir durum tablosu gösterir.

Bash
localtonet

Hızlı genel bakış #

SeçenekAmaç
--authtoken <TOKEN>Bir AuthToken ile oturum açar.
--ephemeral-tokenToken'ı bu cihazda kaydetmez.
--install-service, --start-service, --stop-service, --status-service, --remove-serviceArka plan hizmetini yönetir.
--headlessSoru sormadan ve sade günlük satırlarıyla çalışır.
--authtoken-file <PATH>Token'ı bir dosyadan okur (headless mod).
--check-configToken kaynağını denetler ve çıkar (headless mod).
--networkCihazın ağ arayüzlerini listeler.
--net <NAME> --ip <ADDRESS>İstemcinin tüm trafiğini tek bir ağ arayüzünden geçirir.
--proxy <none|env|URL>, --proxy-user <USER>Localtonet'e giden bir proxy üzerinden bağlanır.
--http-transport <auto|https|raw>Sunucu bağlantılarının bir proxy üzerinden nasıl taşınacağını seçer.
--terminal <enable|disable|status>, --terminal-user <ACCOUNT>, --pairing-key <KEY>Bu cihazda Cihaz Terminali'ni açar veya kapatır.
ssh <DEVICE>Cihazlarınızdan birinde kabuk açar veya komut çalıştırır.
--debugBağlantı tanılama bilgilerini yazdırır.
--versionSürümü yazdırır.
--help, -hYerleşik yardımı yazdırır.

Kimlik doğrulama #

--authtoken #

Bash
localtonet --authtoken <YOUR_TOKEN>

Cihazda, Token'larım sayfasındaki bir AuthToken ile oturum açar. Bir token 33 karakter uzunluğundadır. İstemci token'ı geçerli kullanıcının profilinde saklar; böylece bir sonraki sefer düz localtonet yazmanız yeterli olur.

  • --authtoken verilmemişse ve kayıtlı token yoksa istemci Please Enter AuthToken or PIN diye sorar. Token'ı veya panelin bir token için gösterdiği altı haneli PIN'i yazabilirsiniz.
  • Geçerli olmayan bir değere Wrong Token! yanıtı verilir ve soru yeniden sorulur.
  • İstemci çalışırken F12 kayıtlı token'ı siler ve çıkar. Ctrl + C çıkar ve token'ı korur.
  • Tire içermeyen eski yazım olan authtoken <YOUR_TOKEN> hâlâ kabul edilir.

Token'ınızı gizli tutun. Localtonet istemcisinin bu cihaz olarak bağlanmasına izin verir. Her cihaz için bir token kullanın: aynı token ile bağlanan ikinci bir istemci, birincinin bağlantısını keser.

--ephemeral-token #

Bash
localtonet --authtoken <YOUR_TOKEN> --ephemeral-token

Token'ı yalnızca bu çalıştırma için kullanır. İstemci token'ı kayıtlı ayarlara yazmaz ve önceden kayıtlı bir token'ı değiştirmez. Otomasyon ve geçici oturumlar için kullanın.

Hizmet yönetimi #

Bu seçenekler istemciyi Windows hizmetlerine, macOS'ta launchd'ye veya Linux'ta systemd'ye kaydeder. Yönetici hakları gerektirirler (macOS ve Linux'ta sudo) ve hizmet token'ın adını taşıdığı için her biri için token gerekir. Ayrıntılı kılavuz için Hizmet olarak çalıştırma sayfasına bakın.

SeçenekNe yaparÖrnek
--install-serviceİstemciyi açılışta başlayan bir hizmet olarak kurar ve başlatır. Komut satırındaki diğer seçenekler hizmette saklanır.localtonet --install-service --authtoken <YOUR_TOKEN>
--start-serviceKurulu hizmeti başlatır.localtonet --start-service --authtoken <YOUR_TOKEN>
--stop-serviceHizmeti durdurur.localtonet --stop-service --authtoken <YOUR_TOKEN>
--status-serviceHizmetin durumunu yazdırır; örneğin Running, Stopped veya NotFound.localtonet --status-service --authtoken <YOUR_TOKEN>
--remove-serviceHizmeti durdurur ve kaldırır.localtonet --remove-service --authtoken <YOUR_TOKEN>

Hizmet seçenekleri headless modda kullanılmaz.

Headless mod #

Headless mod; konteynerler, init sistemleri ve betikler içindir. İstemci hiçbir soru sormaz, tuşlara tepki vermez, token'ı kaydetmez ve durum tablosu yerine her değişiklik için sade bir günlük satırı yazar. Docker imajı ile Linux ve OpenWrt paketleri istemciyi bu şekilde çalıştırır.

--headless #

Bash
localtonet --headless --authtoken-file /etc/localtonet/auth-token

İstemciyi headless modda başlatır. LOCALTONET_HEADLESS=1 ortam değişkenini ayarlamak da aynı etkiyi yapar. İstemci bir sonlandırma sinyali aldığında düzgün biçimde durur.

Token şu kaynaklardan birinden gelir:

KaynakNotlar
--authtoken-file <PATH>Yalnızca token'ı içeren bir dosya. Çevresindeki boşluklar ve satır sonları yok sayılır.
LOCALTONET_AUTH_TOKEN_FILEBöyle bir dosyanın yolunu içeren ortam değişkeni. --authtoken-file verilmediğinde kullanılır.
--authtoken <TOKEN>Komut satırındaki token'ın kendisi.
LOCALTONET_AUTH_TOKENToken'ı içeren ortam değişkeni. --authtoken verilmediğinde kullanılır.

Token dosyası, doğrudan verilen token'a her zaman üstün gelir. Bir token dosyası belirtilmiş ancak okunamıyorsa istemci durur; başka bir kaynağa geçmez.

Kullanılabilir bir token bulunamazsa istemci Invalid Localtonet headless configuration. Check the token file or environment settings. yazdırır ve 2 koduyla çıkar. Kullanılabilir bir token 33 karakter uzunluğundadır ve boşluk içermez.

--authtoken-file #

Bash
localtonet --headless --authtoken-file <PATH>

Token'ı komut satırı yerine bir dosyadan okur; böylece token işlem listelerinde veya kabuk geçmişinde görünmez. Dosyayı, örneğin chmod 600 ile koruyun. Bu seçenek yalnızca headless modda okunur.

--check-config #

Bash
localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

Token kaynağını denetler ve bağlanmadan çıkar. İyi biçimlendirilmiş bir token bulunduysa Localtonet headless configuration OK. yazdırır ve 0 koduyla çıkar; aksi hâlde yukarıdaki hatayı yazdırır ve 2 koduyla çıkar. Denetim yereldir: Localtonet'in token'ı kabul edip etmediğini söylemez. Her zaman --headless ile (veya LOCALTONET_HEADLESS=1 ile) birlikte kullanın; tek başına yok sayılır.

Headless günlüğü #

SatırAnlamı
Localtonet - headless logİstemci başladı.
Connection: …Bağlantı durumu değişti.
AuthTokenName: …Cihazın oturum açtığı token'ın adı.
OPEN …, ADDED …Başlangıçta var olan veya sonradan eklenen bir tünel.
STATUS …Bir tünelin durumu değişti.
CLOSED …Bir tünel bu istemciden kaldırıldı.
Authentication failed: AuthToken was rejected.Localtonet token'ı kabul etmedi.

İlk satırdan sonraki her satır bir zaman damgasıyla başlar. Token günlüğe asla yazılmaz.

Ağ seçimi #

Birden fazla internet bağlantısı olan bir cihazda, örneğin Ethernet ve mobil modem, istemcinin hangisini kullanacağını seçebilirsiniz. Ağ seçimi sayfası bu özelliği ve tünel başına ayarı açıklar.

--network #

Bash
localtonet --network

Etkin her ağ arayüzünü adresleriyle listeler, her IPv4 adresinin internete ulaşıp ulaşmadığını denetler ve çıkar. Her satır, vereceğiniz seçenekler olarak hazır yazılmıştır:

Çıktı
NetworkName: Ethernet
--net Ethernet --ip 192.168.1.20   --> Internet available (public IP 203.0.113.10)
--------------------------------------------------
NetworkName: Mobile
--net Mobile --ip 10.20.30.40   --> No internet access
--------------------------------------------------

IPv6 adresleri IPv6, internet check not available ile listelenir.

--net ve --ip #

Bash
localtonet --authtoken <YOUR_TOKEN> --net Ethernet --ip 192.168.1.20

Tüm istemciyi tek bir ağ arayüzüne sabitler. --net arayüzün adıdır, --ip ise --network'ün yazdırdığı şekliyle o arayüzün bir adresidir. İkisi birlikte verilmelidir. Boşluk içeren bir arayüz adı olduğu gibi veya tırnak içinde yazılabilir.

  • Çift uygulanamazsa istemci, arayüzün gelmesi için en fazla 30 saniye bekler (açılışta başlarken işe yarar) ve ardından nedeni ve 2 çıkış koduyla durur. Başka bir ağdan devam etmez.
  • İki seçenekten yalnızca biri verilirse istemci --net and --ip must be given together; the default network is used. yazdırır ve sabitleme olmadan devam eder.
  • Linux'ta istemci, sabitlenen adres için yönlendirme kuralları ekler. Bunun için root gerekir veya ip komutu için parolasız sudo gerekir.
MesajAnlamı
Network interface '…' was not found. Run 'localtonet --network' to list the interfaces.--net sonrasındaki ad hiçbir arayüzle eşleşmiyor.
Network interface '…' is Down.Arayüz var ancak etkin değil.
'…' is not an address of network interface '…'.--ip sonrasındaki adres o arayüze ait değil.
'…' is not an IP address.--ip sonrasındaki değer bir IP adresi değil.

Tüm istemci yerine yalnızca tek bir tünel için farklı bir bağlantı kullanmak isterseniz aynı çifti o tünelin Argümanlar ayarına girin.

Giden proxy #

Cihaz internete yalnızca bir proxy üzerinden erişebiliyorsa bu seçenekleri kullanın. İstemcinin Localtonet'e olan kendi bağlantılarına uygulanırlar. İstemcinin yerel hizmetinize nasıl eriştiğini değiştirmezler.

--proxy #

DeğerNe yapar
Verilmedi veya noneDoğrudan bağlanır. Proxy ortam değişkenleri yok sayılır.
envAşağıda açıklanan proxy ortam değişkenlerini kullanır. Hiçbiri ayarlı değilse veya biri geçersizse istemci doğrudan bağlanmak yerine hatayla durur.
Bir proxy URL'siHer şey için bu proxy'yi kullanır. Desteklenen şemalar: http://, https://, socks5:// ve socks5h://.
Bash
localtonet --authtoken <YOUR_TOKEN> --proxy http://proxy.example.com:3128
localtonet --authtoken <YOUR_TOKEN> --proxy socks5h://proxy.example.com:1080
localtonet --authtoken <YOUR_TOKEN> --proxy env
ŞemaDavranışVarsayılan portKimlik doğrulama
http://CONNECT kullanan HTTP proxy.80Yok veya Basic
https://Önce proxy ile doğrulanmış bir TLS bağlantısı açar, ardından CONNECT kullanır.443Yok veya Basic
socks5://SOCKS5, TCP ve UDP. Ana bilgisayar adları cihazınızda çözümlenir.1080Yok veya kullanıcı adı ve parola
socks5h://SOCKS5, TCP ve UDP. Ana bilgisayar adları proxy tarafından çözümlenir.1080Yok veya kullanıcı adı ve parola

Proxy ana bilgisayarı bir IPv4 adresi, bir ana bilgisayar adı veya köşeli ayraç içinde bir IPv6 adresi olabilir. Kimlik bilgileri URL'nin parçası olarak user:password@host:port biçiminde verilebilir; bunlardaki özel karakterleri URL kodlamasıyla yazın. Hata ayıklama çıktısı kimlik bilgilerini asla içermez.

--proxy-user #

Bash
localtonet --authtoken <YOUR_TOKEN> --proxy socks5h://proxy.example.com:1080 --proxy-user <PROXY_USER>

Proxy kullanıcı adını ayarlar ve parolayı gizli bir istemle (Proxy password:) sorar; böylece parola komut satırında yer almaz. Parola kaydedilmez.

  • --proxy env veya bir proxy URL'si gerektirir ve URL içindeki kimlik bilgileriyle birlikte kullanılamaz.
  • Yalnızca etkileşimli bir terminalde çalışır. Headless mod ve hizmetler hiçbir zaman istem göstermez: kimlik bilgilerini proxy URL'sine yazın veya bunları içeren bir proxy URL'si ile --proxy env kullanın.
  • --install-service, bir hizmet bunları saklayamadığı için --proxy-user seçeneğini ve parola içeren proxy URL'lerini reddeder. Hizmeti --proxy env ile kurun ve değişkenleri hizmetin ortamında sağlayın.

Proxy ortam değişkenleri #

Bunlar yalnızca --proxy env ile okunur. Her bağlantı türü için ayarlı olan ilk değişken kullanılır:

BağlantıDeğişkenler, sırasıyla
HTTP ve WebSockethttp_proxy, HTTP_PROXY, all_proxy, ALL_PROXY
HTTPS ve güvenli WebSockethttps_proxy, HTTPS_PROXY, all_proxy, ALL_PROXY
Ham TCP ve UDPall_proxy, ALL_PROXY, https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY

no_proxy (küçük harflisi ayarlı değilse NO_PROXY) doğrudan erişilen ana bilgisayarları listeler:

  • Girdiler virgülle ayrılır. Bir ana bilgisayar veya alan adı kendisiyle ve alt alan adlarıyla eşleşir. Eşleştirmede büyük/küçük harf ve baştaki nokta yok sayılır.
  • IP adresleri tam olarak eşleşir; IPv6 adresleri köşeli ayraç içinde olabilir. * her ana bilgisayar için proxy'yi atlar.
  • Adres aralıkları (CIDR), port içeren girdiler ve kısmi joker karakterler desteklenmez ve yapılandırma hatası olarak bildirilir.
  • Bir proxy URL'si verdiğinizde veya doğrudan bağlandığınızda no_proxy'nin etkisi olmaz.

--http-transport #

Bash
localtonet --authtoken <YOUR_TOKEN> --proxy http://proxy.example.com:3128 --http-transport https

Bir proxy yalnızca olağan web trafiğine izin verdiğinde istemcinin sunucu bağlantılarını nasıl taşıyacağını belirler. HTTPS taşıması ile istemci bu trafiği, proxy üzerinden uzun ömürlü ham bağlantılar açmak yerine bir Localtonet ağ geçidine normal HTTPS istekleri olarak gönderir.

DeğerNe yapar
auto (varsayılan)Bir HTTP veya HTTPS proxy arkasında, sunucu sunuyorsa istemci HTTPS taşımasını tercih eder, aksi hâlde CONNECT kullanır. Bir SOCKS5 proxy arkasında önce yerel TCP ve UDP kullanır ve aynı proxy üzerinden HTTPS taşımasına geri dönebilir.
httpsSunucu bağlantıları için HTTPS taşımasını zorunlu kılar.
rawHTTPS taşımasını hiç kullanmaz: yalnızca CONNECT veya SOCKS.

Başka herhangi bir değer istemciyi LOCALTONET_HTTP_TRANSPORT_MODE must be auto, https or raw. iletisiyle durdurur.

Cihaz Terminali #

Cihaz Terminali, kendi cihazlarınızda panelden veya SSH üzerinden bir kabuk sağlar. Windows, Linux ve macOS üzerinde çalışır ve Localtonet Desktop v8.6 veya sonrasını gerektirir. Cihaz Terminali sayfası özelliği anlatır; bunlar onun komut satırı kısımlarıdır.

--terminal #

Bash
localtonet --terminal enable --authtoken <YOUR_TOKEN>
localtonet --terminal status --authtoken <YOUR_TOKEN>
localtonet --terminal disable --authtoken <YOUR_TOKEN>
DeğerNe yapar
enableBu cihazı hesabınızla eşleştirir. Komut bir onay kodu yazdırır ve bekler; Cihazlarım sayfasını açın, Cihaz ekle düğmesini seçin ve kodu girin. Kod 15 dakika geçerlidir. Onaydan sonra komut Terminal enabled. Shells will run as <account>. yazdırır.
disableBu cihazda terminali kapatır ve cihazı hesabınızdan kaldırır. Panele ulaşılamıyorsa terminal yine de yerel olarak kapatılır ve komut cihazı panelden de kaldırmanızı ister.
statusTerminalin etkin olup olmadığını ve kabukların hangi hesapla çalıştığını yazdırır.

Üç biçim de normal bir başlatma gibi token gerektirir: --authtoken verin veya kayıtlı token'ı kullanmak için bu seçeneği atlayın. Localtonet cihazda hizmet olarak çalışıyorsa komutu Yönetici terminalinden veya sudo ile çalıştırın. Etkileşimli bir terminalde, Localtonet bu token ile cihazda zaten çalışmıyorsa istemci enable sonrasında normal bir istemci olarak çalışmaya devam eder.

--terminal-user #

Bash
sudo localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT>

Terminali root veya yönetici olarak etkinleştirdiğinizde kabukların hangi hesapla çalışacağını seçer. Bu seçenek olmadan, yükseltilmiş bir enable Run shells as user: diye sorar; hiçbir şeyin sorulamadığı bir betikte Choose the account for shells with --terminal-user. iletisiyle durur. --terminal-user olmadan, yükseltilmemiş bir komut geçerli kullanıcıyı kullanır.

--pairing-key #

Bash
localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT> --pairing-key <PAIRING_KEY>

Kimsenin onay kodunu okuyamadığı bir cihazı, örneğin bir betikle kurduğunuz sunucuyu eşleştirir. Anahtarı Cihazlarım sayfasında Cihaz ekle altında Tek kullanımlık anahtar oluştur ile oluşturun. Bir saat geçerlidir ve yalnızca bir kez kullanılabilir. Eşleştirme anahtarıyla komut kod yazdırmaz ve onay beklemez.

localtonet ssh #

Bash
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptime
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptime

Cihazlarınızdan birinde kabuk açar veya orada tek bir komut çalıştırıp çıkış kodunu döndürür. <DEVICE>, Cihazlarım sayfasında görünen cihaz adıdır. ssh, localtonet sözcüğünden sonraki ilk sözcük olmalıdır.

BölümNe yapar
-- <COMMAND>Kabuk açmak yerine komutu çalıştırır. -- sonrasındaki her şey komuttur.
--key <ACCESS_KEY>Cihazın, Cihazlarım sayfasında Anahtarlar altında oluşturulan bir erişim anahtarı. Anahtarla tarayıcıda onay gerekmez.
--stdioKabuk açmaz. Yalnızca ham bağlantıyı standart girdi ve çıktı üzerinden cihaza taşır; bir SSH istemcisinin ProxyCommand değeri olarak kullanılır.

Anahtar olmadan komut Approve this connection in your browser: ve ardından bir bağlantı yazdırır ve onaylamanız için en fazla beş dakika bekler. Bağlantı onaylanmazsa The connection was not approved. ile biter.

Tanılama ve bilgi #

--debug #

Bash
localtonet --debug --proxy env --authtoken <YOUR_TOKEN>

Standart hata çıktısında bağlantı tanılamayı açar: kullanılan proxy rotaları ve hangi ayardan geldikleri, DNS modu, el sıkışma sonuçları ve UDP durumu. Kimlik bilgileri ve istek gövdeleri dışarıda bırakılır. --debug istemciyi ayrıca headless moda geçirir; bu nedenle istem göstermez. Bir bayraktır ve değer almaz.

--version #

Bash
localtonet --version

İstemci sürümünü, örneğin v8.6, yazdırır ve çıkar.

--help #

Bash
localtonet --help

Yerleşik yardımı yazdırır ve çıkar. -h aynı işi yapar.

Ortam değişkenleri #

DeğişkenEtki
LOCALTONET_HEADLESS1 headless modu açar.
LOCALTONET_AUTH_TOKENHeadless modda token.
LOCALTONET_AUTH_TOKEN_FILEHeadless modda bir token dosyasının yolu.
http_proxy, https_proxy, all_proxy, no_proxy ve bunların büyük harfli biçimleriProxy ayarları; yalnızca --proxy env ile.

Çıkış kodları #

KodAnlamı
0Komut normal şekilde tamamlandı.
1Bir Cihaz Terminali komutu başarısız oldu; örneğin onay kodunun süresi doldu veya cihaza ulaşılamadı.
2Bir seçenek yanlış veya değeri eksik, headless token kullanılamaz ya da --net ve --ip çifti uygulanamadı.

localtonet ssh <DEVICE> -- <COMMAND>, uzak komutun çıkış kodunu döndürür.

Örnekler #

Masaüstünde ilk başlatma
localtonet --authtoken <YOUR_TOKEN>
Linux'ta arka plan hizmeti
sudo localtonet --install-service --authtoken <YOUR_TOKEN>
sudo localtonet --status-service --authtoken <YOUR_TOKEN>
Docker, token ortamdan
docker run -d --restart unless-stopped -e LOCALTONET_AUTH_TOKEN=<YOUR_TOKEN> localtonet/localtonet
Her şey için mobil modemi kullan
localtonet --network
localtonet --authtoken <YOUR_TOKEN> --net Mobile --ip 10.20.30.40
Kurumsal proxy arkasında
export all_proxy=http://proxy.example.com:3128
localtonet --authtoken <YOUR_TOKEN> --proxy env

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

Destek