Mikrotik : Scripting Dasar RouterOS

Revision as of 08:48, 28 October 2026 by Maintenance script (talk | contribs) (Perbaiki format: konversi Markdown ke wikitext (bold, code, tabel))
(diff) ← Older revision | Latest revision (diff) | Newer revision β†’ (diff)

🎯 Tujuan

Setelah membaca dan mempraktikkan artikel ini, kamu bisa:

  • menjelaskan apa itu script RouterOS dan kapan sebaiknya dipakai;
  • membedakan variabel lokal dan global beserta batas wilayahnya;
  • memakai percabangan (:if) dan perulangan (:foreach, :for);
  • menyimpan script ke menu /system/script lalu menjalankannya;
  • memasang jadwal otomatis lewat /system/scheduler;
  • membaca log untuk membuktikan script benar-benar bekerja.

Ini pintu masuk otomasi di RouterOS. Setelah bisa menulis script sendiri, pekerjaan berulang seperti cek kapasitas IP atau laporan interface mati tidak perlu diketik ulang tiap pagi.

πŸ“ Konteks nyata

Bayangkan kamu admin lab di SMK. Setiap Senin pagi ada tiga tugas yang sama: mengecek sisa alamat IP untuk tiga lab, mencari interface mana yang mati, dan memastikan SSID tamu menyala lagi setelah listrik padam akhir pekan.

Dikerjakan manual, urutannya panjang dan mudah terlewat begitu bel masuk berbunyi. Apalagi kalau kamu sedang memperbaiki komputer lain di ruang sebelah.

  • Analogi: perintah CLI itu instruksi lisan, script itu SOP tertulis di dinding. Yang lisan hilang saat orangnya pergi, yang tertulis tetap ada dan bisa diwariskan ke siswa PKL.

πŸ”₯ Kasus nyata: Di sebuah SMK, pool DHCP lab 2 diisi 60 alamat untuk tiga kelas bergantian. Saat ujian CBT dimulai, 12 laptop mendapat alamat 169.254.x.x β€” tanda tidak dapat IP.

Penyebabnya bukan router rusak: pool penuh karena perangkat lama belum dilepas, dan tidak ada yang sadar sampai siswa mulai login. Setelah dibuat script yang mencatat jumlah lease dan menulis peringatan saat pemakaian lewat 80 persen, kondisi itu ketahuan dua hari sebelum ujian berikutnya.

🧠 Konsep singkat

Script RouterOS adalah kumpulan baris perintah yang disimpan sebagai teks di dalam router, lalu dijalankan berurutan dari atas ke bawah. Tidak ada compiler dan tidak ada file Python β€” semuanya hidup di dalam RouterOS.

πŸ”Ή Dari perintah manual ke perintah tersimpan

Setiap baris perintah di RouterOS punya bentuk:

[prefix] [path] command [uparam] [param=value] ...

Prefix menentukan jenis kata pertama:

Prefix Arti Contoh
: perintah global bawaan scripting :put "halo"
/ pindah ke menu konfigurasi /ip address print
tanpa prefix perintah di menu yang sedang aktif print

Akhir baris perintah ditandai ; atau baris baru. Tapi perintah di dalam (), [], atau {} tidak perlu penutup β€” kurungnya sudah menandai batas.

πŸ’‘ Tips: kalau bingung membedakan, ingat saja: : untuk bahasa script (variabel, if, loop), / untuk menu router (ip, interface, system).

πŸ”Ή Tiga bahan yang membuat script hidup

  • Variabel β€” tempat menyimpan nilai sementara, misalnya nama router atau jumlah lease.
  • Kendali alur β€” :if untuk memilih, :foreach dan :for untuk mengulang.
  • Pengambilan data β€” tanda [] menjalankan perintah lain dan mengambil hasilnya, misalnya [/system identity get name].

Tanpa tiga bahan ini, script hanya daftar perintah yang sama kakunya dengan mengetik manual.

πŸ”Ή Scope: kenapa variabel bisa hilang

Variabel hanya terlihat di wilayah tempat ia dideklarasikan. Ada dua jenis:

  • :local β€” hanya hidup di dalam blok {} tempat ia dibuat.
  • :global β€” bisa dibaca script lain milik user yang sama.

