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.