Memahami Docker, Image, Container, dan Portainer dengan Contoh AdGuard Home

Anda telah berhasil menginstal AdGuard Home. Sekarang, mari gunakan contoh ini untuk dengan cepat memahami cara kerja Docker dan Portainer di AI Board Anda. Ini bukan hanya tentang [cara melakukannya], tetapi juga [mengapa cara kerjanya seperti itu].

 

 

1. Apa yang Terjadi Saat Anda Klik Install untuk AdGuard Home?

    Ketika Anda mengklik tombol [Install] untuk AdGuard Home di AI Board Anda, sistem secara otomatis:

  1. Memeriksa apakah image AdGuard Home sudah ada secara lokal. Jika belum, sistem akan mengunduhnya dari Docker Hub.
  2. Menggunakan image tersebut untuk membuat container baru, mengalokasikan sumber daya, dan memberikan nama (misal: adguardhome).
  3. Membuat volume dan memasangnya ke path yang ditentukan oleh container, memastikan pengaturan dan data Anda tetap ada bahkan setelah restart.
  4. Mengatur jaringan dan pemetaan port sehingga Anda bisa mengakses AdGuard Home di http://<IP AI Board>:3000.
  5. Menjalankan container dan memantau statusnya.

    Semua ini terjadi secara otomatis setelah Anda mengklik [Install].

 

2. Melihat AdGuard Home di Portainer

    Portainer adalah alat manajemen Docker berbasis web yang memungkinkan Anda dengan mudah mengelola container, image, dan volume melalui browser Anda.

    Masuk ke Portainer： Anda dapat mengakses Portainer dari UI AI Board, atau langsung melalui URL (biasanya https://<nama host AI board Anda>:9443）。

    Setelah masuk, klik dasbor untuk masuk ke antarmuka manajemen.

 

    Halaman Kontainer:

  • Klik [Kontainer] di menu kiri untuk melihat semua kontainer yang sedang berjalan. AdGuard Home biasanya dinamai adguardhome.
  • Klik nama kontainer untuk melihat statusnya, log, dan penggunaan sumber daya. Anda juga dapat memulai, menghentikan, atau memulai ulang di sini.

 

 

    Halaman Gambar:

  • Klik [Gambar] untuk melihat semua gambar yang telah diunduh, termasuk AdGuard Home.

 

    Halaman Volume:

  • Klik [Volume] untuk melihat semua penyimpanan persisten. Temukan volume yang terkait dengan AdGuard Home—di sinilah pengaturan dan data Anda disimpan.

 

3. Apa itu Docker, Image, Container, dan Portainer?

  • Docker: Platform yang memungkinkan Anda menjalankan aplikasi dalam lingkungan terisolasi (container), sehingga penyebaran dan pengelolaan perangkat lunak menjadi mudah dan konsisten. Dengan Docker di AI Board, Anda dapat memasang berbagai aplikasi (seperti AdGuard Home, HomeAssistant) di router Anda, masing-masing berjalan secara mandiri.
  • Docker Hub: Docker Hub adalah repositori gambar daring tempat Anda bisa mencari dan mengunduh image yang sudah jadi. Anda dapat menginstalnya dengan beberapa perintah atau melalui Portainer.
  • Image: Cetakan aplikasi, berisi semua kode dan pustaka yang diperlukan untuk menjalankannya. Image bersifat statis dan tidak dapat diubah; hanya ketika Anda menjalankannya, mereka menjadi container. Anda dapat membuat beberapa container dari image yang sama.
  • Container: Instansi berjalan dari sebuah image (server mini). Setiap container memiliki lingkungan, pengaturan, dan sumber daya sendiri. Menghapus container tidak mempengaruhi image, dan Anda selalu dapat membuat ulang. Untuk data yang persisten, container menggunakan volume.
  • Volume: Menyimpan data yang harus tetap ada (seperti konfigurasi atau basis data) meskipun container dihapus atau dibuat ulang.
  • Portainer: Sebuah alat manajemen grafis untuk Docker, memungkinkan Anda melihat, mengontrol, dan memecahkan masalah kontainer, image, dan volume melalui antarmuka web.

 

4. Bagaimana Hubungannya?

  • Unduh atau buat image (cetak biru)
  • Gunakan Docker untuk memulai container (server mini)
  • Container menggunakan volume untuk menyimpan data penting
  • Portainer membantu Anda mengelola semuanya secara visual

 

5. Analogi Kehidupan Nyata

    Bayangkan Anda menjalankan sebuah toko roti

  • image adalah resep kue Anda, mencantumkan semua langkah dan bahan.
  • container adalah kue yang Anda buat dari resep; Anda bisa membuat banyak kue.
  • volume seperti buku catatan, menyimpan modifikasi khusus pada setiap kue dan preferensi pelanggan, agar tidak hilang meski Anda membuat kue baru.
  • Docker adalah dapur Anda, memastikan setiap kue dibuat di workstation masing-masing, mengikuti proses standar.
  • Portainer adalah dashboard toko roti Anda, menunjukkan kue mana yang sedang dibuat, resep apa yang Anda punya, dan di mana catatan Anda disimpan.

 

6. Latihan

    Semakin sering Anda menggunakan Portainer, semakin cepat Anda menguasai fleksibilitas Docker. Berikut beberapa latihan yang disarankan:

  • Buka halaman Containers, pilih adguardhome, klik Remove untuk menghapus container, lalu gunakan Docker Compose YAML untuk membuat yang baru. Jangan khawatir—membuat ulang container sangat cepat. Cobalah beberapa kali agar terbiasa dengan prosesnya.

  • Pergi ke halaman Stack, buat Stack baru, tempelkan AdGuard Home Docker Compose YAML, dan jalankan container baru.

  • Masukkan adguardhome di kolom Nama.

  • Tempelkan YAML berikut dan klik Deploy the stack.

 

versi: "3.8"
layanan:
   adguardhome:
        gambar: adguard/adguardhome:terbaru
        nama_kontainer: adguardhome
        mulai ulang: kecuali-dihentikan
        mode_jaringan: "host"
        lingkungan:
             # Mendefinisikan port antarmuka web default
          - ADGUARD_HOME_DEFAULT_WEB_PORT=3000
        volume:
          - adgh_kerja:/opt/adguardhome/work
          -adgh_conf:/opt/adguardhome/conf
          - /etc/hosts:/etc/hosts:ro
volumes:
   adgh_work:
   adgh_conf:
  • Setelah selesai, Anda akan melihat container AdGuard Home baru telah dibuat.

 

 

 

 

Cara mendapatkan (Utilitas / Firmware)?

Anda dapat mengunduh driver, software, firmware, dan buku manual pengguna terbaru di Pusat Unduhan ASUS.

Jika Anda membutuhkan informasi lebih lanjut tentang Pusat Unduhan ASUS, silakan lihat tautan ini.