Debian 13上,安裝docker+portainer

這是在 Debian 13 (Trixie) 上安裝 Docker 容器引擎(Docker Engine)與 Portainer 社群版(Portainer Community Edition, Portainer CE)的技術指南。


安裝流程概覽

步驟 項目 說明
1 環境準備 安裝必要套件並導入 Docker 官方金鑰 (GPG Key)
2 配置來源 將 Docker 官方軟體庫 (Repository) 加入系統來源
3 安裝核心 安裝 Docker 引擎、命令列工具及 Compose 插件
4 部署管理 使用 Docker 部署 Portainer 可視化管理界面


詳細操作步驟

1. 設置 Docker 儲存庫金鑰

首先更新現有套件清單,並安裝讓 apt 能透過 HTTPS 傳輸的必要工具。

Bash
# 更新套件索引
sudo apt update

# 安裝憑證與傳輸工具
sudo apt install ca-certificates curl

# 建立存放金鑰的目錄並設置權限
sudo install -m 0755 -d /etc/apt/keyrings

# 下載 Docker 官方的 GPG 金鑰並儲存
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc

# 確保金鑰文件具備可讀權限
sudo chmod a+r /etc/apt/keyrings/docker.asc

2. 加入 Docker 軟體源

Debian 13 使用新式的 .sources 格式定義軟體源,這能更清晰地指定金鑰路徑。

Bash
# 寫入 Docker 官方軟體源設定
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

3. 安裝 Docker 引擎

更新索引後,安裝 Docker 核心組件。

Bash
# 再次更新索引以讀取新加入的 Docker 源
sudo apt update

# 安裝 Docker Engine, CLI, 容器運行環境及 Compose 插件
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

4. 驗證服務狀態

確認 Docker 服務是否已成功啟動。

Bash
# 查看 Docker 服務運行狀態
sudo systemctl status docker

部署 Portainer 管理界面

Portainer 提供網頁化界面(Web User Interface, Web UI),方便管理容器、映像檔(Images)與磁碟卷(Volumes)。

1. 建立持久化儲存

Bash
# 建立一個名為 portainer_data 的磁碟卷,確保 Portainer 設定不會隨容器刪除而消失
docker volume create portainer_data

2. 執行 Portainer 容器

Bash
# 運行 Portainer CE 容器
docker run -d -p 8000:8000 -p 9443:9443 --name portainer \
--restart=always \
-v /var/run/docker.sock:/var/run/docker.sock \
-v portainer_data:/data \
portainer/portainer-ce:lts

備註:

  • -p 9443:9443: 使用 HTTPS 訪問。

  • -v /var/run/docker.sock:/var/run/docker.sock: 讓 Portainer 能夠通訊並控制本機的 Docker 守護行程(Docker Daemon)。

3. 驗證與訪問

Bash
# 確認容器是否在執行中
docker ps

請開啟瀏覽器並輸入以下網址進行初始化設定:

https://[你的伺服器IP]:9443


參考來源

隨機文章

隨機美圖

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *