Menginstall AdGuard di STB Android ZTE B860H (Armbian)

Cara install AdGuard Home untuk DNS Resolver Lokal di STB Android ZTE B860H (Armbian 25/Debian Trixie)

Beberapa tahun lalu, saya sempat menginstall Armbian di STB Android ZTE B860H. Setelah lama tidak saya gunakan, akhirnya saya memutuskan untuk “menghidupkannya” lagi dengan menginstall ulang STB tersebut menggunakan Armbian 25.11 yang basisnya adalah Debian 13 (Trixie). STB tersebut akan saya gunakan sebagai secondary DNS resolver untuk jaringan lokal saya.

Nah, di artikel ini saya ingin berbagi pengalaman saya dalam menginstall AdGuard Home di Armbian 25.11 (versi minimal yang DNS resolver-nya menggunakan systemd-resolve).

Prasyarat & Topologi

Sebelum memulai dan supaya lebih jelas, saya informasikan dulu bahwa di artikel ini saya menggunakan jaringan 192.168.2.0/24. Sedangkan alamat IP STB Armbian dimana AdGuard secondary DNS resolver akan diinstall adalah 192.168.2.253.

Supaya teman-teman mempunyai gambaran prosesnya, saya juga akan menyertakan video saat saya melakukan installasi dan konfigurasi AdGuard, namun saat ini video tersebut belum siap untuk diupload. jadi artikel ini akan saya update begitu video tersebut sudah saya upload ke YouTube. jadi mohon bersabar. xD

Catatan: Sebenarnya, Armbian sudah menyediakan armbian-config yang bisa digunakan untuk menginstall software-software atau service seperti AdGuard, NFS, dan lain-lain. Tapi disini saya sengaja memilih melakukan installasi secara manual saja supaya kita tidak “terkunci” di environment tertentu.

Install AdGuard di Armbian

AdGuard menyediakan install script yang secara otomatis dapat mendownload dan mengkonfigurasi AdGuard Home sehingga dia dapat otomatis berjalan setelah reboot. Teman-teman bisa menjalankan perintah berikut :

1curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

Catatan: Saya sarankan membaca dan memahami terlebih dulu isi dari install script-nya sebelum mengeksekusi perintah diatas.

Setelah menjalankan install script, AdGuard Home akan terinstall di direktori /opt/AdGuardHome, dan secara default, web admin interface-nya menggunakan port 3000. Teman-teman dapat mengakses web admin interface-tersebut melalui http://[ip-armbian]:3000 (ubah [ip-armbian] ke alamat IP Armbian milik teman-teman).

Memperbaiki Error bind: address already in use

Secara default, port 53 (baik TCP maupun UDP) pada Armbian digunakan oleh systemd-resolve; jadi teman-teman perlu me-nonaktifkan DNSStubListener sehingga port 53 dapat digunakan oleh AdGuard DNS.

Untuk melakukannya, buat direktori /etc/systemd/resolved.conf.d dengan perintah berikut:

1sudo mkdir -p /etc/systemd/resolved.conf.d

Setelah itu, buat file /etc/systemd/resolved.conf.d/adguardhome.conf yang berisi konfigurasi berikut:

1[Resolve]
2DNS=127.0.0.1
3DNSStubListener=no

Setelah itu jalankan perintah berikut:

1sudo mv /etc/resolv.conf /etc/resolv.conf.backup
2sudo ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf
3sudo systemctl reload-or-restart systemd-resolved

Perintah diatas akan membuat file backup dari /etc/resolv.conf, membuat symlink /run/systemd/resolve/resolv.conf ke /etc/resolv.conf, kemudian merestart systemd-resolved service.

Dokumentasi lebih lengkap dapat dilihat di halaman FAQ AdGuard.

Konfigurasi Awal AdGuard Home Dari Admin Web UI

Buka http://[ip-armbian]:3000 menggunakan web browser, disana teman-teman akan diarahkan untuk mengkonfigurasi AdGuard. Pada bagian “Admin Web Interface”, pilih “Listen interface” ke “All interfaces” dan ubah “Port” dari 80 ke 3000.

Pada bagian **“DNS Server” **, ubah “Listen Interface” ke “All Interfaces” supaya mesin lain yang berada pada satu jaringan dengan STB Armbian dapat menggunakan DNS server tersebut.

Setelah itu, tekan tombol “Next” dan buat user dan password untuk admin web UI. Ikuti langkah-langkah selanjutnya dan seharusnya teman-teman sudah bisa melakukan login ke AdGuard Home dashboard menggunakan username dan password yang baru saja dibuat dan melakukan konfigurasi lanjutan.