Uzak Nethür Sunucuları

Nethür'ü başka bir bilgisayarda çalıştırın ve tarayıcı, masaüstü uygulaması veya telefondan bağlanın.

Bir Uzak Nethür Sunucusu, bir makine işi yaparken tarayıcı, masaüstü uygulaması veya telefonun arayüzü sağlamasına olanak verir. Sunucu projeleri, çalışma alanlarını, terminalleri, sekmeleri, sağlayıcı hesaplarını ve ajan oturumlarını tutar. İstemci o çalışan Nethür örneğine bağlanır.

En kolay kurulum, iki bilgisayarda da Nethür masaüstü uygulamasını Tailscale üzerinden bağlamaktır. Bu yol için nethur serve çalıştırmanız gerekmez.

Nerede ne çalışır

İstemci bilgisayar · Nethür istemcisi
  Arayüzü gösterir ve girdinizi gönderir
                 │
                 │ özel ağ yolu
                 ▼
Sunucu bilgisayar · Nethür sunucusu
  Depoları ve çalışma alanlarını saklar
  Terminalleri ve ajanları çalıştırır

Codex, Claude Code, OpenCode, git ve sağlayıcı CLI'lerini sunucu bilgisayarda kurun ve kimlik doğrulayın. Tarayıcınızda veya masaüstü uygulamanızda oturum açmak sunucuya otomatik taşınmaz.

