Raspberry Pi 5（樹莓派 5）- Ubuntu Server 24.04 Docker 環境安裝

前言

隨著 樹莓派 5（Raspberry Pi 5） 效能的提升，在此平台上部署容器化應用變得更加可行，Docker 作為目前最流行的容器化平台，不僅提供了應用程式的隔離環境，更簡化了軟體的安裝與管理流程。在 Ubuntu Server 24.04 LTS 的基礎上，安裝 Docker 環境能讓 樹莓派 5 快速轉變為功能強大的微型伺服器，支援各種容器化應用的部署。

本文將介紹 Docker 及 Docker Compose 的安裝步驟，並包含 Portainer 環境的設定教學，協助您輕鬆建立一個完整的容器管理平台，為後續的應用部署奠定堅實的基礎。

Docker 環境安裝

1. 更新套件清單

   sudo apt update
   

   

2. 安裝需要的套件

   sudo apt -y install apt-transport-https ca-certificates curl
   
   sudo apt -y install software-properties-common gnupg lsb-release
   

3. 增加 Docker 官方的 GPG 密鑰

   curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
   

4. 增加 Docker 官方庫，指定 ARM64

   echo "deb [arch=arm64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu focal stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
   

   

5. 再次更新套件清單

   sudo apt update
   

6. 安裝 Docker

   sudo apt -y install docker-ce docker-ce-cli containerd.io
   

7. 確認 Docker 的狀態

   sudo systemctl status docker
   
   # 按 q 離開
   

   

8. 開機時自動啟動 Docker 服務

   sudo systemctl enable docker
   

   

9. 查詢 Docker 的版本

   sudo docker version
   

   

10. 安裝 Docker Compose

    sudo curl -L "https://github.com/docker/compose/releases/download/v2.32.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
    
    sudo chmod +x /usr/local/bin/docker-compose
    

11. 查詢 Docker Compose 的版本

    docker-compose --version
    

    

(備註) Docker 環境移除

1. 停止並移除 Docker 服務

   sudo systemctl stop docker
   sudo systemctl disable docker
   

2. 移除 Docker 相關套件

   sudo apt-get remove -y --purge docker-ce docker-ce-cli containerd.io
   

3. 移除 Docker Compose

   sudo rm -f /usr/local/bin/docker-compose
   

4. 清理剩餘的 Docker 與 Compose 設定

   sudo apt-get -y autoremove --purge
   sudo apt-get autoclean
   

Portainer 環境設定

為什麼使用 Portainer？

1. 簡化操作： 適合對 Docker 不熟悉的使用者，提供可視化操作界面，降低學習曲線。
2. 集中管理： 在一個界面管理多個容器、映像和網路資源。
3. 高效率： 快速部署應用程式堆疊，支援 YAML 檔案。
4. 跨平台支援： 適用於 Windows、Linux 和 macOS，還能與 Kubernetes 整合。
5. 節省時間： 節省手動執行繁瑣命令的時間。

如何安裝 Portainer？

1. 建立與切換到專用目錄

   mkdir portainer && cd portainer
   

2. 建立 docker-compose.yml

   services:
     portainer:
       # 使用 Portainer 的最新開源版本映像檔
       image: portainer/portainer-ce:latest
       container_name: portainer   # 指定容器名稱為 portainer
       restart: always   # 容器失敗時自動重啟
       ports:
         - "9000:9000"   # 對應本機的9000埠到容器的9000埠 (HTTP Web 介面)
         - "9443:9443"   # 對應本機的9443埠到容器的9443埠 (HTTPS Web 介面)
       volumes:
         # 掛載Docker Socket，允許Portainer直接與Docker引擎通訊(用於管理容器)
         - /var/run/docker.sock:/var/run/docker.sock
         # 使用目前目錄下的 data 資料夾來儲存 Portainer 的設定資料
         - ./data:/data
   

3. 啟動 Portainer
   在 docker-compose.yml 檔案所在目錄，執行指令

   docker-compose up -d
   

   停止 Portainer
   在 docker-compose.yml 檔案所在目錄，執行指令

   docker-compose stop
   

   重啟 Portainer
   在 docker-compose.yml 檔案所在目錄，執行指令

   docker-compose restart
   

4. 存取 Portainer
   1. 開啟瀏覽器並存取以下網址：
      • HTTP：http://<伺服器IP>:9000
      • HTTPS：https://<伺服器IP>:9443
   2. 首次使用時，會要求設定管理員帳號密碼。
   3. 設定完成後，即可使用 Portainer 管理 Docker 環境。

結語

透過本文的教學說明，可以在 樹莓派 5 的 Ubuntu Server 環境中安裝 Docker、Docker Compose 以及 Portainer 管理工具，不僅提升了應用部署的效率和彈性，更讓系統管理變得直觀而簡單，特別是透過 Portainer 的圖形化介面，即使對 Docker 不熟悉的使用者也能快速上手，輕鬆管理多個容器和應用。

這樣的設定為 樹莓派 5 打造了一個專業級的容器平台，無論是用於開發測試、IoT 應用還是家用伺服器，都能輕鬆應對，未來還可以依據需求，進一步探索更多 Docker 生態系統的工具，擴展樹莓派 5 的應用範圍。