Cara membuat login page hotspot MikroTik sendiri: tema, voucher & member, pesan galat bahasa Indonesia, dan walled garden beli voucher, teruji RouterOS 7.
Halaman login bawaan hotspot MikroTik itu jujur saja kurang menjual. Tulisannya bahasa Inggris, tampilannya polos, dan kalau pelanggan salah ketik voucher, yang muncul cuma "invalid username or password". Banyak pemilik RT/RW net dan warung Wi-Fi akhirnya mencari template login hotspot di internet, lalu ketemu masalah baru: template berat karena memuat font dan gambar dari luar (padahal pengguna belum punya internet), tombolnya tidak jalan karena butuh md5.js yang lupa disalin, atau pesan galatnya masih bahasa Inggris.
Di tutorial ini kita membuat halaman login hotspot sendiri dengan Login Page Maker di sii.ai.id, alat gratis yang menghasilkan satu paket lengkap: login.html, status.html, alogin.html, logout.html, errors.txt berbahasa Indonesia, dan walled-garden.rsc supaya pelanggan bisa membuka toko voucher online sebelum login. Semua berkas di artikel ini adalah keluaran asli generator, lalu kami pasang di router uji dan kami coba login dari "HP pelanggan" sungguhan.
hotspot di Winbox, lalu jalankan walled-garden.rsc di Terminal. Hotspot-nya sendiri harus sudah jalan. Kalau belum, buat dulu lewat tutorial Hotspot + Voucher MikroTik RouterOS 7.
Daftar Isi
- Cara Kerja Login Page Hotspot MikroTik
- Yang Perlu Disiapkan
- Membuat Halaman di Generator
- Isi Paket: Penjelasan Tiap Berkas
- Script Walled Garden dan Penjelasannya
- Cara Memasang di Router
- Hasil Uji di Router Lab
- Masalah Umum dan Solusinya
- Tanya Jawab
- Referensi
1. Cara Kerja Login Page Hotspot MikroTik
Begitu HP pelanggan tersambung ke Wi-Fi hotspot dan membuka situs http://, router mencegat permintaan itu dan menampilkan halaman dari folder HTML hotspot (biasanya hotspot, lihat kolom HTML Directory di profil hotspot). Halaman itu bukan HTML biasa: router mengganti dulu variabel seperti $(link-login-only), $(chap-id), $(username) atau $(session-time-left) dengan nilai sebenarnya sebelum dikirim ke HP. Ada juga perintah kondisi seperti $(if trial == 'yes') untuk menampilkan bagian tertentu saja.
Artinya, desain boleh bebas selama empat hal dijaga: form dikirim ke alamat yang benar, password dikirim sesuai cara login profil (di sini HTTP CHAP), nama variabel tidak salah ketik, dan halaman tidak bergantung pada sumber dari internet. Poin terakhir sering dilupakan: pengguna yang belum login belum punya akses keluar, jadi font Google, CDN jQuery, atau gambar dari situs lain tidak akan termuat.
| Berkas | Kapan dipakai router |
|---|---|
| login.html | Pengguna belum login dan membuka situs apa saja (http) |
| alogin.html | Tepat sesudah login berhasil, lalu dialihkan ke situs tujuan |
| status.html | Pengguna yang sudah login membuka alamat /status |
| logout.html | Sesudah menekan tombol keluar |
| errors.txt | Teks pesan galat yang ditampilkan lewat $(error) |
2. Yang Perlu Disiapkan
- MikroTik RouterOS 7 dengan hotspot yang sudah berjalan (server, profil, pool, user). Halaman login hanya mengganti tampilan, tidak membuat hotspot.
- Winbox atau WebFig untuk mengunggah berkas ke menu Files.
- Logo (PNG/JPG) kalau mau. Tanpa logo, generator memakai huruf depan nama hotspot di dalam lingkaran.
- Kalau ingin tombol Coba gratis: profil hotspot harus mengaktifkan
login-bytrial. - Kalau punya toko voucher online (aplikasi billing atau panel voucher): alamat situsnya, untuk dimasukkan ke walled garden.
- Cadangan konfigurasi dan salinan folder
hotspotlama, jaga-jaga mau kembali ke tampilan semula.
3. Membuat Halaman di Generator
Buka sii.ai.id/#login. Di kiri ada isian bertab, di kanan pratinjau HP yang langsung berubah setiap kamu mengetik:
- Tema: pilih Kawung, Tiket, Pastel, atau Panel. Warna utama ikut berganti dan masih bisa diubah.
- Identitas: nama hotspot, slogan, logo (otomatis diperkecil ke 160 px dan disimpan sebagai
img/logo.png), dan teks berjalan untuk promo atau info gangguan. - Login: cara login (voucher saja, username + password, atau dua tab sekaligus), tombol Coba gratis, dan kotak wajib setuju syarat & ketentuan.
- Beli & Harga: daftar paket (satu per baris: nama, keterangan, harga), tautan toko voucher online, dan payment gateway yang dipakai toko itu.
- Kontak: WhatsApp, Telegram, dan nomor telepon admin. WA dan Telegram muncul sebagai tombol bulat di pojok.
- Walled Garden: aplikasi bayar yang boleh dibuka sebelum login (bawaan GoPay dan DANA) dan domain tambahan.
Untuk contoh di artikel ini kami memakai isian bawaan, ditambah tombol trial, syarat & ketentuan, WhatsApp 0812-3456-7890, dan Telegram @wifikita. Di bawah pratinjau ada pilihan Login / Status / Berhasil / Keluar dan centang contoh pesan galat, jadi semua halaman bisa dicek sebelum dipasang. Tombol Unduh ZIP mengemas semuanya.