Başsız bir nethur serve hostunda yönetilen Claude/Codex hesaplarını sunucu kabuğundan kaydedin (uzak istemci Hesap ekle'yi devre dışı bırakır):

bash
nethur account add --agent claude
nethur account add --agent codex
nethur account list

Ajan becerilerini Ayarlar arayüzü olmadan kurun veya yenileyin:

bash
nethur skills install --skill nethur-cli --skill orchestration
nethur skills update --all

Önerilen: özel ağ yolu

İhtiyacınız olanlar:

  • İki bilgisayarda Nethür kurulu ve güncel
  • İki bilgisayarda Tailscale kurulu
  • İki bilgisayar da aynı tailnet'te oturum açmış
  • Sunucu bilgisayar uyanık, çevrimiçi ve Nethür çalışıyor

Tailscale sunucuya genellikle 100. ile başlayan özel bir adres verir. Nethür o adresi bağlantı adresi seçicide ilk sıraya koyar.

1. Sunucuda bir erişim bağlantısı oluşturun

Oturumları çalıştırmaya devam edecek bilgisayarda:

  1. Nethür masaüstü uygulamasını açın.
  2. Ayarlar → Uzak Nethür Sunucuları altını açın.
  3. Bu uygulamayı sunucu olarak duyur altında Yeni Bağlantı'ya tıklayın.
  4. Bağlantı adresi için Tailscale adresini seçin. Genellikle 100.x.y.z gibi görünür.
  5. Erişim bağlantısı oluştur'a tıklayın.
  6. Bağlantıyı Başka bir Nethür istemcisini eşleştir altından kopyalayın.

Tailscale adresi eksikse Tailscale'in bağlı olduğunu doğrulayın ve Bağlantı adresi yanındaki yenile düğmesine tıklayın.

2. Sunucuyu Nethür'e ekleyin

İstemci olarak kullanmak istediğiniz bilgisayarda:

  1. Ayarlar → Uzak Nethür Sunucuları altını açın.
  2. Sunucu ekle'ye tıklayın.
  3. Uzak Sunucu gibi tanınabilir bir ad girin.
  4. Sunucudan gelen erişim bağlantısını yapıştırın.
  5. Sunucu ekle'ye tıklayın.
  6. Kayıtlı sunucu Bağlantı kesildi gösteriyorsa Bağlan'a tıklayın.
İstemcide: sunucuyu adlandırın, erişim bağlantısını yapıştırın ve ekleyin. Bu örnekte eşleştirme kodu gizlenmiştir.
İstemcide: sunucuyu adlandırın, erişim bağlantısını yapıştırın ve ekleyin. Bu örnekte eşleştirme kodu gizlenmiştir.
Bir Nethür masaüstü çalışma zamanını özel ağ üzerinden başka bir istemciyle paylaşın.
Bir Nethür masaüstü çalışma zamanını özel ağ üzerinden başka bir istemciyle paylaşın.

Sunucu eklemek onu kaydeder ama her yeni projeyi zorla ona taşımaz. Sunucu yönlendirmeli projeler, terminaller, sağlayıcı kontrolleri ve tarayıcı veya mobil devri varsayılan olarak o sunucuyu kullansın istiyorsanız Gelişmiş → Yeni projeler için varsayılan host altını açın.

Uzak sunucuyu kullanma

Sunucu Bağlı gösterdiğinde onu veya projelerinden birini seçin ve Nethür'ü normal kullanın. Terminaller, ajan süreçleri, dosyalar, çalışma alanları ve oturum durumu sunucu bilgisayarda yaşar.

Birkaç eşleştirilmiş istemci o sunucuyu paylaştığında kenar çubuğu filtresi Diğer istemci çalışma alanlarını gizle sunabilir; böylece bu cihaz yalnızca kendi oluşturduğu çalışma alanlarını listeler. Bkz. Çalışma alanları → Kenar çubuğu düzeni.

Bunun anlamı:

  • istemci tarayıcısı veya masaüstü uygulaması bağlantıyı kestiğinde ajanlar çalışmaya devam eder;
  • sunucunun bu ajanların kullandığı depoya, araçlara ve kimlik bilgilerine ihtiyacı vardır;
  • sunucu uyanık ve tailnet'e bağlı kalmalıdır;
  • istemciyi yeniden bağlamak veya Nethür'ü yeniden açmak sizi eşleştirilmiş sekmeleri çoğaltmadan sunucuya ait çalışma alanı, sekme ve görünür panel durumuna döndürür;
  • sunucuda sildiğiniz projeler her eşleştirilmiş istemcinin kenar çubuğundan kaybolur (kalıcı hayalet satırlar yok).

Erişim ve güvenlik

Nethür her eşleştirilmiş istemci için ayrı, iptal edilebilir bir jeton oluşturur. Sunucu bunları Paylaşılan Sunucu Erişimi altında listeler.

  • Bir izni iptal etmek için yanındaki çöp kutusu düğmesine tıklayın. O izni kullanan etkin istemciler hemen bağlantısı kesilir.
  • Başka bir bağlantı oluşturmak önceki kullanılmamış bağlantının yerini alır. Zaten eşleşmiş istemciler siz iptal edene kadar kendi izinlerini korur.
  • Tailscale ACL'lerini veya izinlerini kurulumunuzun izin verdiği kadar dar tutun.
  • Nethür portunu doğrudan genel internete yönlendirmeyin. Tailscale, WireGuard, güvenilir bir LAN, SSH yönlendirme veya kimlik doğrulamalı bir tünel tercih edin.
  • Başka bir bilgisayar için 127.0.0.1 seçmeyin. O adres yalnızca sunucunun kendisinde çalışır.

Alternatif: nethur serve

Host masaüstü penceresi olmadan çalışacaksa nethur serve kullanın — örneğin başsız bir Linux sunucusu veya hizmetle yönetilen bir VM. Oturum açık bırakabildiğiniz bir MacBook veya masaüstü için yukarıdaki uygulama içi kurulum daha basittir.

Nethür'ü ve paketlenmiş CLI'sini sunucuya kurun, sonra şunu çalıştırın:

bash
nethur serve --pairing-address <sunucu-tailscale-ip-veya-hostname>
# Linux
nethur-ide serve --pairing-address <sunucu-tailscale-ip-veya-hostname>

Örneğin:

bash
nethur serve --pairing-address 100.64.1.20
# Linux
nethur-ide serve --pairing-address 100.64.1.20

Komut:

  • Nethür çalışma zamanını masaüstü penceresi açmadan başlatır;
  • siz Ctrl-C'ye basana kadar ön planda çalışır;
  • bağlı uç noktayı ve bir çalışma zamanı eşleştirme URL'si yazdırır;
  • --pairing-address yalnızca istemcilerin arayacağı adres için kullanılır.

Yazdırılan eşleştirme URL'sini istemcide Ayarlar → Uzak Nethür Sunucuları → Sunucu ekle alanına yapıştırın.

Bir güvenlik duvarı, tünel veya hizmet tanımı sabit port gerektirdiğinde --port 6768 ekleyin:

bash
nethur serve --port 6768 --pairing-address 100.64.1.20
# Linux
nethur-ide serve --port 6768 --pairing-address 100.64.1.20

Aynı anda yalnızca bir host modu kullanın. Nethür masaüstü uygulaması o bilgisayarı zaten paylaşıyorsa aynı kurulum için ikinci bir nethur serve süreci başlatmayın.

nethur serve varsayılan olarak Nethür'ün kendi Node sunucusunda (nethurd) çalışır. nethurd bu bilgisayarda hizmet veremiyorsa masaüstü uygulamasının sunucusunu kullanır ve nedenini tek satırda yazdırır. Paketlenmiş macOS uygulamasında şu anda her zaman masaüstü uygulamasının sunucusunu kullanır; böylece eşleştirilmiş istemciler onu yine güncelleyebilir. Her zaman masaüstü uygulamasının sunucusunu kullanmak için NETHUR_SERVE_RUNTIME=electron ayarlayın.

Linux sunucuda terminal belleğini sınırlama

Varsayılan olarak bir terminalin süreçlerinin ne kadar bellek kullandığını hiçbir şey sınırlamaz; bu yüzden tek bir kaçak iş tüm sunucuyu çekirdeğin bellek yetersizliği öldürücüsüne itebilir. Linux'ta nethur serve başlatan ortamda (veya hizmet biriminde) şu değişkenleri ayarlayarak her terminali sınırlayabilirsiniz:

bash
export NETHUR_TERMINAL_MEMORY_MAX=16G      # terminal başına bellek, 256M veya üstü
export NETHUR_TERMINAL_MEMORY_SWAP_MAX=0   # terminal başına takas; 0 takas yok demek
nethur-ide serve --pairing-address 100.64.1.20
  • Her terminal zaten kendi systemd kullanıcı kapsamında çalışır. Sınırlar o kapsamın MemoryMax ve MemorySwapMax değerleri olur.
  • Bir terminal sınırını aştığında çekirdek en büyük sürecini öldürür. Genellikle bu iştir ve kabuk çalışmaya devam eder. Sunucu ve diğer tüm terminaller çalışmaya devam eder.
  • Sınırlar varsayılan olarak kapalıdır çünkü Nethür iş yükleriniz için makul bir sınırın ne olduğunu bilemez.
  • cgroup v2'li systemd ve oturum kapanışından sonra yaşayan bir kullanıcı yöneticisi gerektirirler (loginctl enable-linger <kullanıcı>). Host bir sınırı uygulayamıyorsa Nethür onu atlar, terminal host günlüğüne terminal-memory-limits yazar ve terminalleri sınırsız başlatır.
  • Nethür bunları yalnızca terminal host süreci başladığında okur. Bu süreç nethur serve yeniden başladığında çalışmaya devam eder; bu yüzden terminaller o da yeniden başlayana kadar (örneğin sunucu yeniden başladıktan sonra) eski sınırlarını korur.
  • macOS veya Windows'ta etkileri yoktur.

Başsız sunucudan mobil

Nethür mobil uygulaması için mobil kapsamlı bir QR kodu ve bağlantı isteyin:

bash
nethur serve --pairing-address 100.64.1.20 --mobile-pairing
# Linux
nethur-ide serve --pairing-address 100.64.1.20 --mobile-pairing

Telefonu aynı tailnet'te tutun, Nethür Mobile'ı açın, Eşleştir'i seçin ve terminal QR kodunu tarayın veya yazdırılan bağlantıyı yapıştırın.

Masaüstü uygulaması mı, nethur serve mi?

Sunucuda masaüstü uygulamasınethur serve
En uygunEski bir dizüstü, Mac mini veya masaüstüBaşsız bir Linux kutusu, VM veya yönetilen hizmet
KurulumAyarlar ve düğmelerTerminal komutu ve hizmet yapılandırması
Sunucu penceresiAçıkYok
Erişim bağlantısıYeni Bağlantı → Erişim bağlantısı oluşturTerminalde yazdırılır
ÖmürMasaüstü uygulaması çalışırkenÖn plan süreci veya hizmet çalışırken

Uzak Nethür Sunucusu mu, SSH mı?

Nethür sunucusu çalışma zamanının sahibi olacak ve başka bir makineyi yalnızca seçili çalışma alanlarını ve terminalleri çalıştırmak için kullanacaksa SSH worktree'leri kullanın.

Diğer makine tam Nethür çalışma zamanının sahibi olacak ve masaüstü, tarayıcı, mobil veya otomasyon istemcileri için paylaşılan oturumları koruyacaksa bir Uzak Nethür Sunucusu kullanın.

Tam karşılaştırma için Nethür'ü çalıştırma yolları sayfasına bakın.

Sorun giderme

Tailscale adresi listelenmiyor

Sunucuda Tailscale'in bağlı olduğunu doğrulayın, sonra Bağlantı adresi yanındaki yenile düğmesine tıklayın. İki bilgisayar da aynı tailnet'te oturum açmış olmalıdır. Bir Tailscale IPv4 adresi genellikle 100. ile başlar.

Sunucu bağlantısı kesildi

Sunucu bilgisayarın uyanık, Nethür'ün hâlâ çalışıyor ve Tailscale'in iki cihazı da çevrimiçi gösterdiğini doğrulayın. Bir cihaz diğerine ulaşamıyorsa tailnet ACL'lerinizi veya izinlerinizi kontrol edin.

Sunucu satırı uyumsuz bir protokol sürümü bildiriyorsa iki bilgisayarda da Nethür'ü güncelleyin.

Erişim bağlantısı yanlış kişiyle paylaşıldı

Sunucuda Ayarlar → Uzak Nethür Sunucuları → Paylaşılan Sunucu Erişimi altını açın ve o izni iptal edin. Hedeflenen istemci için yeni bir bağlantı oluşturun.

Sunucu bir ajan CLI'sini bulamıyor

O CLI'yi sunucu bilgisayarda kurun ve kimlik doğrulayın. Uzak oturumlar istemcinin değil sunucunun PATH, ev dizini ve kimlik bilgilerini kullanır.

nethur serve yanlış adresi duyuruyor

Komutu durdurun ve istemcinin ulaşabildiği bir adresle yeniden başlatın:

bash
nethur serve --pairing-address <ulaşılabilir-tailscale-ip-veya-hostname>

Uzak bir istemci için joker adres veya 127.0.0.1 kullanmayın.

Sonraki adımlar