Dokumentasi · Quickstart

Memasang appliance di jaringan Anda

Empat langkah: pasang ISO, arahkan resolver, buat sesi BGP, lalu verifikasi. Kerjakan berurutan supaya tiap lapis bisa diperiksa sendiri.

Sebelum mulai

Dokumen ini mengasumsikan akun portal Anda sudah aktif, license key sudah diterima, dan Anda punya akses ke border router. Aktivasi portal memerlukan akun Telegram aktif serta keanggotaan di grup support resmi.

Aktivasi Telegram

Masukkan username Telegram saat mendaftar, lalu ikuti undangan dari tim dnsbaru.id untuk bergabung ke grup support resmi. Keanggotaan grup diperlukan untuk verifikasi dan aktivasi akun portal. Anggota grup dapat melihat nama tampilan, username, dan pesan yang Anda kirim. Jangan kirim kata sandi atau kode OTP. Undangan grup diberikan oleh tim melalui kanal resmi; tautan undangan belum dicantumkan di halaman ini.

Yang perlu disiapkan
Kebutuhan Keterangan
License key Diterbitkan setelah akun portal aktif. Satu kunci untuk beta, trial, dan produksi.
Alamat IP appliance Satu alamat di jaringan Anda, disiapkan sendiri sebelum instalasi.
Akses border router Untuk membuat sesi BGP dan aturan blackhole.
Jendela waktu Perubahan BGP sebaiknya di luar jam sibuk.

Urutan

Selesaikan resolusi DNS sebelum mengaktifkan blackhole. Kalau keduanya diaktifkan bersamaan, Anda kehilangan kemampuan memeriksa satu lapis pada satu waktu.

1. Pasang ISO

Boot ISO pada VM atau bare metal di dalam jaringan ISP. Appliance menjalankan DNS resolver dan daemon BGP di mesin yang sama. Spesifikasi minimum per tier beban masih menyesuaikan hasil uji; hubungi CS untuk ukuran yang sesuai trafik Anda.

verifikasi unduhan
sha256sum dnsbaru-appliance.iso

Cocokkan hasilnya dengan checksum yang dikirim bersama tautan unduhan. Jangan lanjut kalau berbeda.

2. Arahkan resolver ke appliance

Resolver ISP mengirim query ke alamat IP appliance. Pada tahap ini, jangan ubah apa pun di border router.

resolv.conf pada resolver ISP
# ganti dengan IP appliance Anda
nameserver 192.0.2.10

Perhatian

192.0.2.10 adalah alamat contoh. Blok 192.0.2.0/24 dicadangkan untuk dokumentasi dan tidak akan pernah menjadi appliance Anda. Pakai alamat yang Anda siapkan sendiri.

uji resolusi dari resolver
dig @192.0.2.10 example.com +short

Kalau perintah ini menjawab, lapis DNS sudah berjalan. Belum ada yang diblokir pada tahap ini selain domain yang memang ada di daftar.

3. BGP peering dan community 666

Dengan border router Anda, buat sesi BGP ke IP appliance. Appliance mengiklankan alamat IP yang masuk daftar blokir dengan penanda community 666. Border router yang memutuskan apa arti penanda itu.

Tiga aturan yang perlu ada di border router
Aturan Isi
Peer Sesi BGP ke IP appliance, sampai status Established.
Community Rute dari appliance ditandai 666.
Aksi Rute bertanda 666 diarahkan ke blackhole: null0 atau 192.0.2.1.

Catatan

Sintaks berbeda antar vendor dan versi. Panduan langkah demi langkah untuk MikroTik, termasuk Winbox dan CLI, sedang disiapkan bersama parameter AS dan peer default. Sampai itu terbit, ikuti tiga aturan di atas dan hubungi CS kalau ada nilai yang belum jelas.

4. Verifikasi

Periksa keempat hal ini setelah peering. Kalau salah satu belum benar, jangan lanjut ke penyaringan produksi.

Yang diperiksa dan nilai yang benar
Yang diperiksa Nilai yang benar
Sesi BGP Established, tidak flapping.
Rute community 666 Masuk tabel routing sebagai blackhole.
Domain dalam daftar Tidak resolve ke alamat aslinya.
Pembaruan terakhir Hari ini.

Membaca dashboard

Dashboard appliance menampilkan dua seri terpisah, plus waktu pembaruan terakhir. Dokumentasi ini tidak menampilkan angka contoh, karena angka hanya berarti kalau berasal dari appliance Anda sendiri.

Processed

—qps

Trafik yang dilayani

Blocked

—qps

Trafik yang diarahkan ke halaman blokir

Pembaruan terakhir

—

Waktu daftar terakhir dimuat

Tiga keadaan yang mungkin terlihat

  • Berjalan. Pembaruan terakhir hari ini.
  • Pembaruan dijeda. Daftar terakhir tetap dipakai, DNS tetap melayani.
  • Tidak ada daftar. Belum pernah berhasil mengambil daftar, atau kunci ditolak.

Kalau ada masalah

401

Kunci ditolak. Periksa apakah license key tersalin lengkap. Status penagihan yang ditangguhkan juga menghasilkan 401. DNS tetap berjalan; yang berhenti hanya pembaruan daftar.

Sebagian

Domain terblokir tetapi alamat IP masih tembus. Itu berarti lapis DNS sudah berjalan dan lapis BGP belum. Periksa sesi BGP dan aturan community 666 di border router.

Sertakan license key, jenis router, dan tangkapan layar status BGP saat menghubungi CS. Semua itu memotong satu putaran tanya jawab.