4. Isi Paket: Penjelasan Tiap Berkas
login.html
Ini berkas utama (sekitar 12 KB untuk contoh kami). Bagian pentingnya:
- Dua form. Form
loginyang terlihat diisi pengguna, lalu form tersembunyisendinmengirim data ke$(link-login-only). Di tab Voucher, isi kotak kode dipakai sebagai username sekaligus password, sesuai voucher yang dibuat generator hotspot. Spasi di depan dan belakang kode dibuang dulu, jadi voucher yang ditempel dari WhatsApp tetap diterima (kami coba dengan" uji7k2m "dan berhasil). - CHAP tanpa md5.js. Fungsi
hexMD5ditanam langsung di halaman, lalu password dikirim sebagaihexMD5(chapId + password + chapChallenge). Password asli tidak lewat jaringan, dan kamu tidak perlu menyalinmd5.js. - Kondisi router. Kotak pesan galat dibungkus
$(if error), dan tautan Coba gratis dibungkus$(if trial == 'yes'). Kalau profil tidak mengizinkan trial, tautan itu tidak muncul sendiri. - Tab terakhir diingat. Pilihan Voucher atau Member disimpan di
localStorageHP, jadi pelanggan member tidak perlu pindah tab tiap kali login. - Ringan. Tidak ada font atau skrip dari luar. Huruf memakai bawaan HP dan motif tema digambar dengan CSS.
alogin.html, status.html, logout.html
alogin.html menampilkan "Berhasil" lalu pindah ke situs tujuan ($(link-redirect)) dua detik kemudian. status.html menampilkan nama, alamat IP, lama terhubung, data terpakai, dan sisa waktu atau kuota kalau user punya batas (memakai $(session-time-left) dan $(remain-bytes-total-nice)). Halaman ini memuat ulang sendiri sesuai $(refresh-timeout-secs). logout.html mengucapkan terima kasih beserta ringkasan pemakaian dan tombol untuk login lagi.
errors.txt
Router membaca berkas ini untuk mengisi $(error). Generator menulis semua pesan dalam bahasa Indonesia. Pesan yang paling sering terlihat pelanggan adalah invalid-username, uptime-limit (masa aktif habis), dan user-session-limit (voucher dipakai di HP lain). Isinya persis seperti ini:
# errors.txt bahasa Indonesia - dibuat dengan sii.ai.id # Variabel: $(error-orig) pesan asli, $(ip) IP pengguna, $(username) nama pengguna internal-error = galat internal ($(error-orig)) config-error = konfigurasi hotspot salah ($(error-orig)) not-logged-in = kamu belum masuk (ip $(ip)) ippool-empty = alamat IP habis, coba lagi beberapa menit lagi shutting-down = layanan hotspot sedang dimatikan user-session-limit = voucher $(username) sedang dipakai di perangkat lain license-session-limit = jumlah pengguna sudah penuh, coba lagi nanti wrong-mac-username = username $(username) tidak cocok dengan perangkat ini chap-missing = browser tidak mengirim jawaban login, muat ulang halaman lalu coba lagi invalid-username = kode voucher atau password salah otp-already-used = kode OTP sudah terpakai, tunggu 30 detik lalu coba lagi invalid-mac = voucher $(username) terkunci ke perangkat lain uptime-limit = masa aktif voucher $(username) sudah habis, silakan beli voucher baru traffic-limit = kuota voucher $(username) sudah habis, silakan beli voucher baru radius-timeout = server sedang sibuk, coba lagi sebentar auth-in-progress = sedang memproses login, tunggu sebentar radius-reply = $(error-orig)
Mau mengganti kata-kata? Edit bagian kanan tanda = saja. Nama kunci di kiri harus tetap sama, karena router mencari pesan berdasarkan nama itu.
5. Script Walled Garden dan Penjelasannya
Walled garden adalah daftar tujuan yang boleh dibuka sebelum login. Tanpa walled garden, tombol "Beli Voucher Online" tidak berguna, karena pelanggan yang belum punya voucher memang belum bisa ke mana-mana. Ini script keluaran generator untuk isian bawaan (toko contoh voucher.contoh.id serta aplikasi GoPay dan DANA):
# ==========================================
# Walled garden: beli voucher sebelum login
# dibuat oleh sii.ai.id — RouterOS v7
# Backup dulu: /system backup save name=sebelum-script
# ==========================================
# Membuka toko voucher, halaman bayar & aplikasi bayar untuk pengguna hotspot
# yang BELUM login. Situs lain tetap terblokir. Wajib RouterOS 7.
# Aman dijalankan ulang. Mencabut: jalankan 4 baris "remove" di bawah saja.
# --- Bersihkan pasangan lama ---
/ip dns static remove [find comment="sii-voucher"]
/ip firewall mangle remove [find comment="sii-voucher"]
/ip hotspot walled-garden ip remove [find comment="sii-voucher"]
/ip firewall address-list remove [find comment="sii-voucher"]
# --- 1) Router mencatat IP domain (+ semua subdomainnya) ke address-list sii-voucher ---
{
:local hulu [/ip dns get servers]
:if ([:len $hulu] = 0) do={ :set hulu [/ip dns get dynamic-servers] }
:if ([:len $hulu] = 0) do={ :error "DNS router kosong: isi dulu IP > DNS > Servers" }
:local dns [:pick $hulu 0]
:foreach d in={"voucher.contoh.id";"gojekapi.com";"gopayapi.com";"gopay.co.id";"gojek.com";"gojek.link";"dana.id";"alipay.com";"alipayobjects.com";"marmot-cloud.com";"turingfraud.net"} do={
/ip dns static add name=$d type=FWD match-subdomain=yes forward-to=$dns address-list=sii-voucher comment="sii-voucher"
}
}
/ip dns cache flush
# --- 2) IP yang sedang dipakai disimpan 1 jam (TTL DNS sebagian server cuma beberapa detik;
# tanpa ini pembayaran bisa terputus di tengah jalan) ---
/ip firewall mangle add chain=prerouting dst-address-list=sii-voucher action=add-dst-to-address-list address-list=sii-voucher-awet address-list-timeout=1h comment="sii-voucher"
/ip firewall mangle add chain=prerouting dst-address-list=sii-voucher-awet action=add-dst-to-address-list address-list=sii-voucher-awet address-list-timeout=1h comment="sii-voucher"
# --- 3) Hotspot mengizinkan kedua daftar sebelum login ---
/ip hotspot walled-garden ip add action=accept dst-address-list=sii-voucher comment="sii-voucher"
/ip hotspot walled-garden ip add action=accept dst-address-list=sii-voucher-awet comment="sii-voucher"
:log info "sii-voucher: walled garden 11 domain/IP terpasang"
Bagian bersihkan pasangan lama
Empat baris remove [find comment="sii-voucher"] menghapus semua entri buatan script sebelumnya. Karena itu script aman ditempel ulang sesudah kamu menambah domain, dan empat baris ini juga cara mencabutnya.
Bagian 1: DNS static tipe FWD
Walled garden berbasis nama domain sering bolong untuk HTTPS dan aplikasi, karena router tidak melihat nama situs di dalam koneksi terenkripsi. Script ini memakai cara lain. Untuk tiap domain dibuat entri DNS type=FWD dengan match-subdomain=yes dan address-list=sii-voucher. Saat HP menanyakan dana.id atau www.gojek.com ke router, router meneruskan pertanyaan itu ke DNS hulu dan mencatat IP jawabannya ke address-list. Fitur address-list pada DNS static ini hanya ada di RouterOS 7, jadi script tidak bisa dipakai di v6. Blok { ... } di atasnya mengambil DNS hulu dari /ip dns (atau DNS dinamis dari ISP) dan berhenti dengan pesan jelas kalau keduanya kosong.
Bagian 2: address-list awet 1 jam
Server pembayaran sering memberi TTL DNS hanya beberapa detik, sehingga IP-nya cepat hilang dari daftar padahal proses bayar belum selesai. Dua aturan mangle menyalin IP yang sedang dipakai ke daftar sii-voucher-awet dengan batas waktu 1 jam, dan batas itu diperpanjang selama koneksinya masih dipakai.
Bagian 3: walled garden IP
Dua baris terakhir mengizinkan kedua address-list itu di /ip hotspot walled-garden ip, jadi lalu lintas ke IP tersebut tidak dicegat hotspot.
6. Cara Memasang di Router
- Buka Winbox, masuk ke IP > Hotspot > Server Profiles, lalu lihat kolom HTML Directory di profil yang dipakai (biasanya
hotspot). - Buka Files dan unduh dulu folder lama itu ke komputer sebagai cadangan.
- Ekstrak ZIP dari generator, lalu seret semua isinya (termasuk folder
imgkalau ada logo) ke folder tadi. Timpa berkas lama. - Kalau memakai tombol trial, aktifkan di profil:
/ip hotspot profile set [find name=hsprof1] login-by=http-chap,trial(gantihsprof1dengan nama profil kamu). - Buka New Terminal lalu tempel isi
walled-garden.rsc. Terminal tidak perlu ditutup dulu, cukup tempel sekali. - Di HP, putus lalu sambung ulang ke Wi-Fi, kemudian buka situs
http://apa saja. Halaman baru langsung tampil. Tidak perlu reboot router.
7. Hasil Uji di Router Lab
Kami memakai MikroTik CHR RouterOS 7.25 yang masih bersih. Hotspot dipasang di ether2 (10.55.0.1/24) dengan profil login-by=http-chap,trial, satu voucher uji7k2m, dan satu member budi dengan limit-uptime=2h. Berkas diunggah ke folder hotspot lewat /tool fetch. "HP pelanggan" adalah Chromium di namespace jaringan terpisah dengan IP 10.55.0.50 dan layar 390 px, lalu diuji otomatis dengan Playwright.
| Uji | Hasil |
|---|---|
| Buka http://example.com sebelum login | ✅ Dialihkan ke halaman login kustom "WiFi Kita - Login", semua variabel $( ) terisi |
| Tekan Masuk tanpa centang syarat | ✅ Ditahan dengan peringatan, tidak dikirim ke router |
| Voucher salah (salah999) | ✅ Muncul "kode voucher atau password salah" dari errors.txt |
| Voucher benar (dengan spasi di depan dan belakang) | ✅ Halaman "Berhasil", lalu pindah ke example.com. Di router tercatat aktif dengan login-by http-chap |
| Buka /status | ✅ Nama, IP 10.55.0.50, dan lama terhubung tampil |
| Tombol keluar | ✅ Halaman "Terima kasih, uji7k2m", dan sesi hilang dari daftar aktif |
| Tab Member (budi) | ✅ Login berhasil, status menampilkan "Sisa waktu" dari limit-uptime 2h |
| Buka halaman login lagi | ✅ Tab Member yang terakhir dipakai langsung terbuka |
| Coba gratis | ✅ Sesi aktif dengan login-by trial |
| Galat JavaScript | ✅ Tidak ada |
| walled-garden.rsc dijalankan 2× | ✅ Tanpa galat. Tetap 11 DNS static, 2 mangle, 2 walled garden (tidak dobel) |
| Sebelum login: https://dana.id dan https://www.gojek.com | ✅ Tersambung ke server aslinya (HTTP 301/307). IP masuk ke sii-voucher dengan komentar "created for dana.id.", dan daftar awet ber-timeout 1 jam |
| Sebelum login: situs lain | ✅ https://www.google.com tidak tersambung, dan http://id.wikipedia.org dialihkan ke halaman login |


