Hotspot Voucher MikroTik RouterOS 7: Setup Lengkap + Script Teruji

Mau jualan Wi-Fi voucher di kampung, warung kopi, atau kos-kosan? Polanya hampir selalu sama: pelanggan konek ke Wi-Fi, muncul halaman login, masukkan kode voucher, lalu internet jalan dengan kecepatan sesuai paket. Di MikroTik, semua itu dikerjakan fitur Hotspot. Masalahnya, menyetel Hotspot dari nol lewat Winbox cukup panjang: IP, pool, DHCP, profil server, profil user, dan puluhan user voucher yang harus diketik satu per satu.

Di tutorial ini kita pakai generator Hotspot + Voucher di sii.ai.id. Alatnya gratis, berbahasa Indonesia, dan langsung membuatkan script RouterOS 7 lengkap dengan voucher acak. Script contoh di artikel ini adalah keluaran asli generator, dan sudah kami jalankan di router uji (CHR RouterOS 7.25) sampai benar-benar ada "pelanggan" yang login pakai voucher.

Ringkasnya: isi interface, IP gateway, daftar paket, dan jumlah voucher di sii.ai.id, lalu tempel script-nya ke Terminal. Hasilnya: hotspot jalan, tiap paket punya limit kecepatan, dan voucher siap dibagikan. Satu hal yang sering salah paham: kolom "masa aktif" di sini adalah batas lama satu kali login (session-timeout), bukan masa aktif kalender. Penjelasannya ada di bawah.

Daftar Isi

  1. Cara kerja Hotspot MikroTik
  2. Yang perlu disiapkan
  3. Langkah membuat script di sii.ai.id
  4. Script lengkap dan penjelasannya
  5. Hasil uji di router lab
  6. Cara mengecek di router kamu
  7. Session-timeout bukan masa aktif
  8. Masalah umum dan solusinya
  9. Tanya jawab
  10. Referensi

1. Cara Kerja Hotspot MikroTik

Hotspot adalah captive portal: semua perangkat yang tersambung ke interface hotspot dianggap "belum login" sampai berhasil memasukkan username dan password. Selama belum login, router menahan lalu lintas ke internet dan membelokkan setiap permintaan web (HTTP) ke halaman login. Begitu login berhasil, router mencatat perangkat itu sebagai user aktif dan membuatkan antrean (queue) dinamis sesuai limit kecepatan paketnya.

Komponen Fungsinya Nama di script
IP + pool + DHCPMemberi IP otomatis ke HP pelangganhs-pool, hs-dhcp
Profil server hotspotAlamat halaman login, cara login (CHAP, cookie), folder HTMLhsprof1
Server hotspotMenyalakan hotspot di interface tertentuhotspot1
Profil user (paket)Limit kecepatan, jumlah perangkat per akun, batas lama loginHarian-5M, Mingguan-10M, Bulanan-20M
User (voucher)Kode yang dibagikan ke pelanggankode acak, comment=voucher

2. Yang Perlu Disiapkan

  • MikroTik dengan RouterOS 7. Router uji kami memakai 7.25. Cek versi di System > Resources.
  • Router sudah bisa internet dan sudah punya NAT (masquerade). Script hotspot ini tidak membuat NAT. Kalau routermu masih kosong, jalankan dulu alat Setup Dasar di sii.ai.id (WAN, LAN, DNS, NAT, jam).
  • Satu port khusus untuk hotspot, misalnya ether2 yang menuju access point. Sebaiknya port ini tidak dipakai jaringan lain dan tidak menjadi anggota bridge. Kalau AP-mu memang terpasang di bridge, isi kolom interface dengan nama bridge-nya.
  • Access point dalam mode bridge/AP (bukan router), supaya HP pelanggan langsung mendapat IP dari MikroTik.
  • Backup dulu sebelum menempel script apa pun:
/system backup save name=sebelum-script

3. Langkah Membuat Script di sii.ai.id

Buka sii.ai.id/#hotspot. Alat Hotspot + Voucher ada di grup menu Hotspot. Formulirnya dibagi tiga tab, dan script di panel Terminal langsung berubah setiap kali kamu mengetik.

