SSH worktree'leri
Nethür ajanları SSH üzerinden uzak makinelerde çalıştırabilir — uzun süren derlemeler, GPU makineleri veya işi çalıştırmak için Nethür sunucusunun doğru yer olmadığı herhangi bir ortam için kullanışlıdır.
SSH hedefi ekleme
- Ayarlar → SSH altını açın.
- Hedef ekle'ye tıklayın. Host formu bir pencerede açılır (listenin altında satır içi değil); böylece uzun host listesinde bile Host, Gelişmiş ve Kaydet erişilebilir kalır. Düzenleme aynı iletişim kutusunu kullanır ve hedef etiketini ve
kullanıcı@host:portbilgisini gösterir. - Host, kullanıcı, port ve isteğe bağlı kimlik dosyasını doldurun — veya aynı iletişim kutusundaki OpenSSH yapılandırması seçicisini açarak
~/.ssh/config(dahil edilenIncludedosyaları dahil) içinde arayın, bir host seçin ve formu önceden doldurun. Nethür'de zaten kayıtlı hostlar Nethür'de rozeti gösterir. Bu akış mevcut olduğunda hostları yapılandırmadan toplu olarak da içe aktarabilirsiniz. - Anahtar parola korumalıysa Nethür ilk seferde sorar.
- Bağlantıyı doğrulamak için Test et'e, sonra Kaydet'e tıklayın.
Kirli ekle/düzenle formları dışarıya tıklamaları yok sayar; böylece yanlışlıkla dışarıya tıklamak alanlarınızı atmaz. Atmak için Escape, İptal veya × kullanın.
Host anahtarı doğrulama
Nethür yerleşik SSH bağlantılarını etkin OpenSSH known_hosts dosyalarınıza ve daha önce kaydettiği anahtarlara karşı kontrol eder. Mevcut eşleşmeler sessizce bağlanır. Varsayılan politikayla Nethür bir hostu ilk temasta kabul eder ve hatırlar ve parmak izini gösterir; StrictHostKeyChecking yes bilinmeyen hostları reddeder, no / off ise güven kaydı kaydetmeden kabul eder.
Değişmiş, iptal edilmiş veya beklenmedik şekilde farklı bir anahtar türü, Nethür parola veya anahtar parolası istemeden önce reddedilir. Hostu bilinçli olarak yeniden kurduysanız veya yeniden sağladıysanız önce yeni parmak izini doğrulayın, sonra hatadaki kurtarma yolunu izleyin. Bir known_hosts uyuşmazlığında Nethür uygun ssh-keygen -R komutunu sağlar (gerektiğinde köşeli parantezli host ve port dahil).
Hedef kullanma
Çalışma alanı oluştururken Yerel yerine bir SSH hedefi seçin. Nethür şunları yapar:
- Git çalışma alanını uzak hostta oluşturur.
- Ajanları SSH bağlantısı üzerinden uzakta çalıştırır.
- Dosya olaylarını eşitler; böylece editör, diff ve tarayıcı hâlâ yerel hissettirir.
Gelişmiş bağlantı seçenekleri
Host bir proxy, atlama hostu veya SSH çoklama geçersiz kılması gerektirdiğinde Ayarlar → SSH altını açın, bir hedefi düzenleyin ve Gelişmiş Bağlantı'yı genişletin. Nethür varsayılan olarak Daha hızlı kurulum için SSH bağlantısını yeniden kullan'ı etkinleştirir; bu, macOS ve Linux'ta OpenSSH bağlantı yeniden kullanımını kullanır ve kurulum komutları her seferinde yeni bir SSH el sıkışması ödemez. Yalnızca SSH politikası çoklanmış oturumları reddeden hostlar için kapatın.
Parolalar
Parolalar Nethür oturumunun ömrü boyunca bellekte tutulur. Nethür'ü kapatmak onları temizler. SSH ayarları altında daha uzun bir TTL'i tercih edebilirsiniz.
Durum
Uzak çalışma alanları canlı SSH durumuyla bir çip gösterir — yeşil bağlı, sarı yeniden bağlanıyor, kırmızı bağlantı kesildi. Bir SSH hostu hâlâ bağlanırken Nethür çalışma alanlarını kalıcı yerel meta veriden listeleyebilir; böylece canlı sağlayıcı gelene kadar kenar çubuğu boş kalmaz; bu satırlar bağlantı oturduğunda yetkili uzak duruma yenilenir. Bağlantı kopmaları çalışan ajanları öldürmez; Nethür yeniden bağlanır ve kaydırma çıktısını yeniden oynatarak ve tam ekran uygulama panellerini boş veya parçalı bırakmak yerine oluşturulmuş çerçevelerinden geri yükleyerek yeniden bağlanır. Bir host düştüğünde etkilenen çalışma alanı kartı satır içi bir Bağlan / yeniden bağlan kontrolü gösterebilir; böylece terminal katmanı açmadan veya durum çubuğunu aramadan kurtulabilirsiniz. Bir SSH aktarıcısı "Multiplexer disposed" tarzı bir hatayla düşerse Nethür, paneli yeniden başlatana kadar takılı bırakmak yerine otomatik kurtarır. Ajan durumu (çalışıyor / boşta / engellendi) SSH üzerinden de yerelde olduğu gibi yayılır; böylece kenar çubuğu ve Ajan akışı uzak ajanları gerçek zamanlı yansıtır.
Uygulama kapanırken oturumlar
Masaüstü uygulamasını kapatmak artık uzak PTY oturumlarınızı öldürmez. Uzak terminal oturumları uzak hostta çalışan aktarıcı üzerinden kiralanır; böylece istemci kapansa da yaşarlar. Uygulamayı yeniden açıp hedefe yeniden bağlandığınızda kiralanmış PTY'ler bağlı durumda ve kaydırma geçmişleri bozulmadan sekmelerine geri yüklenir. Varsayılan olarak hiç geri sayım yoktur: Sıfırlanana kadar terminalleri canlı tut her hedef için açıktır; böylece ayrılmış oturumlar siz açıkça bitirene kadar çalışmaya devam eder — Uzak terminalleri bitir, Aktarıcıyı sıfırla, hedefi kaldırma veya sekmeyi kapatma. Bunun yerine o hedef için sınırlı bir Bağlantı kesildikten sonra zaman aşımı ayarlamak üzere Gelişmiş Bağlantı altında anahtarı kapatın; form 24 saatten başlar ve 60 saniye ile 7 gün arasını kabul eder; sonrasında aktarıcı ayrılmış oturumları sonlandırır. Bir hostla bağlantı kaybı, işinin durduğunun kanıtı değildir; bu yüzden şu anda ulaşamadığınız uzak bir oturumun öldüğünü varsaymamalısınız — aynı çalışma alanında ikinci bir ajan başlatmadan önce hostu kontrol edin.
Uzak dosya ve klasörleri indirme
SSH çalışma alanı dosya gezgininde sağ tıklayın:
- Dosya → İndir — yerel kaydet iletişim kutusu; dosyayı istemcinize kopyalar.
- Klasör → Klasörü indir — seçtiğiniz klasöre özyinelemeli indirme (yalnızca masaüstü).
Nethür bağlantıyla aynı SSH aktarım yolunu kullanır. Klasör indirme yalnızca bağlantı özyinelemeli klasör aktarımını (genellikle tam SFTP) duyurduğunda görünür. Yalnızca sistem OpenSSH'sinde kalan bağlantılar dosyaları indirebilir ama Klasörü indir göstermez.
Bu yalnızca masaüstü eylemidir — web istemcisi Electron'un kaydet iletişim kutusuna dayandığı için İndir'i sunmaz.
Uzak çalışma alanını VS Code'da açma
SSH çalışma alanları için çalışma alanı menüsünün Şurada aç listesi, yapılandırılmış uygulamanız VS Code veya VS Code Insiders ise (code / code-insiders veya bu başlatıcılara doğrudan yol) uzak yolu VS Code Remote-SSH'ye devredebilir.
- VS Code listelenmesi için Ayarlar → Genel → Şurada aç menüsünü yapılandırın (hazır ayar veya özel komut).
- SSH çalışma alanına sağ tıklayın (veya çalışma alanı taşma menüsünü kullanın) → Şurada aç → VS Code.
- Nethür VS Code'u o hosta ve çalışma alanı yoluna karşı Remote-SSH ile başlatır (
--remote ssh-remote+<host> <path>). Menü girişi bir Uzak SSH rozeti gösterebilir.
Bu uzak yol için desteklenmez: Cursor, Zed, bileşik kabuk komutları veya Uzak Nethür Sunucusu etkin çalışma zamanı üzerinden açma (bunlar Yalnızca yerel kalır). Finder/Explorer öğesini yalnızca yerel yollar için kullanın.
Kerberos / GSSAPI
OpenSSH yapılandırmasındaki bir host GSSAPIAuthentication yes ayarlıyorsa Nethür o hedef için sistem OpenSSH aktarımını tercih eder (yerleşik ssh2 istemcisi GSSAPI konuşmaz). Bağlanmadan önce geçerli bir Kerberos bileti tutun (kinit / kuruluşunuzun SSO'su). Elle hedefler de sistem SSH için yapılandırıldığında GSSAPI'yi etkinleştirebilir.
Yapılandırmadan içe aktarılan hostlar için ayrı bir "Kerberos modu" anahtarı çevirmezsiniz — içe aktarma/ssh -G bayrağı taşır.
FIDO2 / güvenlik anahtarları
Donanım destekli OpenSSH kimlikleri (ed25519-sk, ecdsa-sk, ajan destekli güvenlik anahtarları dahil) de yerleşik ssh2 istemcisi yerine sistem OpenSSH kullanır. Nethür anahtar türünü kimlik dosyalarınızdan algılar ve bağlantıyı işletim sisteminin OpenSSH ikilisine devreder; böylece dokunma / PIN istemi her zamanki gibi çalışır. Normal Ed25519, ECDSA ve RSA anahtarları yerleşik aktarımda kalır. Makinede OpenSSH yoksa kurulana ve PATH üzerinde (veya olağan Windows/macOS/Linux konumlarında) olana kadar bu FIDO2 hedefleri kimlik doğrulayamaz.
C/C++ araç zinciri olmayan Linux hostları
İlk bağlantıda Nethür uzakta küçük bir aktarıcı kurar. Uzak terminaller yerel bir node-pty modülü gerektirir. Linux paketleri genellikle hostta derlenir; macOS/Windows aktarıcıları önceden derlenmiş ikililer kullanır.
Uzakta make, bir C++ derleyicisi ve python3 eksikse Nethür bağlantıyı dosyalar, git ve editör için yine tamamlar ama derleme araçları kurulana kadar uzak terminaller çalışmaz. Nethür'ün gösterebileceği örnek kurulum ipuçları:
- Debian/Ubuntu:
sudo apt-get install -y build-essential python3 - Fedora/RHEL:
sudo dnf install -y make gcc gcc-c++ python3 - Alpine:
sudo apk add build-base python3 - Arch:
sudo pacman -S --needed base-devel python
Araçları kurun, sonra aktarıcı yerel modülleri kurabilsin diye yeniden bağlanın.
Port yönlendirme
Uzak çalışma alanları için sağ kenar çubuğu bir Portlar sekmesi gösterir (Cmd+Shift+I ile aç/kapat). Nethür uzakta /proc/net/tcp tarar ve dinleyen portları Algılananlar altında listeler — tek tık onları istemcinize yönlendirir. Yönlendirmeleri elle de ekleyebilir, düzenleyebilir veya kaldırabilirsiniz. Yönlendirmeler uygulama yeniden başlatmaları ve SSH yeniden bağlantıları arasında kalır ve ayrıcalıklı uzak portlar yerelde otomatik yeniden eşlenir (örneğin uzak 80 → yerel 10080).
macOS hostları: yerel ağ erişimi
macOS 15 ve sonrasında bir SSH hostundaki terminal, hostun yerel ağındaki cihazlara erişimini kaybedebilir (örneğin kubectl, Homebrew node veya python ya da .local adları no route to host ile başarısız olur). macOS ağ erişimini Nethür'ün yönetilen sunucusunu başlatan SSH oturumuna atfeder ve o oturum bittiğinde sunucunun terminallerinden başlatılan programlar engellenir. Apple'ın /usr/bin/curl gibi kendi araçları çalışmaya devam eder ve loopback bağlantıları etkilenmez. Uzak kullanıcılar için tam disk erişimine izin ver ile verilen Tam Disk Erişimi de aynı şekilde çalışmayı bırakabilir.
Nethür bunun olduğunu gördüğünde Ayarlar → SSH altındaki host durumu bunu söyler ve sunucuyu mevcut bağlantınızdan yeniden başlatan Yönetilen sunucuyu yeniden başlat… sunar. Nethür bunu yalnızca hostta çalışan terminal yokken yapar; çünkü hâlâ açık terminaller kaybedilen erişimi korur. Önce onları kapatın.
Sorunu tamamen önlemek için hosttaki bir yönetici yerel adres aralıklarını Yerel Ağ kontrolünden muaf tutabilir (macOS 15.5 ve sonrası; Apple'ın TN3179 belgesine bakın). Muafiyet o Mac'teki her uygulama için listelenen aralıklarda geçerlidir:
sudo defaults write com.apple.network.local-network AllowedEthernetLocalNetworkAddresses -array "10.0.0.0/8" "172.16.0.0/12" "192.168.0.0/16"
sudo defaults write com.apple.network.local-network AllowedWiFiLocalNetworkAddresses -array "10.0.0.0/8" "172.16.0.0/12" "192.168.0.0/16"Değişikliğin etkili olması için Mac'i yeniden başlatın. Geri almak için sudo defaults delete com.apple.network.local-network AllowedEthernetLocalNetworkAddresses (ve Wi-Fi anahtarı için aynısı) çalıştırın, sonra yeniden başlatın.