Script ini digunakan untuk mengontrol MikroTik Anda hanya dengan menggunakan sosial media Telegram. Terdapat banyak perintah untuk memantau, mengubah hotspot, menghapus user hotspot, menambahkan akun hotspot baru, mengubah password user hotspot, dan lain-lain.
Script ini bersifat open-source. Anda dapat memodifikasi, menambah, ataupun mengurangi isi dari script ini selama tidak melanggar ketentuan yang berlaku dalam lisensi MIT. Script ini TIDAK ADA GARANSI selama Anda menggunakannya.
- Perbaikan bug saat import script (error
invalid default argument) - Pembaruan perintah pada hotspot:
- Mengganti perintah
/hotspot usersmenjadi/hotspot session count - Mengganti perintah
/hotspot showallmenjadi/hotspot session showall - Menambah perintah baru:
/hotspot session deauth-by-mac,/hotspot session deauth-by-ip, dan/hotspot session deauth-by-user
- Perbaikan perintah:
/rebootkini dapat digunakan untuk menghidupkan ulang router (delay 30 detik)
- Penambahan kondisi baru:
- Setelah reboot, Router akan mengirimkan laporan via Telegram bahwa dirinya telah melakukan reboot dan mencatat semua kasus mengapa ia melakukan itu ke dalam "Critical Log" (jeda 30 detik setelah router selesai reboot).
- Versi pertama
Sebelum mulai instalasi, Anda harus memiliki Access Token untuk Bot Telegram dan ChatID nya. Ikuti link ini (labkom.co.id) untuk paduan cara membuat bot telegram Untuk cara menginstalnya, silahkan clone atau download repository ini, lalu:
- Ekstrak file ZIP yang sudah Anda download (lewati jika anda clone repository ini)
- Upload file
telegram_bot.rscke dalam MikroTik Anda (bisa lewat FileZilla FTP, bisa juga lewat WinBox) dan simpan ke folder utama (root atau /) di MikroTik Anda. - Setelah itu, buka Terminal MikroTik dan ketikkan perintah berikut:
import file-name=telegram_bot.rsc - Konfigurasikan pengaturan bot nya di
System > Scripts > tg_configdengan mengubah perintah berikut:
Isi dengan Access Token Bot Telegram Anda:
"botAPI"="xxxxxx:xxxxxxxx-xxxxxxx"
Isi dengan Access Token Bot Telegram Anda:
defaultChatID"="xxxxxxxxxx"
Isi dengan beberapa ChatID Anda, bisa personal, bisa grup. Pisahkan dengan tanda koma:
"trusted"="xxxxxxxxxx, xxxxxxxxx, -xxxxxxxxx"
Lalu simpan konfigurasinya.
- Selesai!
Ketikkan perintah berikut pada kolom chatting Anda dengan bot Telegram Anda. Setiap parameter yang dimasukkan, dipisahkan dengan menggunakan spasi, misalnya /interface show.
| Perintah | Parameter | Fungsi | Contoh |
|---|---|---|---|
/help |
Menampilkan daftar fungsi yang dapat dieksekusi | ||
/start |
Menampilkan daftar fungsi yang dapat dieksekusi | ||
/cpu |
Menampilkan Router ID, Load CPU, Uptime, dan total RAM yang terpakai | ||
/interface |
show |
Menampilkan status terhubungnya antar port Ethernet di MikroTik | /interface show |
/hotspot |
session count |
Menampilkan jumlah user yang sedang aktif | /hotspot session count |
/hotspot |
session showall |
Menampilkan seluruh detail user yang sedang aktif mulai dari Username sampai Uptime (kecuali password) | /hotspot session showall |
/hotspot |
session deauth-by-user <username> |
Mencabut session perangkat berdasarkan Username | /hotspot session deauth-by-user telecomadmin |
/hotspot |
session deauth-by-ip <ip> |
Mencabut session perangkat berdasarkan Alamat IP | /hotspot session deauth-by-ip 192.168.1.2 |
/hotspot |
session deauth-by-mac <mac address> |
Mencabut session perangkat berdasarkan Alamat MAC | /hotspot session deauth-by-mac AB:CD:EF:01:23:45 |
/hotspot |
add <username> <password> |
Menambahkan user hotspot baru | /hotspot add telecomadmin admintelecom |
/hotspot |
delete <username> |
Menghapus user hotspot secara permanen | /hotspot delete telecomadmin |
/hotspot |
disable <username> |
Mematikan atau menonaktifkan user hotspot | /hotspot disable telecomadmin |
/hotspot |
enable <username> |
Mengaktifkan user hotspot yang dinonaktifkan | /hotspot enable telecomadmin |
/hotspot |
change-password <username> <password baru> |
Mengubah password user hotspot | /hotspot change-password telecomadmin p4ssw0rdny4 |
/ping |
Melakukan ping ke DNS Google | /ping |
|
/ping |
to <ip address> |
Melakukan ping ke alamat IP tertentu | /ping to 127.0.0.1 |
/public |
Menampilkan Dynamic DNS dan Public IP pada MikroTik Anda | /public |
|
/enablehotspot |
Mengaktifkan seluruh fungsi hotspot | /enablehotspot |
|
/disablehotspot |
Menonaktifkan seluruh fungsi hotspot | /disablehotspot |
|
/forceupdateddns |
Memperbarui Dynamic DNS secara paksa | /forceupdateddns |
|
/reboot |
Menghidupkan ulang MikroTik (jeda 30 detik sebelum menghidupkan ulang) | /reboot |
Catatan: untuk dapat menjalankan perintah
/disablehotspot,/enablehotspot, dan/interface show, silakan Anda konfigurasikan sendiri hotspot mana yang akan di "otomatis" kan di scripttg_cmd_disablehotspot,tg_cmd_enablehotspot, dan ethernet mana saja yang akan ditampilkan ditg_cmd_interface.