Form Hotspot + Voucher di sii.ai.id tab General: interface ether2, IP gateway 10.5.50.1, prefix 24, alamat login login.wifi, dengan script RouterOS di panel Terminal

  1. Tab General
    • Interface hotspot: port tempat pelanggan tersambung, misalnya ether2.
    • IP gateway hotspot dan Prefix: IP router di jaringan hotspot. Bawaannya 10.5.50.1/24, cukup untuk sekitar 250 perangkat. Untuk pelanggan yang lebih banyak, pakai prefix 22 (sekitar 1000 IP). Generator otomatis menghitung rentang pool dan alamat network-nya.
    • Alamat halaman login: nama yang muncul di browser pelanggan, misalnya login.wifi. Pakai nama yang tidak dipakai situs sungguhan.
  2. Tab Paket: satu paket per baris dengan format nama, kecepatan, batas lama login. Kecepatan ditulis upload/download seperti 2M/5M. Kalau hanya ditulis satu angka (misalnya 5M), generator memakainya untuk kedua arah.

    Tab Paket generator hotspot sii.ai.id berisi Harian-5M, Mingguan-10M, Bulanan-20M dengan kecepatan dan masa aktif

  3. Tab Voucher: jumlah voucher (maksimal 500 sekali buat), paket untuk voucher itu (harus sama persis dengan nama di tab Paket), panjang kode (4 sampai 12 karakter), dan awalan kode opsional, misalnya rt05 supaya voucher tiap lokasi mudah dibedakan. Tombol Acak ulang voucher membuat kode baru.

    Tab Voucher generator hotspot sii.ai.id: jumlah voucher, paket, panjang kode, awalan kode, tombol acak ulang

  4. Klik Salin atau Unduh .rsc, buka Winbox > New Terminal, lalu tempel.

Kode voucher dibuat acak di browser kamu dari huruf kecil dan angka, tanpa karakter yang gampang tertukar seperti i, l, o, 0, 1. Ini membantu pelanggan yang mengetik dari kertas voucher.

4. Script Lengkap dan Penjelasannya

Ini script yang dihasilkan sii.ai.id dengan setelan bawaan. Supaya contoh tidak terlalu panjang, jumlah voucher diubah jadi 5. Kode voucher di router kamu tentu akan berbeda:

# ==========================================
# Hotspot + Voucher
# dibuat oleh sii.ai.id — RouterOS v7
# Backup dulu: /system backup save name=sebelum-script
# ==========================================
# Aman dijalankan ulang: yang sudah ada diperbarui, voucher yang sudah ada dilewati.

# --- Jaringan hotspot ---
:if ([:len [/ip address find where address="10.5.50.1/24" interface=ether2]] = 0) do={ /ip address add address=10.5.50.1/24 interface=ether2 comment=hotspot }
:if ([:len [/ip pool find where name=hs-pool]] = 0) do={ /ip pool add name=hs-pool ranges=10.5.50.2-10.5.50.254 } else={ /ip pool set [find where name=hs-pool] name=hs-pool ranges=10.5.50.2-10.5.50.254 }
:if ([:len [/ip dhcp-server find where name=hs-dhcp]] = 0) do={ /ip dhcp-server add name=hs-dhcp interface=ether2 address-pool=hs-pool lease-time=1h disabled=no } else={ /ip dhcp-server set [find where name=hs-dhcp] name=hs-dhcp interface=ether2 address-pool=hs-pool lease-time=1h disabled=no }
:if ([:len [/ip dhcp-server network find where address="10.5.50.0/24"]] = 0) do={ /ip dhcp-server network add address=10.5.50.0/24 gateway=10.5.50.1 dns-server=10.5.50.1 } else={ /ip dhcp-server network set [find where address="10.5.50.0/24"] address=10.5.50.0/24 gateway=10.5.50.1 dns-server=10.5.50.1 }
/ip dns set allow-remote-requests=yes

# --- Server hotspot ---
:if ([:len [/ip hotspot profile find where name=hsprof1]] = 0) do={ /ip hotspot profile add name=hsprof1 hotspot-address=10.5.50.1 dns-name=login.wifi login-by=http-chap,cookie html-directory=hotspot } else={ /ip hotspot profile set [find where name=hsprof1] name=hsprof1 hotspot-address=10.5.50.1 dns-name=login.wifi login-by=http-chap,cookie html-directory=hotspot }
:if ([:len [/ip hotspot find where name=hotspot1]] = 0) do={ /ip hotspot add name=hotspot1 interface=ether2 address-pool=hs-pool profile=hsprof1 disabled=no } else={ /ip hotspot set [find where name=hotspot1] name=hotspot1 interface=ether2 address-pool=hs-pool profile=hsprof1 disabled=no }

