Cara Instalasi Server

Panduan cepat untuk men-deploy NetScope Pro di server lokal, XAMPP, atau VPS Anda.

server-setup.sh

Persyaratan Sistem (Requirements)

  • PHP 8.1+ (Disarankan PHP 8.2)
  • MariaDB 10.4+ atau MySQL 8
  • Ekstensi PHP Wajib: snmp, pdo_mysql, curl
  • Nmap: Harus terinstal di OS Server dan bisa dipanggil via Terminal/CMD.

Langkah Instalasi & Konfigurasi (Standalone)

  1. 1 Clone / Copy Source Code Unduh atau clone source code NetScope Pro ke direktori web server Anda.
    git clone https://github.com/frambudi75/NetScopePro.git
  2. 2 Konfigurasi Database Buat database baru di MariaDB/MySQL. Buka file includes/config.php dan sesuaikan detail koneksi.
  3. 3 Aktifkan SNMP & Install Nmap
    # Untuk Pengguna XAMPP (Windows):
    1. Buka php.ini, cari ;extension=snmp lalu hilangkan titik komanya.
    2. Download dan install Nmap dari nmap.org

    # Untuk Ubuntu/Debian Linux:
    sudo apt update
    sudo apt install php8.2-snmp nmap
  4. 4 Konfigurasi Cron Jobs (Background Polling)
    # Tambahkan di crontab Linux:
    * * * * * php /path/ke/ipmanage/cron_switch_poll.php >> /dev/null 2>&1

Alternatif: Instalasi dengan Docker (Sangat Direkomendasikan)

Jika Anda ingin instalasi yang bersih tanpa mengotori server utama, gunakan Docker Compose. Environment ini sudah mencakup Nmap, PHP-SNMP, MariaDB, dan Redis secara otomatis.

  1. 1 Sesuaikan Konfigurasi (Opsional) Secara bawaan (*default*), aplikasi akan terekspos di Port 2025. Jika Anda ingin mengubah *port*, sandi database, atau konfigurasi *engine* pemantauannya, buka file docker-compose.yml.
    • Port Web: Ubah "2025:80" menjadi "80:80" jika ingin diakses langsung tanpa port.
    • Kredensial Database: Ubah variabel DB_USER, DB_PASS di layanan app dan wajib samakan dengan MARIADB_USER, MARIADB_PASSWORD di layanan db.
    • Mode Deteksi: Anda dapat mematikan Nmap Fallback dengan mengubah ENABLE_NMAP_FALLBACK=0 atau mengatur sensitivitas *offline* dengan OFFLINE_FAIL_THRESHOLD=3.
  2. 2 Jalankan Docker Compose Jalankan perintah berikut di terminal (pastikan Anda berada di folder yang sama dengan docker-compose.yml):
    docker-compose up -d --build

    Catatan: Saat pertama kali berjalan, container database akan otomatis membuat struktur tabel dari file sql/database.sql.

  3. 3 Selesai! Buka di Browser NetScope Pro Anda sekarang sudah online. Silakan akses melalui URL:
    http://localhost:2025 (atau sesuai port Anda)

    Container ini juga sudah menangani cron jobs secara otomatis (*background polling*) di dalam sistemnya.