n8n-nodes-mikrotikos

Node n8n untuk mengelola MikroTik RouterOS (v6 & v7) via API. Dirancang untuk integrasi WhatsApp dengan sistem Smart Prompt berbasis kabel dinamis.

✨ Fitur Utama

• Dynamic Output Cables — Kabel output muncul/bertambah otomatis sesuai jumlah rule yang ditambahkan.
• Smart Routing (Auto Detection) — Membedakan perintah dengan parameter (#) dan tanpa parameter secara otomatis.
• Smart Unit Detection — Mengenali fungsi parameter berdasarkan panjang satuannya secara intuitif.

⚡ Aturan Penulisan Unit (Smarter Detection)

Sistem akan otomatis mendeteksi fungsi parameter tambahan berdasarkan jumlah huruf di belakang angka:

| Unit | Panjang Huruf | Fungsi | Contoh | |:---:|:---:|---|---| | kb, mb, gb | 2 Huruf | Kecepatan (Rate Limit) | 512kb, 1mb | | k, m, g | 1 Huruf | Kuota (Data Limit) | 50k, 1g | | d, h | 1 Huruf | Waktu (Masa Aktif) | 1d, 12h |

🚀 Perintah Built-in (Prompt Auto)

1. adduser (Smart Parsing)

Anda bisa memasukkan kecepatan, kuota, dan waktu sekaligus dalam satu pesan dengan urutan apa saja.

Contoh Perintah Campuran: !adduser#budi#123#default#512kb#50k#1d

Hasil Deteksi Otomatis:

• 512kb (2 huruf) ➔ Kecepatan (Set 512k/512k).
• 50k (1 huruf) ➔ Kuota (Set 50Kb).
• 1d (1 huruf waktu) ➔ Valid (Set 1 Hari).

Contoh Output di WhatsApp:

Add user baru berhasil
usernama : budi
password : 123
profile : default
limit kuota : 50k
kecepatan : 512k/512k
Valid : 1 Hari

2. generate (Voucher Massal)

• Format: !generate#jumlah#profile#limit#validity#comment
• Output: Berisi jumlah voucher dan daftar lengkap kode yang berhasil dibuat.

3. status (Advanced Monitoring)

• Format: !status
• Output: Laporan lengkap meliputi:
  • Resources: Uptime & CPU Load.
  • Memory & Disk: Kapasitas RAM & Storage (Free vs Total).
  • Bandwidth: Total data yang sudah lewat (GB).
  • System Logs: 5 baris kejadian terakhir di router.
  • Real-time Speed: Kecepatan Upload/Download (Kbps/Mbps) saat ini.

4. kick

• Format: !kick (List) atau !kick#username (Direct).

5. block (MAC-based)

• Format: !block#username
• Output: Info Nama, MAC, dan Waktu pemblokiran.
• Efek: User terputus dari jaringan dan tidak bisa lagi mengakses halaman Login (IP Binding Blocked).

6. unblock

• Format: !unblock#username
• Output: Konfirmasi pembersihan daftar blokir untuk MAC user tersebut.

7. addresslist

• Format: !addresslist#nama_list
• Output: Daftar seluruh IP Address yang ada di dalam Address List tersebut (lengkap dengan komentar jika ada).

8. help

• Format: !help ➔ Daftar lengkap perintah yang tersedia di router.

📖 Panduan Penggunaan (Step-by-Step)

1. Buat Credentials

• Tambahkan MikroTik Account. IP, Port (8728), User, Pass.

2. Setup Node

• Pilih Resource Hotspot dan Operation Prompt (Auto).
• Pada Incoming Message, masukkan ekspresi {{ $json.message.text }}.

3. Konfigurasi Kabel (Routing)

• Klik Add Dynamic Cable. Kabel akan muncul otomatis di sebelah kanan node.

🛠️ Instalasi

1. Buka n8n → Settings → Community Nodes.
2. Install: n8n-nodes-mikrotikos

Lisensi

MIT — by Paijo Ojiap