# --- Paket ---
:if ([:len [/ip hotspot user profile find where name=Harian-5M]] = 0) do={ /ip hotspot user profile add name=Harian-5M rate-limit=5M/5M shared-users=1 session-timeout=1d } else={ /ip hotspot user profile set [find where name=Harian-5M] name=Harian-5M rate-limit=5M/5M shared-users=1 session-timeout=1d }
:if ([:len [/ip hotspot user profile find where name=Mingguan-10M]] = 0) do={ /ip hotspot user profile add name=Mingguan-10M rate-limit=10M/10M shared-users=1 session-timeout=7d } else={ /ip hotspot user profile set [find where name=Mingguan-10M] name=Mingguan-10M rate-limit=10M/10M shared-users=1 session-timeout=7d }
:if ([:len [/ip hotspot user profile find where name=Bulanan-20M]] = 0) do={ /ip hotspot user profile add name=Bulanan-20M rate-limit=20M/20M shared-users=1 session-timeout=30d } else={ /ip hotspot user profile set [find where name=Bulanan-20M] name=Bulanan-20M rate-limit=20M/20M shared-users=1 session-timeout=30d }

# --- 5 voucher paket Harian-5M (username = password) ---
:if ([:len [/ip hotspot user find where name=f7kepe]] = 0) do={ /ip hotspot user add name=f7kepe password=f7kepe profile=Harian-5M comment=voucher }
:if ([:len [/ip hotspot user find where name=ft86ec]] = 0) do={ /ip hotspot user add name=ft86ec password=ft86ec profile=Harian-5M comment=voucher }
:if ([:len [/ip hotspot user find where name=bfszv5]] = 0) do={ /ip hotspot user add name=bfszv5 password=bfszv5 profile=Harian-5M comment=voucher }
:if ([:len [/ip hotspot user find where name=3j7zeb]] = 0) do={ /ip hotspot user add name=3j7zeb password=3j7zeb profile=Harian-5M comment=voucher }
:if ([:len [/ip hotspot user find where name=rjzywk]] = 0) do={ /ip hotspot user add name=rjzywk password=rjzywk profile=Harian-5M comment=voucher }

Penjelasan per bagian:

  • Pola :if ([:len [... find ...]] = 0) do={ add } else={ set } dipakai di hampir semua baris. Artinya, kalau belum ada maka dibuat, kalau sudah ada maka diperbarui. Karena itu script aman ditempel ulang, misalnya saat kamu mengubah kecepatan paket. Hasilnya tidak dobel dan tidak error "already have".
  • Jaringan hotspot: IP 10.5.50.1/24 dipasang di ether2 dengan comment hotspot. Pool hs-pool berisi semua IP sisa (.2 sampai .254). DHCP server hs-dhcp memakai lease 1 jam supaya IP pelanggan yang sudah pergi cepat kembali ke pool. DHCP network memberi gateway dan DNS = IP router.
  • /ip dns set allow-remote-requests=yes wajib ada. HP pelanggan bertanya DNS ke router, dan nama login.wifi hanya dikenal oleh DNS router. Tanpa baris ini, halaman login tidak akan pernah muncul.
  • Profil server hsprof1: dns-name=login.wifi adalah alamat halaman login. login-by=http-chap,cookie artinya password tidak dikirim mentah (di-hash MD5 dengan tantangan acak dari router), dan perangkat yang pernah login bisa masuk lagi otomatis lewat cookie. html-directory=hotspot memakai halaman login bawaan MikroTik.
  • Server hotspot1 menyalakan hotspot di ether2 dengan pool dan profil di atas.
  • Paket = profil user hotspot. rate-limit=5M/5M membatasi kecepatan, shared-users=1 membuat satu voucher hanya bisa dipakai satu perangkat dalam waktu yang sama, dan session-timeout membatasi lama satu kali login.
  • Voucher: tiap kode dibuat sebagai user dengan username = password, jadi pelanggan cukup mengetik kodenya di dua kolom (atau di satu kolom kalau kamu memakai halaman login khusus). Comment voucher memudahkan penyaringan. Voucher yang namanya sudah ada dilewati, jadi voucher yang sudah terjual tidak tertimpa.