Yang belum terbukti di lab, supaya jujur: uji ini tidak memakai logo, jadi yang tampil adalah huruf "W". Pemuatan img/logo.png tidak kami uji kali ini. Toko voucher voucher.contoh.id juga hanya contoh dan tidak ada situsnya. Kami tidak mencoba bayar dengan aplikasi GoPay atau DANA di HP sungguhan. Aplikasi bisa saja memanggil server lain yang tidak ada di daftar, sehingga generator sendiri menyebut walled garden aplikasi "tidak dijamin 100%". Cobalah sekali dengan HP tanpa kuota sebelum mengumumkannya ke pelanggan.
Untuk memeriksa di router kamu sendiri:
/ip dns static print count-only where comment="sii-voucher" /ip firewall address-list print where list~"sii-voucher" /ip hotspot walled-garden ip print where comment="sii-voucher" /ip hotspot active print
Baris pertama harus sama dengan jumlah domain di log (sii-voucher: walled garden 11 domain/IP terpasang). Address-list baru terisi sesudah ada HP yang membuka domain tersebut, jadi kosong sesaat setelah script ditempel itu normal.
8. Masalah Umum dan Solusinya
Halaman masih tampilan lama
Berkas mungkin diunggah ke folder yang salah. Cocokkan dengan HTML Directory di profil hotspot. Router dengan penyimpanan flash kadang memakai flash/hotspot. Kalau foldernya sudah benar, tutup lalu buka lagi tab browser di HP, karena browser bisa menampilkan salinan lama.
Halaman login tidak muncul saat membuka situs https
Ini perilaku normal semua captive portal. Router tidak bisa mencegat HTTPS tanpa memicu peringatan sertifikat. Android dan iPhone biasanya membuka halaman login sendiri saat Wi-Fi tersambung. Kalau tidak muncul, ajari pelanggan membuka alamat http:// atau DNS name hotspot kamu.
Voucher benar tapi tetap "kode voucher atau password salah"
Cek cara login di generator. Mode Kode voucher saja mengirim kode sebagai username sekaligus password, jadi user di router juga harus punya password yang sama dengan namanya. Untuk akun dengan password berbeda, pakai tab Member. Pastikan juga profil hotspot mengaktifkan http-chap.
Tombol "Coba gratis" tidak muncul
Tombol itu hanya tampil kalau profil mengizinkan trial (login-by berisi trial). Ini disengaja supaya pelanggan tidak menekan tombol yang pasti gagal.
Script walled garden berhenti: "DNS router kosong"
Router belum punya DNS hulu. Isi dulu IP > DNS > Servers (misalnya DNS ISP atau 8.8.8.8), lalu tempel ulang script. Pastikan juga allow-remote-requests=yes aktif, karena HP pelanggan bertanya DNS ke router.
Toko voucher terbuka tapi pembayaran macet
Halaman bayar sering memuat sumber dari domain lain, misalnya CDN payment gateway. Pilih payment gateway yang dipakai toko di tab Beli & Harga, lalu tambahkan domain yang masih kurang di Domain lain. Untuk mencari domain yang kurang, lihat IP > DNS > Cache saat mencoba bayar dari HP yang belum login.
9. Tanya Jawab
Bagaimana cara mengganti tampilan login hotspot MikroTik?
Ganti berkas login.html (dan kawan-kawannya) di folder HTML Directory profil hotspot lewat Winbox > Files. Login Page Maker membuatkan semua berkas itu sekaligus dalam satu ZIP.
Apakah template login hotspot ini butuh md5.js?
Tidak. Fungsi MD5 untuk CHAP sudah ditanam di dalam login.html. Kalau folder lama masih berisi md5.js, biarkan saja, tidak mengganggu.
Apakah bisa dipakai di RouterOS 6?
Halaman HTML-nya memakai variabel hotspot standar, tetapi kami hanya mengujinya di RouterOS 7.25. Script walled garden jelas wajib RouterOS 7 karena memakai DNS static FWD dengan address-list.
Apakah bisa dipakai kalau user hotspot dicek lewat RADIUS?
Halaman login hanya mengurus tampilan dan pengiriman username/password. Siapa yang memeriksa akun (user lokal atau RADIUS) tetap diatur di profil hotspot. Pesan balasan RADIUS disiapkan di errors.txt lewat radius-reply = $(error-orig). Di lab kami hanya menguji user lokal, jadi cobalah dulu dengan satu akun RADIUS sebelum dipakai semua pelanggan.
Kenapa tidak memakai font Google supaya lebih cantik?
Karena pengguna yang belum login belum punya internet. Font dari luar tidak akan termuat dan halaman bisa terasa lambat menunggu waktu habis. Huruf bawaan HP justru langsung tampil.
Bagaimana cara mengembalikan halaman login bawaan?
Unggah lagi folder cadangan yang kamu simpan sebelum mengganti. Untuk walled garden, jalankan empat baris remove di bagian atas script.
Penutup
Halaman login adalah hal pertama yang dilihat pelanggan setiap hari. Dengan Login Page Maker kamu mendapat halaman berbahasa Indonesia yang ringan, punya daftar harga dan tombol kontak, bisa dipakai dengan voucher maupun member, dan bisa mengarahkan pelanggan ke toko voucher online sebelum login. Langkah lanjutnya: atur paket dan masa aktif voucher di Hotspot + Voucher MikroTik, bagi bandwidth dengan Limit Bandwidth PCQ, dan kalau pelanggan bulanan mulai banyak, pertimbangkan PPPoE Server untuk RT/RW Net.
Referensi
- MikroTik Documentation, Hotspot customisation (daftar berkas dan variabel halaman hotspot).
- MikroTik Documentation, HotSpot - Captive portal (profil, login-by, walled garden).
- MikroTik Documentation, DNS (DNS static type FWD dan address-list).
- Generator: sii.ai.id/#login. Hasil uji: CHR RouterOS 7.25, 22 November 2026.
Comments
Post a Comment