⚠️ Hati-hati: setiap baris yang kamu ketik di terminal dianggap satu scope sendiri. Jadi :local nama "lab" di satu baris akan hilang di baris berikutnya dan memunculkan syntax error. Di dalam file script, satu blok {} adalah satu scope.

🧩 Istilah penting

Istilah Arti sederhana
Command global Perintah berawalan :, misalnya :put, :local, :if.
Scope Wilayah berlakunya variabel; ditentukan oleh {}.
Variabel lokal Variabel yang hanya hidup di blok tempat ia dibuat.
Variabel global Variabel yang bisa dipakai script lain oleh user yang sama.
/system/script Gudang penyimpanan script di router.
/system/scheduler Penjadwal yang menjalankan script pada waktu tertentu.
on-event Isi jadwal: nama script atau perintah langsung.
Policy Daftar izin yang menentukan apa yang boleh dilakukan script.
:put Menampilkan nilai ke terminal (hanya berguna saat interaktif).
:log Menulis pesan ke log router; ini yang dipakai script terjadwal.

πŸ”§ Praktik: Scripting Dasar RouterOS

Lab ini memakai satu router uji. Jangan kerjakan di router produksi yang sedang melayani ujian.

πŸ”Ή Persiapan lab

  1. Siapkan router uji (boleh CHR di Proxmox atau perangkat lab).
  2. Pastikan /system identity dan jam router sudah benar.
  3. Catat konfigurasi awal dengan /export file=sebelum-scripting.
  4. Buka terminal Winbox atau SSH.

πŸ”Ή Langkah 1: coba perintah global

:put "Halo TKJ"
:put (3 + 4)
:put [:typeof 4]

Baris pertama menampilkan teks, baris kedua hasil hitungan, baris ketiga jenis data (num). Kalau salah satu baris menghasilkan syntax error, cek apakah prefix : sudah ikut ditulis.

πŸ”Ή Langkah 2: variabel dan teks

:local nama "Lab TKJ"
:local versi [/system resource get version]
:put "Router $nama pakai RouterOS $versi"

Tanda $ menyisipkan nilai variabel ke dalam teks. Kamu juga bisa menyambung dengan operator titik:

:put ("Router " . $nama)

Nama variabel hanya boleh huruf dan angka. Kalau perlu tanda hubung, bungkus dengan tanda kutip: :global "nama-router".

πŸ”Ή Langkah 3: ambil data dari menu RouterOS

Tanda [] menjalankan perintah dan mengembalikan hasilnya. Ini kunci script yang sadar situasi.

:put [/system identity get name]
:put [/ip dhcp-server lease print count-only]
:foreach i in=[/interface find where running=no] do={
    :local nm [/interface get $i name]
    :put "Interface $nm sedang down"
}

Baris terakhir memperkenalkan :foreach: untuk setiap interface yang tidak running, ambil namanya dan tampilkan. Di lab biasanya interface yang tidak dipakai akan muncul di sini.

πŸ“Š Angka penting: print count-only mengembalikan angka, bukan tabel. Ini jauh lebih ringan daripada mengambil seluruh daftar lalu menghitung sendiri.

πŸ”Ή Langkah 4: percabangan dengan :if

:local total [/ip dhcp-server lease print count-only]
:local batas 50
:if ($total >= $batas) do={
    :put "Pool hampir penuh: $total dari $batas"
} else={
    :put "Masih aman: $total dari $batas"
}

Kondisi ditulis di dalam (), aksi di dalam {}. Operator perbandingan yang tersedia: =, !=, <, >, <=, >=. Untuk logika pakai && (dan), || (atau), ! (bukan). Operator in dipakai untuk cek keanggotaan, misalnya 1.1.1.1/32 in 1.0.0.0/8.

πŸ’‘ Tips: tanda sama dengan untuk membandingkan hanya satu (=), bukan == seperti di bahasa lain. Ini kesalahan paling sering pemula.

πŸ”Ή Langkah 5: perulangan :for dan :while

:for i from=1 to=3 do={
    :put "Putaran ke-$i"
}

:local coba 0
:while ($coba < 3) do={
    :set coba ($coba + 1)
    :put "Percobaan $coba"
}