5. Hasil Uji di Router Lab

Kami menguji script di atas pada CHR RouterOS 7.25 yang baru dipasang. Router uji punya NAT ke internet di ether1. Ada dua "pelanggan" berupa mesin Linux yang disambungkan ke ether2 dan meminta IP lewat DHCP. Yang terbukti:

Uji Hasil
Script ditempel 2× berturut-turutTanpa error. Tetap 1 server, 1 pool, 3 paket, 5 voucher (tidak dobel)
Klien minta IP (DHCP)Dapat 10.5.50.254, gateway dan DNS 10.5.50.1
Sebelum login: ping 8.8.8.8Gagal (100% loss), sesuai harapan
Sebelum login: buka http://example.comDibelokkan (302) ke http://login.wifi/login?dst=..., judul halaman "Internet hotspot - Log in"
Login password salahDitolak. Log: login failed: invalid username or password
Login voucher benar (CHAP)Masuk. Muncul di Active dengan session-time-left 23h59m54s, lalu ping dan web jalan
Limit kecepatanQueue dinamis <hotspot-kode> terbentuk dengan max-limit 5M/5M
Voucher yang sama di perangkat keduaDitolak: no more sessions are allowed for user. Voucher lain di perangkat kedua bisa login.
Profil diubah manual, lalu script ditempel ulangrate-limit kembali ke 5M/5M, voucher tetap 5

Yang tidak bisa dibuktikan di lab: kecepatan nyata 5 Mbps. CHR berlisensi free dibatasi MikroTik sekitar 1 Mbit/s per interface, jadi unduhan di lab tertahan di sekitar 1 Mbps, baik dengan limit 5M maupun 100M. Yang bisa kami pastikan adalah queue-nya terpasang dengan angka yang benar. Di router fisik (hAP, RB, CCR) batasan lisensi ini tidak ada. Kami juga tidak menguji access point Wi-Fi sungguhan dan login dari HP Android/iPhone. Pelanggan di lab adalah mesin Linux yang login lewat form CHAP yang sama.

6. Cara Mengecek di Router Kamu

Setelah script ditempel, jalankan perintah berikut di Terminal MikroTik:

# server hotspot harus ada dan tidak invalid
/ip hotspot print

# daftar paket
/ip hotspot user profile print

# daftar voucher
/ip hotspot user print where comment=voucher

# siapa yang sedang login + sisa waktu sesi
/ip hotspot active print

# queue limit per user (muncul setelah ada yang login)
/queue simple print where dynamic

# kenapa login gagal? lihat log
/log print where message~"login"

Lalu sambungkan HP ke Wi-Fi hotspot dan buka situs http (bukan https), misalnya http://neverssl.com. Halaman login harus muncul. Kebanyakan HP Android dan iPhone akan memunculkan pop-up "Masuk ke jaringan" sendiri. Ketik kode voucher di kolom username dan password, dan internet harus langsung jalan.

Di Terminal, user itu muncul di /ip hotspot active print. Jangan kaget kalau session-timeout paket 7d dan 30d tampil sebagai 1w dan 4w2d. Itu hanya cara RouterOS menulis waktu, nilainya sama.

7. Session-timeout Bukan Masa Aktif

Ini bagian yang paling sering bikin rugi penjual voucher. session-timeout=1d artinya satu kali login paling lama 1 hari. Setelah itu sesi diputus, tapi vouchernya tidak hangus. Pelanggan bisa login lagi dengan kode yang sama dan mendapat 1 hari berikutnya. Begitu juga kalau pelanggan logout di tengah jalan, hitungannya mulai dari nol saat login berikutnya.

Catatan di generator sii.ai.id juga menyebut hal ini. Kalau kamu mau voucher "Harian" benar-benar mati 24 jam setelah pertama kali dipakai, ada dua pilihan:

  • Pasang alat Masa Aktif Voucher di sii.ai.id. Alat ini menambahkan script on-login yang mencatat waktu kedaluwarsa di comment user, plus penjadwal yang mematikan atau menghapus voucher yang sudah lewat masa aktifnya. Tutorialnya akan menyusul di blog ini.
  • Pakai aplikasi manajemen voucher (misalnya Mikhmon) yang mengurus masa aktif dari luar router.

8. Masalah Umum dan Solusinya

