Tünelleme ile yönetim

Bu belge, panelin «Tünelleme ile yönetim» işlevini tanıtır — genel IP'si olmayan sunucuların panele bağlanmasını sağlar.

Tek cümleyle

Genel IP'si olmayan cihazlara (iç ağ makineleri, NAT arkasındaki cihazlar, Android telefonlar) dışarıdan «siz onlara bağlanamazsınız». Tünelleme ile yönetim, bu cihazların panele doğru kendilerinin «dışarı bağlanmasını» sağlar; ardından onları da normal sunucular gibi kullanabilirsiniz.

İşlev özeti

Genel ağdan erişilebilir adresi hiç olmayan cihazlara (iç ağ makineleri, NAT arkasındaki cihazlar, Android telefonlar vb.) doğrudan SSH bağlantısı kurulamaz. Tünelleme ile yönetim, ters tünel aracılığıyla bu cihazların panele kendiliğinden bağlanmasını sağlar; ardından onları da normal sunucular gibi yönetebilirsiniz.

Mantık

Panel sunucusu (genel IP'li) bir tünel servisi çalıştırır
Hedef cihaza hafif bir Agent kurulur; Agent kendiliğinden panele doğru «arama başlatır»
Bağlantı kurulduktan sonra panel bu tünel üzerinden hedef cihaza ters yönde SSH yapabilir

> Basit anlatımla: Hedef cihaz sanki panele «kendisi telefon eder»; hat kurulduktan sonra panel bu «özel hat» üzerinden onu yönetir.

Uygun senaryolar

Evdeki iç ağ cihazlarını yönetmek (Raspberry Pi, NAS, yazılım yönlendirici)
Genel IP'si olmayan ucuz VPS'leri (NAT sunucuları) yönetmek
Android telefonları yönetmek (Termux ortamı)

Kullanım (üç adım)

1. «Tünelleme ile yönetim»i açın, «Tek tıkla kurulum betiği»ne tıklayarak tek bir bağımsız komut oluşturun

2. Komutu hedef cihaza bir kez çalıştırın (Agent otomatik kurulur + açılışta otomatik başlatma ayarlanır)

3. Yaklaşık 10 saniye sonra cihaz panele otomatik olarak düşer; hemen SSH bağlantısı kurup tüm işlevleri kullanabilirsiniz

> Kurulum komutu bilerek kısa tutulmuştur, cihaz henüz hazır değilken elle yazabilmek için:

> - Linux (curl): curl -sSL http://sunucu:5501/i/<token> | sudo bash

> - Termux: curl -sSL http://sunucu:5501/t/<token> | bash

> - root iseniz sudo kısmını kaldırabilirsiniz; Alpine'da wget -qO- … | sudo bash, BSD'de fetch -o - … | sudo bash kullanın

> Kurulum konumu: Linux'ta varsayılan olarak /opt/sshe-agent (kurulum /opt yoksa veya yazılamıyorsa betik otomatik olarak ~/sshe-agent konumuna geri döner, hata vermez); Termux'ta ~/sshe-agent (Termux ile birlikte başlar).

> Parolasız bağlantı: Kurulumdan sonra panel, önceden enjekte edilmiş anahtarla cihaza parolasız bağlanır; her seferinde parola girmek gerekmez.

Agent'ın desteklediği ortamlar

Ortam	Kurulum yöntemi
Linux (apt/yum/dnf/apk)	Tek tıkla betik; bağımlılıkları otomatik kurar + systemd ile açılışta başlatır
Android / Termux	Özel betik (Agent'ı otomatik kurar + Termux ile birlikte başlar)

> ⚠️ macOS henüz desteklenmiyor: macOS sürümleri arasında SSH kimlik doğrulama farkları büyüktür ve sürümler arası kararlı bağlantı garanti edilemez; bu nedenle bu sürümde macOS için tünelleme erişimi sunulmaz. Tünelleme ile yönetim için lütfen Linux / Termux cihaz kullanın.

Agent çevrimiçi durumu

Çevrimiçi: Tünel bağlantısı sağlıklı, istendiği an işlem yapılabilir
Çevrimdışı: Cihaz bağlantısı kesildi (kapanma, ağ kesintisi, Agent durması). Çevrimdışı kayıt bir süre korunur; yeniden bağlandığında çevrimiçi duruma otomatik döner

> 📌 Sunucu kartı değerlendirmesi: Tünelleme cihazlarının «çevrimiçi/çevrimdışı» durumunu Agent'ın kalp atışı belirler. Agent çevrimiçi olduğunda tünel üzerinden dinamik olarak SSH kanalı kurup gerçek sağlık verilerini (yük/bellek/disk/çalışma süresi/pil/sıcaklık) toplar; normal sunucularla aynıdır.

Dikkat edilecekler

1. Agent, panelin hedef cihazda kurulmasını gerektirdiği tek programdır («sıfır iz» anlayışının istisnası). Çünkü genel IP'si olmayan cihazlara dışarıdan bağlanılamaz; yalnızca onların dışarı bağlanması mümkündür.

2. Agent'ın tükettiği kaynak yok denecek kadar azdır (bir Python süreci + bir uzun bağlantı).

3. Agent, verileri şifreli tünelle aktarır; iletişim güvenlidir.

4. Cihazın IP'si değişirse veya Agent bozulursa kurulum betiğini bir kez daha çalıştırmak yeterlidir.

Port tünelleme ile ilişkisi

Tünelleme ile yönetim «cihazı içeri bağlamaktan», Port tünelleme ise «cihazdaki uygulama portunu genel ağa açmaktan» sorumludur. İkisi birlikte çalışır: Önce tünelleme ile yönetimle genel IP'si olmayan cihazı bağlayın, sonra port tünelleme ile uygulamasını (örneğin Navidrome, Nextcloud) panel sunucusunun genel portuna eşleyin.

Belgeler