Port tünelleme

Bu belge, panelin «Port tünelleme» işlevini tanıtır — genel IP'si olmayan bir tünelleme sunucusundaki uygulama portunu panel sunucusunun genel portuna eşleyerek dışarıdaki kullanıcıların erişebilmesini sağlamak.

Tek cümleyle

Sunucunuz iç ağda saklı (genel IP'si yok) ve üzerinde bir site veya uygulama çalışıyor; dışarıdaki insanlar ona erişemiyor. Port tünelleme, «panel sunucusunda bir genel port açıp dışarıdan gelen erişimi şifreli tünel üzerinden sizin iç ağ sunucunuzdaki uygulama portuna taşımaktır». Sonuç: Dışarıdaki bir kişi panel-sunucusu-IP:port adresine eriştiğinde, iç ağ sunucunuzdaki uygulamaya erişmiş olur.

İşlev özeti

«Tünelleme ile yönetim» üzerinden bağlanan genel IP'si olmayan sunucularda çalışan uygulamalara (örneğin Navidrome müzik, Nextcloud bulut depolama, Memos notlar) dışarıdan erişilemez. Port tünelleme, bu uygulama portlarını panel sunucusunun (genel IP'li) portlarına eşler; böylece dışarıdaki kullanıcılar «panel sunucusu IP:port» üzerinden erişebilir.

Uygun senaryolar

• Tünelleme sunucusunda bir Web uygulaması çalışıyor ve dışarıdan erişilmesini istiyorsunuz
• İç ağ cihazının hizmetini genel ağa açmak
• Genel IP'si olmayan cihazlardaki site, API ve panellere bir genel ağ girişi sağlamak

Mantık (veri nasıl akar)

Dış kullanıcı → panel sunucusu genel portu (örneğin :9117) → şifreli tünel → tünelleme sunucusu uygulama portu (örneğin :9117)

Dış trafik önce panel sunucusuna (tek genel IP'li yer) ulaşır, ardından şifreli bir ters tünel üzerinden iç ağ cihazına gider ve son olarak cihazda gerçekten çalışan uygulama portuna iner.

Tek tip kanal (tüm cihazlar, elle seçim gerekmez):

Panel tümüyle 4433 ters tünelini kullanır; tünelleme oluştururken alttaki kanalı bilmenize ve elle seçmenize gerek yoktur.

> Ek not: Android/Termux cihazlarının sistem yönetimi (komut çalıştırma, terminal, dosyalar) SocketIO kararlı kanalından geçer; ancak port tünelleme tümüyle 4433 ters tünelini kullanır. İkisi kendi işini yapar, birbirini etkilemez.

Kullanım

1. Hedef cihazın «Tünelleme ile yönetim» üzerinden bağlandığından (Agent çevrimiçi) emin olun

2. «Port tünelleme»yi açın, «Tünelleme ekle»ye tıklayın

3. Tünelleme sunucusunu (Agent) seçip şunları doldurun:

• Dinleme portu: panel sunucusunun genel portu (dışarıdan erişim için), örneğin 9117
• Hedef port: tünelleme sunucusundaki uygulama portu, örneğin 8080

4. Oluşturulduktan sonra dışarıdan http://panel-sunucusu-IP:dinleme-portu adresine erişilebilir

Örnek

Panel sunucusunun genel IP'si 203.0.113.10 olsun ve iç ağdaki bir Raspberry Pi'de Navidrome çalışıyor olsun (4533 portunu dinliyor):

• Dinleme portuna 4533 yazın
• Hedef porta 4533 yazın
• Oluşturulduktan sonra dışarıdaki kullanıcı http://203.0.113.10:4533 adresine erişerek Raspberry Pi'deki Navidrome'u açabilir

Kaynak üst sınırları

Sınır aşılırsa yeni bağlantılar otomatik reddedilir; çalışan tünellemeler etkilenmez.

Dikkat edilecekler

1. Bulut güvenlik duvarı: Panel sunucusunun bulut güvenlik duvarı / güvenlik grubu ilgili dinleme portuna izin vermelidir; aksi halde dışarıdan erişilemez.

2. Agent sürümü: SSH dışı portları (22 dışındakileri) yönlendirmek için tünelleme sunucusuna yeni sürüm Agent kurulu olmalıdır (eski sürüm yalnızca 22 portunu yönlendirir). Başka portları yönlendirmek istiyorsanız Agent'ı yeniden kurun.

3. Agent çevrimiçi olmalı: Tünelleme, Agent'ın çevrimiçi kalmasına bağlıdır. Agent çevrimdışı olduğunda tünelleme kesilir; yeniden bağlandığında otomatik olarak geri gelir.

4. Panel yeniden başlatıldığında otomatik geri gelir: Panel servisi yeniden başlatıldıktan sonra tünellemeler otomatik olarak geri yüklenir (Agent yeniden bağlandığında tetiklenir).

5. Android hedef hizmeti eşzamanlılığı desteklemelidir: Android üzerinde tünellenen hedef hizmet (örneğin python3 -m http.server) tek iş parçacıklıysa ve keep-alive açıksa, kapatılmayan bir bağlantı sonraki istekleri bloke eder. Hedef hizmetin çok iş parçacıklı olması veya bağlantıların zamanında kapatılması önerilir.

İlgili belgeler

• Tünelleme ile yönetim — önce genel IP'si olmayan cihazı panele bağlayın
• Port yönlendirme — genel IP'li sunucularda geleneksel port yönlendirme (ikisinin farkı aşağıda)

Port tünelleme ile port yönlendirme (nasıl seçilir)

Tek cümleyle: Genel IP yoksa tünelleme, genel IP varsa yönlendirme kullanın.