[AI路由器] 用 AdGuard Home 範例認識 Docker、Image、Container、Portainer

你已經成功安裝 AdGuard Home，現在就用這個例子，帶你快速掌握 Docker 與 Portainer 在 AI Board 上的運作方式。這不只是「怎麼做」，更讓你理解「為什麼這樣做」。

 

 

1. 當你按下Install 按紐時安裝AdGuard Home，背後發生了什麼？

    當你在 AI Board 上按下 AdGuard Home 的「Install」按鈕，系統會自動：

  1. 檢查本地有無 AdGuard Home 映像檔(Image)，沒有就從 Docker Hub 下載。
  2. 用映像檔建立一個新的容器(Container)，分配資源並命名(如 adguardhome)。
  3. 建立資料卷(Volume)，掛載到容器指定路徑，確保設定與資料不會因重啟而遺失。
  4. 設定網路與端口映射，讓你能用 http://<AI Board IP>:3000 直接訪問。
  5. 啟動容器並監控狀態。

   這一切都在你點下「Install」後自動完成。

 

2. 用 Portainer 觀察 AdGuard Home

    Portainer 是 Docker 的網頁管理工具，讓你用瀏覽器就能輕鬆管理容器、映像檔、資料卷。

    登入 Portainer： 你可以從 AI Board UI 進入 Portainer，或直接用網址(通常是 https://<你的 AI board host name>:9443)。

    登入後，點擊儀表板進入管理介面。

  

    Containers(容器)頁面：

  • 左側選單點「Containers」，會看到所有正在運作的容器。AdGuard Home 通常叫 adguardhome。
  • 點進容器名稱，可查看狀態、日誌、資源用量，也能啟動、停止、重啟。

 

 

    Images(映像檔)頁面：

  • 點「Images」可看到所有已下載的映像檔，包括 AdGuard Home。

 

 

    Volumes(資料卷)頁面：

  • 點「Volumes」會列出所有持久化儲存空間。找到 AdGuard Home 相關的 volume，就是設定與資料保存的位置。

 

 

 3. 什麼是 Docker、Image、Container、Portainer？

  • Docker：讓你能在獨立環境(container，容器)中執行應用程式的平台，讓部署與管理軟體變得簡單又一致。AI Board 支援 Docker，讓你能在路由器內安裝多種應用(如 AdGuard Home、HomeAssistant)，彼此獨立、互不干擾。
  • Docker Hub：Docker Hub 是線上映像檔倉庫，你可以搜尋、下載各種現成映像檔，只要幾個指令或用 Portainer 就能安裝。
  • Image(映像檔)：應用程式的藍圖(blueprint)，包含執行所需的程式碼、函式庫。映像檔本身靜態、不可變，只有啟動後才會產生容器。你可以用同一份映像檔建立多個容器。
  • Container(容器)：映像檔啟動後的實體(mini server)，每個容器有自己的運行環境、設定與資源。刪除容器不會影響映像檔，隨時可重建。資料需持久保存時，會搭配 Volume。
  • Volume(資料卷)：保存容器內需持久化的資料(如設定檔、資料庫)，即使容器刪除或重建，資料仍保留。
  • Portainer：Docker 的圖形化管理工具，讓你用網頁介面就能看到、控制、排查所有容器、映像檔、資料卷。

 

 4. 它們的關係是什麼？

  • 下載或建立 映像檔(藍圖 blueprint)
  • 用 Docker 啟動 容器(mini server)
  • 容器用 資料卷 保存重要資料
  • Portainer 幫你用圖形化介面管理全部

 

 5. 生活化比喻

    想像你經營一家烘焙坊：

  • 映像檔 是蛋糕食譜(recipe)，記載所有步驟和原料。
  • 容器 是你根據食譜烤出來的蛋糕(cake)，可以烤很多個。
  • 資料卷 就像筆記本，保存每個蛋糕的特殊配方和顧客喜好，重烤也不會遺失。
  • Docker 是你的廚房，確保每次蛋糕都能在隔離的工作站照標準流程烤好。
  • Portainer 是你的烘焙坊管理儀表板，讓你一目了然有哪些蛋糕在烤、有哪些食譜、配方筆記存放在哪裡。

 

6. 常見問題

    1. 進入portainer 後看到需要重啟 Portainer 的訊息時該怎麼辦？

       有時後第一次安裝好portainer 但沒有馬上進去portainer 管理介面，會看到需要重啟 Portainer 的訊息。

       可以到 AI Board UI 的 Docker 管理頁面，點擊ON/OFF開關進行重啟。

 

7. 進一步練習

    多用 Portainer 實際操作，會讓你更快掌握 Docker 的彈性。建議練習：

  • 進到Containers頁面，勾選adguardhome， 按下 Remove， 移除 AdGuard Home 的容器，然後使用Docker compose YAML建立新的容器。別擔心，重新建立container 是很快的過程，你可以多試幾次來熟悉這個流程。

 

  • 到 Stack 頁面，建立新 Stack，貼上 AdGuard Home 的 Docker compose YAML，部署新容器。

 

  • Name 欄位輸入 adguardhome。 

 

  • 貼上以下 YAML 設定，按 Deploy the stack。

 

version: "3.8"
services:
   adguardhome:
        image: adguard/adguardhome:latest
        container_name: adguardhome
        restart: unless-stoppe
        network_mode: "host"
        environment:
             # Define default web interface port
          - ADGUARD_HOME_DEFAULT_WEB_PORT=3000
        volumes:
          - adgh_work:/opt/adguardhome/work
          - adgh_conf:/opt/adguardhome/conf
          - /etc/hosts:/etc/hosts:ro
volumes:
   adgh_work:
   adgh_conf:
  • 完成後就能看到新的 AdGuard Home 容器被建立。

 

 

 

 

 

如何取得(Utility / Firmware)？

您可以在華碩下載中心取得最新的軟體，手冊，驅動程式和韌體。

如果您需要有關華碩下載中心的更多訊息，請參考此連結。