在 Fedora 上安裝 Docker 引擎
若要在 Fedora 上開始使用 Docker 引擎,請確認您符合先決條件,然後按照安裝步驟操作。
先決條件
作業系統需求
要安裝 Docker 引擎,您需要下列其中一個 Fedora 版本的維護版本
- Fedora 40
- Fedora 41
解除安裝舊版本
在安裝 Docker 引擎之前,您需要解除安裝任何衝突的套件。
您的 Linux 發行版可能提供非官方的 Docker 套件,這些套件可能與 Docker 提供的官方套件衝突。您必須先解除安裝這些套件,才能安裝 Docker 引擎的官方版本。
$ sudo dnf remove docker \
docker-client \
docker-client-latest \
docker-common \
docker-latest \
docker-latest-logrotate \
docker-logrotate \
docker-selinux \
docker-engine-selinux \
docker-engine
dnf
可能會回報您沒有安裝任何這些套件。
解除安裝 Docker 時,儲存在 /var/lib/docker/
中的映像檔、容器、磁碟區和網路不會自動移除。
安裝方法
您可以根據您的需求以不同的方式安裝 Docker 引擎
您可以設定 Docker 的儲存庫並從中安裝,以便輕鬆安裝和升級。這是建議的方法。
您可以下載 RPM 套件,手動安裝,並完全手動管理升級。這在沒有網際網路連線的 air-gapped 系統上安裝 Docker 等情況下很有用。
在測試和開發環境中,您可以使用自動化的便捷指令碼來安裝 Docker。
使用 rpm 儲存庫安裝
在新的主機上第一次安裝 Docker 引擎之前,您需要設定 Docker 儲存庫。之後,您可以從儲存庫安裝和更新 Docker。
設定儲存庫
安裝 dnf-plugins-core
套件(提供管理 DNF 儲存庫的指令)並設定儲存庫。
$ sudo dnf -y install dnf-plugins-core
$ sudo dnf-3 config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo
安裝 Docker 引擎
安裝 Docker 套件。
要安裝最新版本,請執行
$ sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
如果系統提示您接受 GPG 金鑰,請驗證指紋是否與
060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35
相符,如果相符,請接受它。此指令會安裝 Docker,但不會啟動 Docker。它也會建立一個
docker
群組,但是,預設情況下它不會將任何使用者新增至該群組。要安裝特定版本,請先列出儲存庫中可用的版本
$ dnf list docker-ce --showduplicates | sort -r docker-ce.x86_64 3:27.3.1-1.fc41 docker-ce-stable docker-ce.x86_64 3:27.3.0-1.fc41 docker-ce-stable <...>
傳回的清單取決於啟用了哪些儲存庫,並且特定於您的 Fedora 版本(在此範例中由
.fc40
後綴表示)。透過其完整合格的套件名稱安裝特定版本,該名稱是套件名稱 (
docker-ce
) 加上版本字串(第 2 欄),以連字號 (-
) 分隔。例如,docker-ce-3:27.3.1-1.fc41
。將
<VERSION_STRING>
替換為所需的版本,然後執行以下指令進行安裝$ sudo dnf install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin
此指令會安裝 Docker,但不會啟動 Docker。它也會建立一個
docker
群組,但是,預設情況下它不會將任何使用者新增至該群組。啟動 Docker 引擎。
$ sudo systemctl enable --now docker
這會將 Docker systemd 服務設定為在系統啟動時自動啟動。如果您不希望 Docker 自動啟動,請改用
sudo systemctl start docker
。透過執行
hello-world
映像檔來驗證安裝是否成功$ sudo docker run hello-world
此指令會下載測試映像檔並在容器中執行它。容器執行時,它會列印確認訊息並結束。
您現在已成功安裝並啟動 Docker 引擎。
提示
嘗試在沒有 root 權限的情況下執行時收到錯誤?
docker
使用者群組存在但沒有包含任何使用者,這就是為什麼您需要使用sudo
來執行 Docker 指令的原因。繼續Linux 安裝後步驟以允許非特權使用者執行 Docker 指令以及其他選用的設定步驟。
升級 Docker 引擎
要升級 Docker 引擎,請按照安裝說明操作,選擇您要安裝的新版本。
從套件安裝
如果您無法使用 Docker 的 rpm
儲存庫來安裝 Docker 引擎,您可以下載適用於您版本的 .rpm
檔案並手動安裝。每次要升級 Docker 引擎時,都需要下載一個新檔案。
前往 https://download.docker.com/linux/fedora/ 並選擇您的 Fedora 版本。然後瀏覽至
x86_64/stable/Packages/
並下載您要安裝的 Docker 版本的.rpm
檔案。安裝 Docker Engine,將以下路徑更改為您下載 Docker 套件的路徑。
$ sudo dnf install /path/to/package.rpm
Docker 已安裝但尚未啟動。已建立
docker
群組,但沒有使用者被新增到該群組。啟動 Docker 引擎。
$ sudo systemctl enable --now docker
這會將 Docker systemd 服務設定為在系統啟動時自動啟動。如果您不希望 Docker 自動啟動,請改用
sudo systemctl start docker
。透過執行
hello-world
映像檔來驗證安裝是否成功$ sudo docker run hello-world
此指令會下載測試映像檔並在容器中執行它。容器執行時,它會列印確認訊息並結束。
您現在已成功安裝並啟動 Docker 引擎。
提示
嘗試在沒有 root 權限的情況下執行時收到錯誤?
docker
使用者群組存在但沒有包含任何使用者,這就是為什麼您需要使用sudo
來執行 Docker 指令的原因。繼續Linux 安裝後步驟以允許非特權使用者執行 Docker 指令以及其他選用的設定步驟。
升級 Docker 引擎
要升級 Docker Engine,請下載較新的套件檔案並重複安裝步驟,使用 dnf upgrade
取代 dnf install
,並指向新的檔案。
使用便利腳本安裝
Docker 在 https://get.docker.com/ 提供了一個便利腳本,可以非互動方式將 Docker 安裝到開發環境中。不建議將便利腳本用於生產環境,但它對於建立符合您需求的佈建腳本很有用。另請參閱使用儲存庫安裝步驟,以了解使用套件儲存庫安裝的步驟。該腳本的原始碼是開源的,您可以在 GitHub 上的 docker-install
儲存庫 中找到它。
在本地執行之前,請務必檢查從網際網路下載的腳本。安裝之前,請先了解便利腳本的潛在風險和限制。
- 腳本需要
root
或sudo
權限才能執行。 - 腳本會嘗試偵測您的 Linux 發行版本和版本,並為您設定套件管理系統。
- 腳本不允許您自訂大多數安裝參數。
- 腳本會在未經確認的情況下安裝依賴項和建議。根據主機目前的設定,這可能會安裝大量的套件。
- 預設情況下,腳本會安裝 Docker、containerd 和 runc 的最新穩定版本。使用此腳本佈建機器時,可能會導致 Docker 意外的主要版本升級。在部署到生產系統之前,請務必在測試環境中測試升級。
- 腳本並非設計用於升級現有的 Docker 安裝。使用腳本更新現有安裝時,依賴項可能不會更新到預期版本,導致版本過時。
提示
在執行之前預覽腳本步驟。您可以使用
--dry-run
選項執行腳本,以了解腳本在調用時將執行的步驟。$ curl -fsSL https://get.docker.com -o get-docker.sh $ sudo sh ./get-docker.sh --dry-run