:for cocok untuk jumlah putaran yang sudah pasti. :while cocok untuk ulangi sampai kondisi terpenuhi β€” misalnya menunggu interface naik.

⚠️ Hati-hati: :while tanpa perubahan kondisi akan berputar selamanya dan membuat terminal hang. Selalu ubah variabel penghitung di dalam blok, atau tambahkan batas percobaan.

πŸ”Ή Langkah 6: simpan sebagai script

/system script add name=cek-pool-dhcp policy=read,write,test source={
    :local nama [/system identity get name]
    :local total [/ip dhcp-server lease print count-only]
    :local batas 50
    :log info ("[$nama] lease terpakai: $total")
    :if ($total >= $batas) do={
        :log warning ("[$nama] pool DHCP hampir penuh: $total / $batas")
    }
}

Setelah disimpan, jalankan manual untuk melihat hasilnya:

/system script run cek-pool-dhcp
/log print where topics~"script"

Perhatikan perubahan penting: :put diganti :log. Saat dijalankan scheduler, tidak ada orang yang melihat terminal, jadi satu-satunya bukti kerja script adalah log.

πŸ”Ή Langkah 7: jadwalkan dengan scheduler

/system scheduler add name=jadwal-cek-pool start-time=07:00:00 interval=1d \
    on-event=cek-pool-dhcp policy=read,write,test

Beberapa sifat penting scheduler:

  • start-date dan start-time default ke saat entri dibuat.
  • interval=0s (default) berarti script jalan sekali saja.
  • interval=1d berarti berulang tiap 24 jam, tetap mengikuti jam start.
  • start-time=startup menjalankan script setiap router menyala, tetapi sebelum interface naik.

πŸ’‘ Tips: untuk script yang butuh jaringan (ping, email, cek update), tambahkan penunggu di awal:

:local n 0
:while (([:len [/ip route find where dst-address=0.0.0.0/0 active]] = 0) && ($n < 60)) do={
    :delay 5s
    :set n ($n + 1)
}

πŸ”Ή Langkah 8: bungkus dengan :onerror

Script yang error di tengah akan berhenti dan sisa perintah tidak dijalankan. Supaya aman, bungkus bagian berisiko:

:onerror err in={
    :put [:resolve "contoh-domain-tidak-ada.invalid"]
} do={
    :log warning "Gagal resolve: $err"
}

Urutan parameter penting: in= harus ditulis sebelum do=, kalau tidak variabel error tidak terbaca di blok do.

πŸ”Ή Versi Winbox

  1. Buka System β†’ Scripts β†’ +.
  2. Isi Name cek-pool-dhcp, lalu tulis isi script di kotak Source.
  3. Buka tab Policy, centang hanya yang dibutuhkan (read, write).
  4. Klik Apply, lalu tombol Run untuk uji manual.
  5. Buka System β†’ Scheduler β†’ +, isi On Event dengan nama script, atur Start Time dan Interval.

πŸ”Ή Bersih-bersih lab

/system scheduler remove [find name=jadwal-cek-pool]
/system script remove [find name=cek-pool-dhcp]

Selalu hapus script uji dari router produksi. Script yang lupa dihapus bisa terus menulis log dan mengaburkan masalah asli.

🏭 Dipakai di dunia kerja

  • Sekolah: script menjadwalkan SSID tamu menyala pukul 07:00 dan mati pukul 16:00, sekaligus mencatat sisa lease DHCP. Admin tidak perlu mengingat dua hal itu setiap hari, dan guru tidak lagi mengeluh WiFi tamu mati saat rapat.
  • Kantor cabang: script mengecek default route tiap 10 menit; kalau jalur utama hilang, ia menulis peringatan ke log dan mengirim email ke IT. Tim bisa bertindak sebelum pengguna melapor.
  • ISP/warnet: script membaca jumlah user aktif hotspot tiap jam dan menulis statistik ke syslog. Dari data itu pemilik melihat jam ramai dan menyiapkan kapasitas, tanpa harus duduk memantau layar.
  • Industri: script mengekspor konfigurasi tiap malam ke file bertanggal, lalu memangkas file lama. Saat perangkat harus diganti, konfigurasi terbaru sudah tersedia dan waktu henti produksi lebih pendek.
  • Laboratorium virtual: script memakai :deserialize untuk membaca data JSON dari controller dan menyiapkan konfigurasi awal router baru β€” pola yang sama dipakai untuk provisioning massal.

