這是在 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
參考來源
隨機文章
- 關於最近我聽到的htc手機狀況 (2014-02-12)
- facebook 開心神農 開心農場外掛 (2009-12-15)
- 正確睡午睡 精神更好 (2007-11-07)
- 網路上到處有好人 (2011-01-19)
- Ubuntu64位元作業系統上無法看PPS/PPLIVE (2011-10-07)








