Ubuntu上安裝Docker及可視化管理工具的流程步驟

更新時(shí)間：2025年02月10日 10:48:16 作者：大餅酥

本文詳細(xì)介紹了在Ubuntu?24.04?LTS上安裝、配置和卸載Docker,以及如何使用Portainer進(jìn)行可視化管理,還覆蓋了Docker的基本命令和常見問題處理,需要的朋友可以參考下

一、安裝Docker

在 Ubuntu 24.04 LTS 上，雖然可以通過 Ubuntu 的官方倉(cāng)庫直接安裝 Docker，但是這種方法通常無法獲取到最新的 Docker 版本，而且安全更新也可能延遲。因此，推薦從 Docker 的倉(cāng)庫進(jìn)行安裝，確?？梢杂蒙献钚掳姹竞妥詣?dòng)更新。

1、更新軟件包并安裝必要軟件

#更新軟件包索引
sudo apt update
 
#安裝添加 Docker 倉(cāng)庫所需的前置軟件包
sudo apt install apt-transport-https curl

2、導(dǎo)入 Docker 官方 GPG 密鑰

由于國(guó)內(nèi)網(wǎng)絡(luò)限制，Docker官方網(wǎng)站無法被訪問，后面采用阿里云的鏡像網(wǎng)站為主要源。
將https://download.docker.com/linux/ubuntu/ 修改為https://mirrors.aliyun.com/docker-ce/linux/ubuntu/ 即可。

#阿里云鏡像源
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
 
#官方網(wǎng)站
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

3、添加 Docker 倉(cāng)庫

添加Docker 的阿里云倉(cāng)庫添加到Ubuntu軟件源列表

#添加Docker的阿里云倉(cāng)庫到軟件源列表
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu/ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
 
#添加Docker的官方倉(cāng)庫到軟件源列表
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

4、更新軟件包列表

#刷新軟件包列表，以便系統(tǒng)識(shí)別新添加的 Docker 倉(cāng)庫
sudo apt update

5、安裝 Docker

#安裝Docker 引擎及其相關(guān)組件
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras

安裝的組件包括：

docker-ce：Docker Engine。
docker-ce-cli：用于與 Docker 守護(hù)進(jìn)程通信的命令行工具。
containerd.io：管理容器生命周期的容器運(yùn)行時(shí)環(huán)境。
docker-buildx-plugin：增強(qiáng)鏡像構(gòu)建功能的 Docker 擴(kuò)展工具，特別是在多平臺(tái)構(gòu)建方面。
docker-compose-plugin：通過單個(gè) YAML 文件管理多容器 Docker 應(yīng)用的配置管理插件。
docker-ce-rootless-extras：用于非 root 用戶運(yùn)行 Docker 容器而提供的一套額外工具集

6、檢查 Docker 服務(wù)狀態(tài)

#檢查 Docker 的運(yùn)行狀態(tài)
sudo systemctl is-active docker

7、運(yùn)行測(cè)試容器

#運(yùn)行 hello-world 測(cè)試容器，驗(yàn)證 Docker 是否安裝成功并正常工作
sudo docker run hello-world

8、替換 DockerHub 鏡像源

如果拉取 DockerHub 鏡像時(shí)遇到困難，可以替換為別的鏡像。

8.1、使用文本編輯器打開 Docker 的配置文件，如果沒有就新建。

sudo vim /etc/docker/daemon.json

8.2、在配置文件中添加或修改registry-mirrors，指定Docker鏡像源的URL

{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://dockerpull.org"
  ]
}

8.3、保存配置文件并重啟 Docker 服務(wù)

sudo systemctl daemon-reload
sudo systemctl restart docker

8.4、驗(yàn)證配置是否生效

sudo docker info

二、卸載Docker

要從 Ubuntu 24.04 LTS 中卸載 Docker，可以按照以下步驟操作：

1、使用以下命令卸載 Docker 及其相關(guān)組件：

sudo apt purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras

2、執(zhí)行以下命令來刪除 Docker 創(chuàng)建的目錄：

sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

完成這些步驟后，Docker 將完全從你的 Ubuntu 24.04 系統(tǒng)中移除。

三、Docker常用命令

docker run：運(yùn)行一個(gè)新的容器。
docker ps：列出當(dāng)前運(yùn)行的容器。
docker start：?jiǎn)?dòng)一個(gè)已經(jīng)停止的容器
docker stop：停止一個(gè)運(yùn)行中的容器。
docker rm：刪除一個(gè)容器。
docker images：列出本地鏡像。
docker rmi：刪除一個(gè)鏡像。
docker exec -it <容器名稱> /bin/bash：進(jìn)入容器內(nèi)。
docker logs：查看容器的日志。
docker inspect：查看容器或鏡像的詳細(xì)信息。

四、安裝Portainer可視化工具

1、下載Portainer鏡像

sudo docker pull portainer/portainer-ce

2、運(yùn)行Portainer容器

sudo docker run -d -p 9000:9000 \
--name portainer --restart always \
-v /var/run/docker.sock:/var/run/docker.sock \
-v portainer_data:/data portainer/portainer-ce

參數(shù)	參數(shù)說明
-d	在后臺(tái)運(yùn)行容器。
-p 9000:9000	將容器的9000端口映射到宿主機(jī)的9000端口。
--name portainer	為容器指定一個(gè)名稱為portainer。
--restart always	如果容器退出，總是自動(dòng)重啟。
-v /var/run/docker.sock:/var/run/docker.sock	將Docker守護(hù)進(jìn)程的Unix套接字掛載到容器中，這允許Portainer直接與Docker守護(hù)進(jìn)程通信。
-v portainer_data:/data	創(chuàng)建一個(gè)持久化的數(shù)據(jù)卷，以保存Portainer的配置數(shù)據(jù)。
portainer/portainer-ce	指定要運(yùn)行的Portainer鏡像。

容器運(yùn)行參數(shù)詳解參考：Docker容器運(yùn)行常用參數(shù)詳解_docker_腳本之家

3、查看portainer是否啟動(dòng)

docker ps

4、瀏覽器登錄驗(yàn)證

瀏覽器訪問 ip:9000 即可，初次登陸時(shí)需要設(shè)置一個(gè)admin賬號(hào)的密碼，輸入8位密碼創(chuàng)建用戶，同時(shí)勾選下方的允許匿名選項(xiàng)。

出現(xiàn)如下問題是因?yàn)閯?chuàng)建用戶超時(shí)，重啟portainer重新創(chuàng)建即可

?sudo docker restart portainer

進(jìn)入portainer頁面

五、常見問題處理

1、非 root 用戶運(yùn)行 Docker 命令

默認(rèn)情況下，只有 root 用戶或具有 sudo 權(quán)限的用戶才能夠執(zhí)行 Docker 命令。如果不加sudo前綴直接運(yùn)行docker命令，系統(tǒng)會(huì)報(bào)權(quán)限錯(cuò)誤。

可以運(yùn)行以下命令將當(dāng)前登錄的用戶添加到 docker 組，以便以非 root 用戶身份運(yùn)行 Docker 命令：