Halaman login tidak muncul.
Pastikan yang dibuka situs http. Situs https (Google, YouTube) tidak bisa dibelokkan tanpa peringatan sertifikat. Cek juga /ip dns print: allow-remote-requests harus yes dan DNS upstream harus terisi. Kalau HP tidak mendapat IP 10.5.50.x, berarti interfacenya salah atau port itu ada di dalam bridge.

Sudah login tapi tidak bisa internet.
Hampir selalu karena NAT belum ada. Cek /ip firewall nat print dan pastikan ada masquerade ke arah WAN. Kalau belum ada, buat dengan Setup Dasar.

Limit kecepatan tidak berlaku.
Cek apakah queue <hotspot-...> muncul di /queue simple print where dynamic. Kalau router memakai default configuration, ada aturan fasttrack di firewall filter. Koneksi yang di-fasttrack melewati queue, jadi limit bisa jebol. Matikan atau persempit aturan fasttrack itu. Pastikan juga tidak ada simple queue lain di atasnya yang menangkap IP pelanggan lebih dulu.

"no more sessions are allowed for user".
Voucher sedang dipakai di perangkat lain, karena shared-users=1. Kalau pelanggan baru ganti HP atau HP-nya mengacak MAC, hapus sesi lamanya di IP > Hotspot > Active, atau tunggu sampai sesi lama habis karena idle (bawaan server: 5 menit).

Pelanggan berbagi voucher lewat tethering HP.
shared-users hanya menghitung perangkat yang login ke hotspot. Laptop yang menumpang ke hotspot HP pelanggan tidak terdeteksi. Untuk itu pakai alat Anti Tethering Hotspot (trik TTL).

Halaman login polos dan berbahasa Inggris.
Itu halaman bawaan MikroTik. Buat halaman login bermerek dengan kolom voucher tunggal pakai Login Page Maker, lalu cetak vouchernya dengan Cetak Voucher.

Ada situs judi atau aplikasi yang ingin diblokir untuk pelanggan hotspot.
Baca tutorial Blokir Situs Judi & Aplikasi di MikroTik. Isi kolom jaringan klien dengan subnet hotspot (10.5.50.0/24).

9. Tanya Jawab

Bisa dipasang di router yang sudah punya hotspot?
Bisa, tapi hati-hati. Script memakai nama tetap hs-pool, hs-dhcp, hsprof1, dan hotspot1. Kalau nama itu sudah dipakai, setelannya akan diperbarui sesuai isi formulir. Kalau interfacenya sudah punya server hotspot lain dengan nama berbeda, server kedua akan bentrok. Paling aman dipasang di port yang masih kosong.

Bagaimana menambah voucher baru tanpa mengganggu yang lama?
Buat ulang di sii.ai.id, klik Acak ulang voucher, lalu tempel lagi. Voucher lama tetap ada, karena yang sudah ada dilewati. Khusus untuk menambah akun banyak sekaligus beserta CSV-nya, ada alat Akun Massal.

Kenapa username sama dengan password?
Supaya pelanggan cukup menghafal satu kode. Keamanannya datang dari kode yang acak dan login CHAP. Kalau mau lebih sulit ditebak, naikkan panjang kode ke 8.

Apakah bisa di RouterOS 6?
Generator ini ditujukan untuk RouterOS 7 dan hanya diuji di 7.25. Untuk v6 kami tidak menjamin.

Apakah perlu RADIUS atau aplikasi billing?
Tidak untuk mulai. Semua user disimpan di router. Kalau pelanggan sudah ratusan dan butuh laporan penjualan, barulah pertimbangkan aplikasi manajemen voucher atau billing.

Penutup

Dengan generator Hotspot + Voucher sii.ai.id, hotspot voucher MikroTik bisa siap dalam beberapa menit: isi formulir, tempel script, cek dengan HP. Ingat tiga hal: pastikan NAT sudah ada, pahami bahwa session-timeout bukan masa aktif, dan selalu backup dulu sebelum menempel script di router produksi.

Tutorial berikutnya akan membahas alat-alat pendamping hotspot: masa aktif voucher, cetak voucher, dan halaman login sendiri. Ada pertanyaan atau kasus di lapangan yang belum terjawab? Tulis di kolom komentar ya.

Referensi

Latest

Gunakan Fasilitas Comment dengan Bijak, no spam no junk no caci maki.
Terima kasih atas Kontribusi anda :)
EmoticonEmoticon