Mengelola jaringan lokal dengan banyak layanan self-hosted seringkali membuat pusing, apalagi jika Anda harus mendaftarkan setiap subdomain satu per satu. Bayangkan jika Anda punya belasan container Docker; memasukkan entri manual ke Pi-hole tentu bukan cara yang efisien.
Masalah utama bagi pengguna Pi-hole adalah fitur Local DNS Records bawaan hanya mendukung pemetaan one-to-one. Artinya, satu nama domain hanya untuk satu IP. Jika Anda ingin semua subdomain (misalnya jellyfin.home.noorkhafidzin.com, nextcloud.home.noorkhafidzin.com) mengarah ke satu reverse proxy yang sama, Pi-hole tidak menyediakan tombol “Wildcard” di menu standar.
Namun, ada solusi cerdas yang tersembunyi di balik pengaturan tingkat lanjut. Tutorial ini akan membimbing Anda menerapkan wildcard domain custom DNS setting di Pi-hole menggunakan fitur dnsmasq agar manajemen domain lokal Anda jauh lebih simpel dan otomatis.
Persiapan dan Prasyarat #
Sebelum masuk ke langkah teknis, pastikan Anda telah menyiapkan hal-hal berikut:
- Akses Admin Pi-hole: Anda harus bisa login ke Dashboard Pi-hole versi terbaru.
- IP Static Server: Alamat IP tujuan (misalnya IP Reverse Proxy atau Server Nginx) harus sudah statis.
- Akses Expert Mode: Memahami bahwa kita akan mengubah setelan sistem yang bersifat krusial.
Langkah Demi Langkah Setting Wildcard DNS #
Ikuti tahapan berikut untuk mengaktifkan fitur wildcard secara permanen tanpa perlu menyentuh terminal (CLI).
1. Mengaktifkan Expert Setting di Pi-hole #
Secara default, Pi-hole menyembunyikan pengaturan sensitif untuk mencegah kesalahan konfigurasi oleh pengguna awam.
- Buka Dashboard Pi-hole Anda.
- Masuk ke menu Settings di sidebar kiri.
- Klik pada tab System.
- Cari tombol atau opsi bertuliskan Enable Expert Settings (biasanya di bagian bawah atau pojok kanan atas). Klik hingga mode ahli aktif.
2. Mengonfigurasi Baris Dnsmasq Custom #
Setelah mode ekspert aktif, Anda akan melihat tab atau menu tambahan yang sebelumnya tersembunyi.
- Navigasi ke menu All Settings > Miscellaneous.
- Scroll ke bawah hingga Anda menemukan kolom input bernama
misc.dnsmasq_lines. - Di sinilah kita akan memasukkan logika wildcard.
3. Memasukkan Sintaks Wildcard Domain #
Masukkan perintah konfigurasi sesuai dengan format dnsmasq. Gunakan blok kode di bawah ini sebagai referensi:
address=/jellyfin.noorkhafidzin.com/10.1.1.22Simbol / di awal dan di akhir nama domain memberi tahu sistem bahwa ini adalah pencocokan substring. Dengan menuliskan address=/jellyfin.noorkhafidzin.com/10.1.1.22, Pi-hole akan mengarahkan apapun.home.noorkhafidzin.com ke IP 10.1.1.22. Ini jauh lebih efektif daripada menulis entri satu per satu di menu Local DNS konvensional.
4. Simpan dan Terapkan Perubahan #
Langkah terakhir yang sering terlewat adalah melakukan commit pada perubahan.
- Klik tombol Save atau Apply.
- Pi-hole akan secara otomatis melakukan restart pada servis DNS (FTL) untuk memuat konfigurasi baru tersebut.
Cara Mengamankan Homelab Menggunakan Traefik Reverse Proxy untuk Docker
Penjelasan Teknis Tambahan #
Mengapa Masalah Entri Manual Terjadi? #
Pi-hole pada dasarnya adalah wrapper untuk FashTL (FTL) yang berbasis pada dnsmasq. Antarmuka grafis (GUI) Pi-hole dirancang untuk kesederhanaan, sehingga fitur seperti wildcard sengaja tidak dimunculkan di menu utama guna menghindari kebingungan bagi pengguna rumahan standar.
Tanpa konfigurasi dnsmasq_lines, Pi-hole hanya membaca file /etc/hosts yang secara teknis tidak mendukung karakter wildcard. Inilah sebabnya mengapa Anda dipaksa mengisi domain satu per satu jika hanya mengandalkan menu Local DNS Records.
Implikasi Keamanan dan Jaringan #
Menggunakan wildcard memiliki keuntungan besar dalam arsitektur Reverse Proxy. Dengan mengarahkan semua subdomain ke satu IP (misalnya IP Nginx Proxy Manager), Anda cukup mengelola sertifikat SSL dan routing di satu pintu saja.
Namun, perlu diingat bahwa setting ini akan berlaku untuk semua subdomain. Pastikan Anda tidak memiliki bentrokan nama domain dengan layanan publik yang asli. Jika Anda mengatur address=/google.com/10.1.1.22, maka seluruh layanan Google tidak akan bisa diakses dari jaringan Anda karena dibelokkan ke IP lokal tersebut.
Kesimpulan #
Menerapkan wildcard domain custom DNS setting di Pi-hole adalah cara paling efisien bagi admin jaringan lokal untuk menghemat waktu. Dengan memanfaatkan fitur expert dan misc.dnsmasq_lines, Anda tidak lagi perlu mendaftarkan subdomain secara manual setiap kali menambah layanan baru di server.
Troubleshooting Singkat #
- Domain tidak terdeteksi? Pastikan Anda tidak memiliki entri yang bertabrakan di menu Local DNS Records biasa, karena entri spesifik terkadang mengambil prioritas.
- DNS tidak jalan? Periksa kembali penulisan garis miring
/pada sintaks. Kesalahan satu karakter saja bisa membuat servis FTL gagal start.
Apakah Anda berhasil mencoba trik ini atau justru menemukan kendala saat menyimpan pengaturan? Tuliskan pengalaman atau pertanyaan Anda di kolom komentar di bawah!
