快捷導(dǎo)航

在Ubuntu?Server?22.04上安裝?Docker的詳細步驟記錄

更新時間：2024年08月26日 08:31:51 作者：紅色標記

通過使用容器技術(shù),Docker能夠讓開發(fā)人員將應(yīng)用及其依賴環(huán)境一同打包,從而實現(xiàn)快速部署、一致的開發(fā)環(huán)境和優(yōu)秀的可移植性,這篇文章主要給大家給大家介紹了關(guān)于在Ubuntu?Server?22.04上安裝?Docker詳細步驟的相關(guān)資料,需要的朋友可以參考下

前言

本文檔詳細記錄了在 Ubuntu Server 22.04 上安裝 Docker 的完整過程，包括解決過程中遇到的問題。希望能對讀者有所幫助。

安裝過程，重點需要看官方文檔。https://docs.docker.com/engine/install/ubuntu/

步驟 1：卸載沖突的軟件包

在安裝 Docker Engine 之前，您需要卸載所有有沖突的軟件包。發(fā)行版維護者在 APT 中提供了 Docker 軟件包的非官方發(fā)行版。您必須先卸載這些軟件包，然后才能安裝 Docker Engine 的正式版本。

要卸載的非官方軟件包包括：

docker.io
docker-compose
docker-compose-v2
docker-doc
podman-docker

此外，Docker Engine 依賴于 containerd 和 runc。Docker Engine 將這些依賴項捆綁為一個包：containerd.io。如果您之前安裝了 containerd 或 runc，請卸載它們以避免與 Docker Engine 捆綁的版本發(fā)生沖突。

運行以下命令來卸載所有沖突的包：

for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

apt-get 可能會報告您沒有安裝這些包。

注意：卸載 Docker 時，不會自動刪除存儲在 /var/lib/docker/ 中的圖像、容器、卷和網(wǎng)絡(luò)。如果您想從全新安裝開始，并且希望清理所有現(xiàn)有數(shù)據(jù)，請閱讀卸載 Docker Engine 部分。

步驟 2：更新系統(tǒng)軟件包

首先，更新系統(tǒng)中的現(xiàn)有軟件包：

sudo apt update

步驟 3：安裝依賴包

安裝必要的依賴包，這些包用于通過 HTTPS 獲取軟件倉庫：

sudo apt install apt-transport-https ca-certificates curl software-properties-common

步驟 4：添加 Docker 中科大 GPG 密鑰

為了確保下載的 Docker 軟件包的真實性和完整性，我們需要添加 Docker 的 GPG 密鑰：

sudo mkdir -p /etc/apt/keyrings
sudo curl -fsSL http://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

可能的問題

無法下載 GPG 密鑰：
- 錯誤信息：curl: (6) Could not resolve host: mirrors.ustc.edu.cn
- 解決方案：在網(wǎng)上搜索其他鏡像站點。參考連接：https://blog.csdn.net/m0_46471328/article/details/138043873
背景知識：GPG 密鑰用于驗證軟件包的完整性和真實性，確保下載的軟件包沒有被篡改。

步驟 5：添加 Docker 中科大鏡像穩(wěn)定版軟件源

我們使用中科大的鏡像源來加快下載速度：

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] http://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

可能的問題

鏡像源添加失敗：
- 錯誤信息：bash: /etc/apt/sources.list.d/docker.list: Permission denied
- 解決方案：確保使用 sudo 運行命令以獲得必要的權(quán)限。
背景知識：軟件源是存儲軟件包的服務(wù)器地址，添加 Docker 的中科大鏡像源可以加快下載速度，并提高可靠性。

步驟 6：再次更新軟件包

添加新的 Docker 軟件源后，再次更新系統(tǒng)中的軟件包索引：

sudo apt update

可能的問題

更新失敗：
- 錯誤信息：Failed to fetch http://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/dists/focal/stable/binary-amd64/Packages 404 Not Found
- 解決方案：檢查 sources.list.d/docker.list 文件中的鏡像源地址是否正確，并確認中科大鏡像源可用。
背景知識：更新軟件包索引是為了讓系統(tǒng)知道最新的軟件包信息，包括新添加的軟件源中的包。

步驟 7：安裝最新版本的 Docker

安裝 Docker 及其依賴包：

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

可能的問題

安裝失敗：
- 錯誤信息：E: Unable to locate package docker-ce
- 解決方案：確保之前步驟中的鏡像源已正確添加并更新了軟件包索引。
背景知識：Docker 是一個開源的平臺，用于開發(fā)、交付和運行應(yīng)用程序。它將應(yīng)用程序及其依賴項打包到一個標準化的單元中，稱為容器。

步驟 8：配置 Docker 使用鏡像加速器（hub）

由于國內(nèi)訪問 Docker Hub 可能會有速度和連接問題，我們配置 Docker 使用騰訊云的鏡像加速器：

sudo mkdir -p /etc/docker
echo '{
    "registry-mirrors": ["https://ccr.ccs.tencentyun.com"]
}' | sudo tee /etc/docker/daemon.json > /dev/null

可能的問題

無法訪問鏡像加速器：
- 錯誤信息：dial tcp: lookup ccr.ccs.tencentyun.com on 127.0.0.53:53: no such host
- 解決方案：確保配置的鏡像加速器地址正確并可訪問，可能需要更換其他地址。地址 127.0.0.53:53 是一個本地 DNS 緩存服務(wù)，通常是由系統(tǒng)的 systemd-resolved 服務(wù)提供的。
背景知識：鏡像加速器可以提高從 Docker Hub 拉取鏡像的速度，特別是在國內(nèi)網(wǎng)絡(luò)環(huán)境下。

步驟 9：重新啟動 Docker 服務(wù)

使配置生效，重新啟動 Docker 服務(wù)：

sudo systemctl daemon-reload
sudo systemctl restart docker

步驟 10：驗證 Docker 安裝

運行一個簡單的 Docker 容器來驗證安裝是否成功：

sudo docker run hello-world

可能的問題

無法訪問 Docker Hub：
- 錯誤信息：denied: requested access to the resource is denied unauthorized: authentication required
- 解決方案：通過以下命令登錄 Docker Hub：
```
sudo docker login
```
按照提示輸入 Docker Hub 用戶名和密碼即可。
網(wǎng)絡(luò)連接問題：
- 錯誤信息：dial tcp: lookup registry-1.docker.io on 127.0.0.53:53: no such host
- 解決方案：配置鏡像加速器并重啟 Docker 服務(wù)后，再次嘗試拉取鏡像。
背景知識：hello-world 鏡像是一個非常小的鏡像，用于驗證 Docker 是否正常工作。