Operasional penetrasi

Dokumen ini menjelaskan "Operasional penetrasi" pada panel — menghubungkan server tanpa IP publik ke panel.

Ringkas dalam satu kalimat

Untuk perangkat tanpa IP publik (mesin jaringan internal, perangkat di belakang NAT, ponsel Android), Anda tidak dapat "menyambung masuk secara aktif" dari luar. Operasional penetrasi membuat perangkat ini "menyambung keluar" secara aktif ke server panel, setelah itu Anda dapat mengoperasikannya seperti server biasa.

Ringkasan fitur

Untuk perangkat yang sama sekali tidak memiliki alamat yang dapat dijangkau publik (mesin jaringan internal, perangkat di belakang NAT, ponsel Android, dll.), koneksi SSH langsung tidak memungkinkan. Operasional penetrasi memakai terowongan balik agar perangkat ini secara aktif terhubung ke server panel, setelah itu Anda dapat mengoperasikannya seperti server biasa.

Prinsip

• Server panel (ber-IP publik) menjalankan layanan terowongan
• Di perangkat tujuan dipasang Agent ringan yang secara aktif "memanggil keluar" dan terhubung ke server panel
• Setelah koneksi terbentuk, panel dapat melakukan SSH balik ke perangkat tujuan melalui terowongan ini

> Pemahaman sederhana: perangkat tujuan seperti "menelepon secara aktif" ke server panel; setelah telepon tersambung, panel dapat mengendalikannya balik melalui "jalur khusus" ini.

Skenario penggunaan

• Mengelola perangkat jaringan internal di rumah (Raspberry Pi, NAS, router lunak)
• Mengelola VPS murah tanpa IP publik (server NAT)
• Mengelola ponsel Android (lingkungan Termux)

Cara penggunaan (tiga langkah)

1. Buka "Operasional penetrasi", klik "Skrip pemasangan satu klik" untuk membuat satu perintah khusus

2. Tempel perintah ke perangkat tujuan dan jalankan sekali (otomatis memasang Agent + mengatur mulai otomatis saat boot)

3. Sekitar 10 detik kemudian, perangkat otomatis muncul di panel dan siap dihubungkan melalui SSH serta memakai semua fitur

> Perintah pemasangan sengaja dibuat pendek, agar mudah diketik manual sebelum semuanya terpasang:

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

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

> - Jika sudah root, sudo dapat dihilangkan; Alpine memakai wget -qO- … | sudo bash, BSD memakai fetch -o - … | sudo bash

>

> Lokasi pemasangan: Linux secara default dipasang di /opt/sshe-agent (jika /opt tidak ada atau tidak dapat ditulis, skrip otomatis mundur ke ~/sshe-agent tanpa menimbulkan kesalahan); Termux memakai ~/sshe-agent (mengikuti startup Termux).

>

> Koneksi tanpa kata sandi: setelah pemasangan, panel akan terhubung ke perangkat tersebut tanpa kata sandi memakai kunci yang telah disuntikkan sebelumnya, tanpa perlu memasukkan kata sandi setiap kali.

Lingkungan yang didukung Agent

> ⚠️ macOS belum didukung: autentikasi SSH antar versi macOS berbeda cukup jauh sehingga koneksi lintas versi yang stabil tidak dapat dijamin; karena itu versi ini tidak menyediakan akses penetrasi untuk macOS. Silakan gunakan perangkat Linux / Termux untuk akses operasional penetrasi.

Status online Agent

• Online: koneksi terowongan normal, dapat dioperasikan kapan saja
• Offline: perangkat terputus (mati, jaringan putus, Agent berhenti). Catatan offline akan disimpan untuk sementara waktu dan otomatis kembali online setelah tersambung kembali

> 📌 Penentuan kartu server: status "online/offline" perangkat penetrasi ditentukan oleh detak jantung Agent. Setelah Agent online, ia akan secara dinamis membangun jalur SSH melalui terowongan untuk mengumpulkan data kesehatan yang sebenarnya (beban/memori/disk/waktu aktif/baterai/suhu), sama seperti server biasa.

Catatan penting

1. Agent adalah satu-satunya program yang perlu dipasang panel di perangkat tujuan (pengecualian dari prinsip "tanpa jejak"). Karena perangkat tanpa IP publik tidak dapat dihubungi secara aktif, hanya bisa ia yang menyambung keluar secara aktif.

2. Sumber daya yang dipakai Agent sangat kecil (satu proses Python + satu koneksi panjang).

3. Agent memakai terowongan terenkripsi untuk transmisi, komunikasinya aman.

4. Jika IP perangkat berubah atau Agent tidak berfungsi, cukup jalankan ulang skrip pemasangan untuk memulihkannya.

Hubungan dengan penetrasi port

Operasional penetrasi bertanggung jawab "menghubungkan perangkat masuk", sedangkan Penetrasi port bertanggung jawab "mengekspos port aplikasi di perangkat ke internet publik". Keduanya bekerja bersama: hubungkan dulu perangkat tanpa IP publik dengan operasional penetrasi, lalu petakan aplikasinya (seperti Navidrome, Nextcloud) ke port publik server panel dengan penetrasi port.