βœ… Verifikasi

Jalankan pemeriksaan ini setelah lab:

/system script print detail where name=cek-pool-dhcp
/system script run cek-pool-dhcp
/log print where topics~"script"
/system scheduler print detail where name=jadwal-cek-pool

Yang harus terlihat:

  • script muncul dengan policy=read,write,test sesuai yang kamu beri;
  • setelah run, ada baris log berisi nama router dan jumlah lease;
  • scheduler menampilkan run-count bertambah dan next-run terisi;
  • tidak ada pesan not enough permissions di log.

πŸ§ͺ Uji cepat: ubah sementara batas menjadi 1, jalankan script, dan pastikan log warning muncul. Kalau peringatan tidak muncul, masalahnya ada di kondisi :if, bukan di scheduler.

⚠️ Kesalahan umum & troubleshooting

Gejala Penyebab Perbaikan
syntax error di baris kedua :local dideklarasikan di baris terminal sebelumnya Tulis dalam satu blok {} atau pakai :global
bad command name Prefix : atau / lupa ditulis Periksa kata pertama baris
Script jalan, log kosong Memakai :put di script terjadwal Ganti dengan :log info atau :log warning
not enough permissions (9) Policy script atau scheduler kurang Tambah policy yang dibutuhkan (read, write, test)
Script jalan dua kali bersamaan Interval lebih pendek dari durasi script Perpanjang interval atau pasang penjaga :jobname
Perintah setelah satu baris tidak jalan Satu baris error menghentikan seluruh script Bungkus bagian rawan dengan :onerror
Ping atau email gagal hanya saat startup Interface belum naik Tambahkan loop tunggu seperti di Langkah 7
Variabel error kosong di :onerror Urutan in= dan do= tertukar Tulis in= lebih dulu
Script tidak bisa disimpan Isi melebihi batas editor sekitar 30 ribu karakter Pecah jadi beberapa script
no such item Nama script salah atau belum dibuat Cek /system script print

πŸ”₯ Kasus nyata: Sebuah lab sekolah memasang script notifikasi dengan :put lalu bingung karena tidak ada hasil. Script sebenarnya berjalan sempurna β€” hanya saja output :put masuk ke terminal yang tidak ada saat dijalankan scheduler. Setelah diganti :log warning, pesan langsung muncul di menu Log dan bisa dibaca dari Winbox.

πŸ” Catatan keamanan & etika

  • Beri policy seperlunya. Script yang hanya membaca cukup read; jangan langsung memberi sensitive atau reboot.
  • Jangan simpan password di dalam script. Isi script ikut terbaca di /export, Winbox, dan backup. Kalau perlu rahasia, gunakan mekanisme terpisah dan batasi akses user.
  • Batasi siapa yang boleh menulis script. User dengan policy write dan policy bisa mengubah perilaku router secara permanen.
  • Review sebelum menempel. Jangan menyalin script dari internet lalu menjalankannya di router produksi tanpa membaca isinya.
  • Uji di lab, bukan saat ujian. Script yang salah bisa mematikan interface atau menghapus aturan firewall di tengah jam layanan.
  • Jaga log tetap berguna. Script yang menulis log tiap detik akan menutupi pesan penting. Pilih interval yang wajar.

πŸ“Œ Kesimpulan

Script RouterOS adalah cara mengubah perintah manual menjadi prosedur yang bisa dijalankan siapa saja, kapan saja. Kuncinya hanya tiga: variabel untuk menyimpan nilai, kendali alur untuk mengambil keputusan, dan [] untuk membaca keadaan router.

Mulai dari script kecil yang menulis satu baris log. Setelah itu tambahkan penjadwalan, penanganan error, dan policy yang tepat. Jangan mulai dari script panjang yang belum kamu pahami.

Langkah berikutnya: pelajari cara mengukur throughput dengan Bandwidth Test, supaya script yang kamu buat bisa dipakai memantau kualitas jalur, bukan hanya mencatat kejadian.

πŸ”— Materi terkait

πŸ“š Referensi