Cara Deploy Container AdGuard Home di Mikrotik RouterOS

Menjalankan AdGuard Home langsung di dalam router MikroTik adalah solusi efisien untuk memblokir iklan di seluruh jaringan LAN tanpa perlu server tambahan. Sejak rilis RouterOS v7, MikroTik mendukung fitur Container (berbasis Docker), yang memungkinkan kita menginstal aplikasi ringan langsung di router.

Persiapan Awal (Prerequisites)

Sebelum memulai, pastikan perangkat mikrotik Anda memenuhi syarat berikut untuk menjalankan docker container :

1. RouterOS v7: Fitur container hanya tersedia di versi 7 ke atas.
2. Arsitektur CPU: Pastikan router menggunakan arsitektur ARM, ARM64, atau x86 (seperti hAP ax2, hAP ax3, RB5009, atau CCR2004).
3. Eksternal Storage (USB/SSD): Sangat disarankan menggunakan USB flash drive atau SSD eksternal. Container membutuhkan ruang tulis yang intensif; menjalankannya di internal storage (NAND/EMMC) router dapat memperpendek umur internal storage.
4. Paket Container: Pastikan paket container sudah terinstal di menu System > Packages.

Langkah 1: Mengaktifkan Mode Container

Secara default, fitur container dalam status disable. Anda perlu mengaktifkannya melalui terminal.

1. Buka New Terminal di WinBox.
2. Jalankan perintah berikut:

/system/device-mode/update container=yes

3. Router akan meminta konfirmasi fisik. Anda harus menekan tombol Reset atau Mode pada fisik router dalam waktu maksimal 5 menit, atau melakukan cold reboot (cabut power, lalu pasang lagi).
4. Setelah reboot, pastikan statusnya aktif dengan mengecek kembali:

/system/device-mode/print

Langkah 2: Jaringan Container (VETH & Bridge)

Agar container dapat terhubung dengan jaringan, kita perlu membuat virtual interface (VETH) dan bridge khusus. Ini mengisolasi jaringan container agar lebih mudah dikelola.

Membuat Interface VETH

VETH adalah “kabel LAN virtual” untuk container Anda.

/interface/veth/add name=veth-adguard address=172.17.0.2/24 gateway=172.17.0.1

• 172.17.0.2: IP Address untuk AdGuard Home.
• 172.17.0.1: IP Gateway (IP Router di network container).

Membuat Bridge Khusus Container

Kita buat bridge terpisah yang di alokasikan untuk container.

/interface/bridge/add name=bridge2-dockers
/interface/bridge/port/add bridge=bridge2-dockers interface=veth-adguard
/ip/address/add address=172.17.0.1/24 interface=bridge2-dockers

Konfigurasi NAT (Masquerade)

Agar container dapat koneksi internet , buat rules NAT.

/ip/firewall/nat/add chain=srcnat action=masquerade src-address=172.17.0.0/24

Langkah 3: Konfigurasi Storage (Mounts)

Agar data AdGuard (seperti log dan konfigurasi) tidak hilang saat router restart, kita perlu melakukan mounting folder dari USB drive ke dalam container.

Asumsi: USB drive Anda bernama disk1

1. Set Registry URL:

/container/config/set registry-url=https://registry-1.docker.io tmpdir=disk1/pull

2. Buat Folder & Mounts:

/container/mounts/add name=adguard_conf src=disk1/adguard/conf dst=/opt/adguardhome/conf
/container/mounts/add name=adguard_work src=disk1/adguard/work dst=/opt/adguardhome/work

Langkah 4: Download & Deploy Container

Sekarang pulling image AdGuard Home dari Docker Hub dan menjalankannya. Jalankan perintah ini untuk mengunduh dan membuat container:

/container/add remote-image=adguard/adguardhome:latest \
interface=veth-adguard \
root-dir=disk1/adguard/root \
mounts=adguard_conf,adguard_work \
logging=yes

Tunggu sampai statusnya berubah dari extracting menjadi stopped. Setelah itu, jalankan container:

/container/start [find tag~"adguard"]

Langkah 5: Setup Wizard AdGuard Home

Setelah container berjalan, AdGuard belum aktif sepenuhnya. Anda perlu melakukan setup awal melalui browser.

1. Buka browser dan akses: http://172.17.0.2:3000
2. Klik Get Started.
3. Admin Web Interface: Set ke port 80 (atau biarkan 3000 jika port 80 router sudah dipakai WebFig, tapi disarankan ganti port WebFig router ke 8080 agar AdGuard bisa pakai port 80).
4. DNS Server: Pastikan di set ke port 53.
5. Buat Username dan Password admin.

Langkah 6: Integrasi ke Jaringan Mikrotik

Agar semua perangkat di rumah/kantor otomatis terfilter iklannya, kita perlu mengarahkan DNS router ke AdGuard.

1. Masuk ke IP > DNS.
2. Set Servers ke IP Container: 172.17.0.2.
3. Centang Allow Remote Requests.
4. (Opsional) Buat NAT Redirect agar user yang set DNS manual (seperti 8.8.8.8) tetap dipaksa masuk ke AdGuard (Fitur Force DNS).

Mengakses Dashboard

Sekarang Anda bisa mengakses dashboard AdGuard Home kapan saja melalui http://172.17.0.2 (atau IP LAN router jika Anda sudah setup port forwarding) untuk melihat statistik blokir iklan.

---

Tips Troubleshooting

• Error “Manifest not found”: Biasanya karena arsitektur image tidak sesuai. Pastikan Anda pull image yang sesuai dengan CPU router (arm/arm64). MikroTik biasanya otomatis mendeteksi ini.
• Container Stop Sendiri: Cek log dengan perintah /log print. Seringkali masalah permission pada folder disk1 atau RAM router penuh.

Dengan langkah ini, MikroTik Anda kini lebih powerfull, tidak hanya sebagai router tapi juga sebagai pelindung jaringan dari iklan yang mengganggu. Selamat mencoba

Tags mikrotik-container