mikrotikos

n8n node for MikroTik RouterOS (v6 & v7)

Package Information

Released: 1 mo ago
Downloads: 60 weekly / 242 monthly
Latest Version: 5.4.5
Author: Paijo Ojiap

Available Nodes

MikroTik Smart icon
MikroTik Smart
Manage MikroTik RouterOS with Intelligent Dynamic Routing

Documentation

n8n-nodes-mikrotikos

MikroTik Logo

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

Discussion