Penetrasi port

Dokumen ini menjelaskan fitur "Penetrasi port" pada panel — memetakan port aplikasi di server penetrasi yang tidak memiliki IP publik ke port publik server panel, sehingga pengguna luar dapat mengaksesnya.

Ringkas dalam satu kalimat

Server Anda tersembunyi di jaringan internal (tanpa IP publik) dan menjalankan sebuah situs web atau aplikasi yang tidak dapat diakses orang luar. Penetrasi port berarti "membuka sebuah port publik di server panel, lalu mengangkut akses dari luar melalui terowongan terenkripsi ke port aplikasi di server jaringan internal Anda". Hasilnya: orang luar yang mengakses IP server panel:port sama dengan mengakses aplikasi di server jaringan internal Anda.

Ringkasan fitur

Untuk server tanpa IP publik yang terhubung melalui "Operasional penetrasi", aplikasi di dalamnya (seperti Navidrome musik, Nextcloud penyimpanan cloud, Memos catatan) tidak dapat diakses dari luar. Penetrasi port memetakan port aplikasi tersebut ke port server panel (yang memiliki IP publik), sehingga pengguna luar dapat mengaksesnya melalui "IP server panel:port".

Skenario penggunaan

• Server penetrasi menjalankan aplikasi Web dan ingin diakses dari luar
• Mengekspos layanan perangkat jaringan internal ke internet publik
• Memberikan pintu masuk publik bagi situs web, API, dan panel pada perangkat tanpa IP publik

Prinsip (bagaimana data mengalir)

pengguna luar → port publik server panel (mis. :9117) → terowongan terenkripsi → port aplikasi server penetrasi (mis. :9117)

Trafik luar terlebih dahulu tiba di server panel (satu-satunya tempat yang memiliki IP publik), lalu melalui sebuah terowongan balik terenkripsi dikirim ke perangkat jaringan internal, dan akhirnya berakhir di port aplikasi yang benar-benar berjalan di perangkat tersebut.

Jalur terpadu (semua perangkat, tanpa perlu memilih manual):

Panel secara terpadu memakai terowongan balik 4433; saat membuat penetrasi tidak perlu memikirkan jalur di bawahnya dan tidak perlu memilih manual.

> Penjelasan tambahan: manajemen sistem (eksekusi perintah, terminal, file) perangkat Android/Termux melewati jalur stabil SocketIO; tetapi penetrasi port secara terpadu melewati terowongan balik 4433. Keduanya menjalankan perannya masing-masing dan tidak saling mengganggu.

Cara penggunaan

1. Pastikan perangkat tujuan sudah terhubung melalui "Operasional penetrasi" (Agent online)

2. Buka "Penetrasi port", klik "Tambah penetrasi"

3. Pilih server penetrasi (Agent), lalu isi:

• Port listen: port publik server panel (untuk akses dari luar), misalnya 9117
• Port tujuan: port aplikasi di server penetrasi, misalnya 8080

4. Setelah dibuat, pengguna luar dapat mengakses http://IP server panel:port listen

Contoh

Misalkan IP publik server panel adalah 203.0.113.10, dan Anda memiliki sebuah Raspberry Pi jaringan internal yang menjalankan Navidrome (listen 4533):

• Port listen diisi 4533
• Port tujuan diisi 4533
• Setelah dibuat, pengguna luar mengakses http://203.0.113.10:4533 untuk membuka Navidrome di Raspberry Pi tersebut

Batas sumber daya

Jika melebihi batas, koneksi baru akan ditolak otomatis, tanpa memengaruhi penetrasi yang sudah berjalan.

Catatan penting

1. Firewall cloud: firewall cloud/grup keamanan server panel perlu mengizinkan port listen terkait, jika tidak pengguna luar tidak dapat mengaksesnya.

2. Versi Agent: meneruskan port non-SSH (bukan 22) memerlukan server penetrasi yang sudah memasang Agent versi baru (versi lama hanya mendukung penerusan port 22). Jika ingin meneruskan port lain, pasang ulang Agent.

3. Agent online: penetrasi bergantung pada Agent yang tetap online. Saat Agent offline, penetrasi akan terputus dan otomatis pulih setelah tersambung kembali.

4. Pemulihan otomatis saat panel dijalankan ulang: setelah layanan panel dijalankan ulang, penetrasi akan pulih otomatis (dipicu saat Agent tersambung kembali).

5. Layanan tujuan di Android harus mendukung konkurensi: layanan tujuan yang dipenetrasi di Android (seperti python3 -m http.server) jika single-thread dan mengaktifkan keep-alive, koneksi yang belum ditutup akan memblokir permintaan berikutnya. Sebaiknya layanan tujuan memakai multi-thread, atau pastikan koneksi ditutup tepat waktu.

Dokumen terkait

• Operasional penetrasi — hubungkan dulu perangkat tanpa IP publik ke panel
• Penerusan port — penerusan port tradisional untuk server ber-IP publik (perbedaannya lihat di bawah)

Penetrasi port vs penerusan port (cara memilih)

Satu kalimat: tanpa IP publik gunakan penetrasi, dengan IP publik gunakan penerusan.