NetMon adalah proyek magang untuk mendukung pemantauan jaringan di Dinas Kearsipan dan Perpustakaan Provinsi Jawa Tengah (Dinas Arpus Jateng). Aplikasi ini memantau router MikroTik, menampilkan perangkat dan data DHCP/ARP, serta mendeteksi indikasi konflik alamat IP. Syslog dan notifikasi Telegram membantu petugas melihat peristiwa jaringan; pemantauan hanya mencakup router yang didaftarkan secara manual dan tidak mengubah konfigurasi router.
Pilih salah satu cara berikut. Jangan jalankan kedua cara bersamaan karena keduanya memakai port web 8000.
Pasang dan jalankan Docker Desktop atau Docker Engine. Dari folder utama proyek, siapkan konfigurasi:
PowerShell:
if (-not (Test-Path .env)) { Copy-Item .env.example .env }Linux:
if [ ! -f .env ]; then cp .env.example .env; fiIsi nilai rahasia di .env, lalu jalankan semua layanan:
docker compose up -d --buildBuka http://localhost:8000. Perintah Docker yang umum:
docker compose ps # status layanan
docker compose logs -f web poller syslog
docker compose down # berhenti, data tetap disimpan
docker compose up -d --build # jalankan/bangun ulangJangan gunakan docker compose down -v kecuali memang ingin menghapus data database.
Pilihan ini memasang command yan agar bisa dipanggil dari folder mana pun oleh user Linux yang menjalankan installer. Instalasi ini tidak berlaku untuk semua user di komputer. Installer menyiapkan virtual environment Python khusus NetMon, membuat secret aplikasi jika belum ada, dan membangun penerima syslog Go; paket Python tidak dipasang ke Python sistem.
Persyaratan: Bash, Python 3.10+, Go 1.21+, dan akses internet saat instalasi dependensi.
Dari folder utama proyek:
bash yan.sh installTroubleshooting WSL untuk checkout lama: jika muncul error invalid option name atau \r: command not found, berkas yan.sh masih memakai format baris Windows (CRLF). Checkout terbaru menjaga file shell tetap dalam format Unix (LF). Untuk checkout lama, ubah formatnya sebelum menjalankan instalasi:
sed -i -e 's/\r$//' yan.sh
bash yan.sh installInstaller membuat .env dari .env.example jika belum ada. DJANGO_SECRET_KEY dan INGEST_TOKEN yang kosong atau masih bernilai contoh akan dibuat otomatis; nilai rahasia yang sudah diatur tidak diubah. File .env dibatasi agar hanya dapat dibaca oleh user saat ini. Pertahankan DJANGO_SECRET_KEY yang sama agar kredensial router tersimpan tetap dapat dibuka.
Command dipasang di ~/.local/bin/yan. Installer mengatur PATH otomatis untuk Bash atau Zsh. Setelah instalasi berhasil, aktifkan perubahan di terminal yang sedang dipakai:
Bash / WSL:
source ~/.bashrc
hash -rZsh:
source ~/.zshrc
hash -rLalu mulai NetMon:
yan upJika membuka terminal baru, aktivasi PATH biasanya tidak perlu diulang. Ini instalasi per-user, bukan system-wide untuk semua user.
Setelah instalasi, kelola semua layanan dengan:
yan up # mulai web, poller, dan penerima syslog
yan status # status layanan
yan logs # ikuti log semua layanan
yan logs web # ikuti log layanan tertentu
yan down # hentikan semua layanan
yan restart # mulai ulang semua layananBuka http://127.0.0.1:8000. Aplikasi memakai SQLite di django_app/db.sqlite3; yan down tidak menghapus data. Log dan PID proses disimpan di ~/.local/state/netmon.
Jika folder proyek dipindahkan, jalankan kembali bash yan.sh install dari lokasi barunya agar command yan menunjuk ke lokasi yang benar. Setelah memperbarui kode, jalankan bash yan.sh install lagi untuk memasang dependensi atau membangun ulang penerima syslog, lalu aktifkan PATH di terminal jika diminta dan jalankan yan restart.
Tanpa login aplikasi, web hanya diikat ke komputer lokal (127.0.0.1). Jangan ubah alamat bind atau menerbitkannya ke jaringan/internet tanpa menambahkan perlindungan akses. Penerima syslog mendengarkan UDP 5514; arahkan RouterOS ke IP komputer ini dan izinkan port tersebut di firewall jika ingin menggunakannya.