Komut satırı başvurusu
Bu sayfada 14 bölüm
- Başlamadan önce
- Sözdizimi
- Hızlı genel bakış
- Kimlik doğrulama
- --authtoken
- --ephemeral-token
- Hizmet yönetimi
- Headless mod
- --headless
- --authtoken-file
- --check-config
- Headless günlüğü
- Ağ seçimi
- --network
- --net ve --ip
- Giden proxy
- --proxy
- --proxy-user
- Proxy ortam değişkenleri
- --http-transport
- Cihaz Terminali
- --terminal
- --terminal-user
- --pairing-key
- localtonet ssh
- Tanılama ve bilgi
- --debug
- --version
- --help
- Ortam değişkenleri
- Çıkış kodları
- Örnekler
- İ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 #
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 sshseç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-userve--http-transportyalnı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.
localtonetHızlı genel bakış #
| Seçenek | Amaç |
|---|---|
--authtoken <TOKEN> | Bir AuthToken ile oturum açar. |
--ephemeral-token | Token'ı bu cihazda kaydetmez. |
--install-service, --start-service, --stop-service, --status-service, --remove-service | Arka plan hizmetini yönetir. |
--headless | Soru sormadan ve sade günlük satırlarıyla çalışır. |
--authtoken-file <PATH> | Token'ı bir dosyadan okur (headless mod). |
--check-config | Token kaynağını denetler ve çıkar (headless mod). |
--network | Cihazı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. |
--debug | Bağlantı tanılama bilgilerini yazdırır. |
--version | Sürümü yazdırır. |
--help, -h | Yerleşik yardımı yazdırır. |
Kimlik doğrulama #
--authtoken #
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.
--authtokenverilmemişse ve kayıtlı token yoksa istemciPlease Enter AuthToken or PINdiye 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 #
localtonet --authtoken <YOUR_TOKEN> --ephemeral-tokenToken'ı 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çenek | Ne 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-service | Kurulu hizmeti başlatır. | localtonet --start-service --authtoken <YOUR_TOKEN> |
--stop-service | Hizmeti durdurur. | localtonet --stop-service --authtoken <YOUR_TOKEN> |
--status-service | Hizmetin durumunu yazdırır; örneğin Running, Stopped veya NotFound. | localtonet --status-service --authtoken <YOUR_TOKEN> |
--remove-service | Hizmeti 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 #
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:
| Kaynak | Notlar |
|---|---|
--authtoken-file <PATH> | Yalnızca token'ı içeren bir dosya. Çevresindeki boşluklar ve satır sonları yok sayılır. |
LOCALTONET_AUTH_TOKEN_FILE | Bö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_TOKEN | Token'ı 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 #
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 #
localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-configToken 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ır | Anlamı |
|---|---|
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 #
localtonet --networkEtkin 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:
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 #
localtonet --authtoken <YOUR_TOKEN> --net Ethernet --ip 192.168.1.20Tü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
ipkomutu için parolasızsudogerekir.
| Mesaj | Anlamı |
|---|---|
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ğer | Ne yapar |
|---|---|
Verilmedi veya none | Doğrudan bağlanır. Proxy ortam değişkenleri yok sayılır. |
env | Aş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'si | Her şey için bu proxy'yi kullanır. Desteklenen şemalar: http://, https://, socks5:// ve socks5h://. |
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| Şema | Davranış | Varsayılan port | Kimlik doğrulama |
|---|---|---|---|
http:// | CONNECT kullanan HTTP proxy. | 80 | Yok veya Basic |
https:// | Önce proxy ile doğrulanmış bir TLS bağlantısı açar, ardından CONNECT kullanır. | 443 | Yok veya Basic |
socks5:// | SOCKS5, TCP ve UDP. Ana bilgisayar adları cihazınızda çözümlenir. | 1080 | Yok veya kullanıcı adı ve parola |
socks5h:// | SOCKS5, TCP ve UDP. Ana bilgisayar adları proxy tarafından çözümlenir. | 1080 | Yok 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 #
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 envveya 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 envkullanın. --install-service, bir hizmet bunları saklayamadığı için--proxy-userseçeneğini ve parola içeren proxy URL'lerini reddeder. Hizmeti--proxy envile 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 WebSocket | http_proxy, HTTP_PROXY, all_proxy, ALL_PROXY |
| HTTPS ve güvenli WebSocket | https_proxy, HTTPS_PROXY, all_proxy, ALL_PROXY |
| Ham TCP ve UDP | all_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 #
localtonet --authtoken <YOUR_TOKEN> --proxy http://proxy.example.com:3128 --http-transport httpsBir 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ğer | Ne 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. |
https | Sunucu bağlantıları için HTTPS taşımasını zorunlu kılar. |
raw | HTTPS 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 #
localtonet --terminal enable --authtoken <YOUR_TOKEN>
localtonet --terminal status --authtoken <YOUR_TOKEN>
localtonet --terminal disable --authtoken <YOUR_TOKEN>| Değer | Ne yapar |
|---|---|
enable | Bu 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. |
disable | Bu 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. |
status | Terminalin 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 #
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 #
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 #
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptime
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptimeCihazları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üm | Ne 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. |
--stdio | Kabuk 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 #
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 #
localtonet --versionİstemci sürümünü, örneğin v8.6, yazdırır ve çıkar.
--help #
localtonet --helpYerleşik yardımı yazdırır ve çıkar. -h aynı işi yapar.
Ortam değişkenleri #
| Değişken | Etki |
|---|---|
LOCALTONET_HEADLESS | 1 headless modu açar. |
LOCALTONET_AUTH_TOKEN | Headless modda token. |
LOCALTONET_AUTH_TOKEN_FILE | Headless modda bir token dosyasının yolu. |
http_proxy, https_proxy, all_proxy, no_proxy ve bunların büyük harfli biçimleri | Proxy ayarları; yalnızca --proxy env ile. |
Çıkış kodları #
| Kod | Anlamı |
|---|---|
0 | Komut normal şekilde tamamlandı. |
1 | Bir Cihaz Terminali komutu başarısız oldu; örneğin onay kodunun süresi doldu veya cihaza ulaşılamadı. |
2 | Bir 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 #
localtonet --authtoken <YOUR_TOKEN>sudo localtonet --install-service --authtoken <YOUR_TOKEN>
sudo localtonet --status-service --authtoken <YOUR_TOKEN>docker run -d --restart unless-stopped -e LOCALTONET_AUTH_TOKEN=<YOUR_TOKEN> localtonet/localtonetlocaltonet --network
localtonet --authtoken <YOUR_TOKEN> --net Mobile --ip 10.20.30.40export all_proxy=http://proxy.example.com:3128
localtonet --authtoken <YOUR_TOKEN> --proxy env