SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

Rocky Linux 與 AlmaLinux 安裝 Docker 教學

在 Rocky Linux 與 AlmaLinux 上安裝 Docker Engine。本指南解決常見問題,包括如何移除 podman-docker 別名,以及修正 SELinux 導致 bind mounts 權限不足的錯誤。

在 Rocky Linux 與 AlmaLinux 上安裝 Docker

在 Rocky Linux 或 AlmaLinux 上安裝 Docker 時,先加入 Docker 自有的 dnf 儲存庫,再安裝包含 Compose 外掛程式的引擎,最後啟用服務。這部分只需執行 4 個命令。由於這兩個發行版都是 Red Hat Enterprise Linux (RHEL) 的重建版本,且共用相同的套件配置,因此安裝方式完全相同。CentOS Stream 也採用相同方式。以下內容同樣適用於兩者;如果你仍在兩者之間選擇,決定因素是各專案提出的相容性承諾,以及你的舊款 CPU 是否仍受支援。

安裝步驟很短,因此本指南的大部分內容會說明 Enterprise Linux (EL) 與 Ubuntu 的差異。你的映像檔可能已將 docker 命令交由 Podman 使用。只有啟用 Docker 的 SELinux 支援後,SELinux 才會限制容器;啟用後,bind mount 的檔案若沒有正確標籤,就會被阻擋。Firewalld 不會過濾 Docker 發布的連接埠,因此容器連接埠可能已對網際網路開放,即使 firewall-cmd 顯示沒有開放的連接埠。

請勿使用來自 get.docker.com 的 Docker 便利安裝指令碼。Docker 官方文件表示不建議在正式環境中使用該指令碼。它會在未經確認的情況下改寫儲存庫設定,而且無法安全地重複執行來進行升級。手動加入儲存庫後,dnf upgrade 會將 Docker 視為系統上的一般套件處理。這也會讓引擎納入 dnf-automatic 的管理範圍;如果你讓它依排程套用安全性更新,因此應及早決定要讓 Docker 自動套用修補程式,還是等到維護時段再更新。無論採用哪種方式,升級都會替換套件提供的二進位檔,但舊的 dockerd 仍會繼續執行;needs-restarting 會告訴你哪些服務仍在執行剛被替換的程式碼。

podman 是否已經在回應 docker 指令?

Rocky Linux 和 AlmaLinux 的預設套件庫都提供 podman,許多 VPS 映像檔也會預先安裝。部分映像檔會進一步安裝 podman-docker,在 /usr/bin/docker 放置一個會呼叫 podman 的 shell script。之後輸入的每個 docker 指令都會改由 podman 執行,因此原本針對 Docker 撰寫的指南可能產生非預期的輸出。

最先可觀察到的是提示訊息。/usr/bin/docker script 會在 /etc/containers 以及自己的 ~/.config/containers 目錄中尋找名為 nodocker 的檔案;如果設定了 $XDG_CONFIG_HOME,則會在該位置尋找。兩個檔案都不存在時,它會在執行任何內容前輸出一行:

Emulate Docker CLI using podman. Create /etc/containers/nodocker to quiet msg.

有人可能建立其中一個檔案來停用提示訊息,因此不要只依賴這項判斷。請查詢套件資料庫,確認哪個套件擁有該 binary:

command -v docker
rpm -qf "$(command -v docker)"

如果結果以 podman-docker 開頭,表示由 podman 回應。如果結果以 docker-ce-cli 開頭,表示使用真正的 Docker。如果 rpm -qf 回報沒有套件擁有該檔案,表示有人手動安裝它;在信任之前,應先閱讀該 script。

Podman 會執行相同的 OCI 映像檔,因此是合理的選擇。如果要使用它,現在即可停止。兩者都是 Linux container engine;如果平台選擇尚未確定,值得注意的是,FreeBSD jail 會隔離完整的 userland,而不是執行從 registry 拉取的分層映像檔。如果要使用 Docker Engine,請先移除衝突的套件。這是 Docker 為 RHEL 記錄的清單:

sudo dnf remove docker docker-client docker-client-latest docker-common \
  docker-latest docker-latest-logrotate docker-logrotate docker-engine podman runc

確認前,先查看 dnf 計畫一併移除的內容。在全新的 VPS 映像檔上,清單通常很短。在已經有人使用過的主機上,移除 podman 可能會一併移除 cockpit-podman 或其他依賴它的工具。

原則上可以讓 podman 與 Docker 並存:只移除 podman-docker,讓 docker 名稱空出來,並移除 runc;containerd.io 套件會取代它。Docker 文件將 podman 視為衝突套件,因此這種配置不在 Docker 支援範圍內。如果安裝仍回報衝突,請使用上述完整的移除清單。

使用 dnf config-manager 新增 Docker 儲存庫

Docker 會在 download.docker.com 發布 Enterprise Linux 的 RPM。儲存庫檔案指向 CentOS tree;Rocky Linux 和 AlmaLinux 會以此解析。若不了解 兩個發行版在 Red Hat 於 2020 年將 CentOS 轉為 Stream 後,如何從 CentOS 系譜發展而來,將 Rocky 主機指向 CentOS 儲存庫看起來像是錯誤。2026 年 11 月 10 日確認時,Docker 將此儲存庫文件用於 CentOS Stream 9 和 CentOS Stream 10。

sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

dnf 的 Version 5 移除了 --add-repo 引數,因此第二個命令在較新的版本會失敗。先檢查目前版本,再選擇相符的寫法:

dnf --version

如果輸出 5.x 版本,請改用子命令寫法:

sudo dnf config-manager addrepo --from-repofile=https://download.docker.com/linux/centos/docker-ce.repo

兩種寫法都會將相同檔案寫入 /etc/yum.repos.d/docker-ce.repo。錯誤寫法會回報未知引數錯誤,而不是悄悄執行錯誤操作,因此不會漏掉這個問題。

該儲存庫檔案會將 baseurl 設為包含 $releasever 的路徑,dnf 再從 release package 展開此變數。Rocky Linux 和 AlmaLinux 會將其設為 major version number,因此 EL 9 會是 9,EL 10 會是 10。這就是 CentOS 儲存庫能在 Rocky 主機上正確解析的原因。安裝前先確認展開結果:

sudo dnf repoinfo docker-ce-stable

查看 Repo-baseurl 行。結尾應為 /9/x86_64/stable 或 /10/x86_64/stable。如果你的 release 將 $releasever 設為 9.6 這類 point version,該行會顯示 /9.6/;dnf 擷取該 URL 的 metadata 時,會回報 Status code: 404。請編輯 /etc/yum.repos.d/docker-ce.repo,將 $releasever 替換為不含其他內容的 major number,以修正此問題。單獨出現 404 並不能證明原因就是這項設定。Red Hat 列出的相同錯誤其他原因,還包括 repository metadata 不一致及 base URL 錯誤,因此只有在 Repo-baseurl 確實顯示 point release 時才進行修改。如果結尾已是 major number,替換該變數不會產生任何變化。

安裝 engine 與 compose plugin

sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

這 5 個套件各自負責一項工作。docker-ce 是 daemon,dockerd。docker-ce-cli 是您輸入的 docker 命令。containerd.io 是由 daemon 驅動的 container runtime。docker-buildx-plugin 用來建置 image。docker-compose-plugin 會以子命令形式提供 docker compose。

這些套件不會安裝帶連字號的 docker-compose binary。那是 Compose v1;Compose v2 普遍推出後,Docker 已宣布 Compose v1 終止生命週期。凡是以連字號呼叫 docker-compose 的內容,都必須改為以空格呼叫 docker compose。

第一次安裝時,程序會先匯入 Docker 的 signing key,並顯示其 fingerprint。該 key 的來源是您剛加入的 repo 檔案中的 gpgkey=https://download.docker.com/linux/centos/gpg,因此接受前,請將 dnf 顯示的 fingerprint 與該 URL 比對。

有一個常見錯誤值得特別說明。如果 dnf 回報 containerd.io 需要 container-selinux,但沒有任何套件提供該相依套件,表示您的 AppStream repository 已停用。執行 dnf repolist,並確認清單中列有 appstream,因為 EL 9 與 EL 10 上的 container-selinux 由該 repository 提供。

啟動 Docker 並確認其正常運作

sudo systemctl enable --now docker
sudo systemctl status docker --no-pager
sudo docker run --rm hello-world

Docker 的 RPM 套件安裝完成後,daemon 預設會停止且停用。因此,Docker 的 CentOS 頁面會包含這個步驟;Ubuntu 頁面則不會,因為 deb 套件會代為啟動服務。略過 enable 時,Docker 會持續運作到下一次重新開機,之後便會停止,所有容器也會一併停止。

systemctl status 應顯示 Active: active (running)。hello-world 容器應輸出 This message shows that your installation appears to be working correctly. 後結束。若改為在 /var/run/docker.sock 顯示權限錯誤,表示你省略了 sudo;下方的 docker 群組章節會修正這個問題。

請另外檢查 compose plugin,因為它是不同的套件。即使 engine 正常運作,該 plugin 仍可能缺少:

docker compose version

在全新安裝中,正常結果應類似 Docker Compose version v5.7.0。這是 Docker 的 EL 9 repository 截至 10 November 2026 所提供的版本。從 v2 跳到 v5 不代表發生錯誤。Docker 在 2025 年發布功能上與 v2 相同的 Compose v5,並略過中間版本號,以避免與標示為 v2 和 v3 的舊版 Compose 檔案格式混淆。Docker 同時支援 Compose v2 和 Compose v5,因此較舊的主機若回應 v2.x.x,仍代表運作正常;dnf upgrade 可將其升級至 v5。重新開機後讓服務恢復運作,與啟用 daemon 是不同的問題;restart policies 會決定 Compose 服務是否在開機時恢復。

綁定掛載為何會出現權限遭拒?

Rocky Linux 和 AlmaLinux 預設會以 enforcing 模式執行 SELinux(Security-Enhanced Linux)。使用 getenforce 確認;此命令會輸出 Enforcing。

主機上的強制執行本身不會限制 Docker 容器。Docker 對 SELinux 的支援是 daemon 設定 selinux-enabled,預設為關閉,docker-ce 套件也不會自動啟用。關閉時,容器會以 spc_t 啟動,這是不受限制的類型,因此綁定掛載不需要任何標籤即可運作,SELinux 也不會讓容器與主機隔離。若要讓 SELinux 限制容器,請在 /etc/docker/daemon.json 啟用此設定,然後重新啟動 daemon。若該檔案已有設定,請將此鍵加入現有物件,不要覆寫整個檔案:

echo '{ "selinux-enabled": true }' | sudo tee /etc/docker/daemon.json
sudo systemctl restart docker

啟用標籤後,Docker 容器會以 SELinux 類型 container_t 執行。該原則會讓此類型完整存取標籤為 container_file_t 的檔案,以及 nfs_t 等少數檔案系統類型;對 container_ro_file_t 等其他類型則具備讀取權限。它不會授予容器存取一般主機目錄所帶之通用標籤的權限。您在主機上建立的目錄會繼承其父路徑提供的標籤,因此即使從主機端查看時擁有者、群組與模式都正確,容器仍會遭拒。使用以下 3 個命令重現問題:

sudo mkdir -p /srv/site
echo hello | sudo tee /srv/site/index.html
sudo docker run --rm -v /srv/site:/usr/share/nginx/html:ro nginx:alpine cat /usr/share/nginx/html/index.html

容器會輸出:

cat: can't open '/usr/share/nginx/html/index.html': Permission denied

以下 2 個命令可顯示原因。ls -ldZ /srv/site 會輸出標籤;對於 /srv 下的路徑,標籤是 system_u:object_r:var_t:s0,不是 container_file_t。接著,sudo ausearch -m avc -ts recent 會輸出核心的 audit 記錄,其中包含 avc: denied { read },也就是命名 container_t 的 scontext= 欄位,以及命名您剛才在目錄上看到之標籤的 tcontext= 欄位。這 2 個欄位不一致,就是完整原因。

修正方式是在 volume 引數後加上尾碼。Docker 會替您重新標記路徑:

sudo docker run --rm -v /srv/site:/usr/share/nginx/html:ro,z nginx:alpine cat /usr/share/nginx/html/index.html

小寫的 :z 會將內容重新標記為 shared,讓多個容器使用同一個目錄。大寫的 :Z 會將內容重新標記為 private 且不共用,並繫結至單一容器;此時,第二個容器讀取相同路徑便會遭拒。凡是 sidecar 或 backup 容器也會存取的目錄,請使用 :z。由單一容器擁有的資料庫目錄,請使用 :Z。

Docker 文件中的警告值得再次說明,因為重新標記會遞迴套用。若使用 :Z 綁定掛載 /home 或 /usr 等系統目錄,可能會「使主機無法運作,且可能需要手動重新標記主機檔案」。請只將這些尾碼用於為容器建立的目錄,絕不要指向系統路徑。

在 Compose 中,尾碼要加在相同的字串上:

services:
  web:
    image: nginx:alpine
    volumes:
      - /srv/site:/usr/share/nginx/html:ro,z

有 2 個限制很容易忽略。--mount 旗標完全無法設定 SELinux 標籤,因此需要標籤時請使用 -v。Named volume 不需要尾碼,因為 Docker 會自行標記其在 /var/lib/docker/volumes 下建立的目錄。

不要關閉 SELinux。只能將 sudo setenforce 0 當作 1 分鐘的測試:如果容器隨後能正常運作,表示是 SELinux 阻擋了它,但不一定是綁定掛載標籤造成的。請讀取拒絕記錄中的 tcontext= 欄位。如果該欄位是目錄的標籤,答案就是 :z。如果欄位指向裝置,通常應改用 policy boolean,例如將 X server 裝置掛載至容器時使用 sudo setsebool -P container_use_xserver_devices 1。請立即使用 sudo setenforce 1 恢復 enforcing。在 Enterprise Linux 上,綁定掛載中的 permission denied 有 2 個彼此獨立的原因;從容器內部看起來卻完全相同。其中一個是 SELinux 標籤,另一個是一般的數值使用者與群組擁有權,也就是 PUID 和 PGID 變數用來解決的問題。ls -lnZ 會在同一行顯示模式、數值擁有者與標籤,讓您判斷目前受哪一項限制。

為什麼 firewalld 看似已封閉,發布的埠卻仍可連線?

Firewalld 是 Rocky Linux 和 AlmaLinux 的預設防火牆。使用 sudo systemctl is-active firewalld 確認它正在執行。如果尚未在這台主機上設定 firewalld,請先使用 firewalld 開放 SSH 和 Web 埠,因為只有在已有可供比對的運作中 zone 規則集時,以下現象才有意義。現在發布一個埠,查看 firewalld 認為哪些項目已開放:

sudo docker run -d --name web -p 8080:80 nginx:alpine
sudo firewall-cmd --list-ports

firewall-cmd 會輸出空白行。在另一台機器上,curl -I http://YOUR_SERVER_IP:8080/ 會傳回 HTTP/1.1 200 OK。該埠可從網際網路連線,但防火牆沒有回報任何內容。

原因在於封包經過的路徑。Firewalld 的 zone 規則會篩選以這台主機為目的地的流量。發布的埠並不是以主機為目的地:Docker 會安裝目的地 NAT(網路位址轉譯)規則,在封包進入主機的 input 路徑前,將目的地改寫為容器的位址,因此 kernel 會轉送封包,而不是在本機交付。接著,Docker 會將 bridge 介面放入名為 docker 的 firewalld zone;該 zone 的 target 是 ACCEPT。Docker 也會加入名為 docker-forwarding 的 forwarding policy,允許從任何 zone 轉送至 docker zone。你的 zone 規則根本看不到這些封包。

最乾淨的修正方式是不新增防火牆規則。將發布的主機端繫結至 loopback,並在前方放置反向代理:

sudo docker rm -f web
sudo docker run -d --name web -p 127.0.0.1:8080:80 nginx:alpine
curl -I http://127.0.0.1:8080/

本機執行 curl 會傳回 HTTP/1.1 200 OK,而從另一台機器送出的相同請求則不再能建立連線。在 Docker 的預設設定中,不帶主機位址的 -p 引數會在所有介面上發布埠。例外情況是有人變更了 daemon 的預設繫結位址,例如在 /etc/docker/daemon.json 中設定 "ip": "127.0.0.1"。除非你確定這台主機曾如此設定,否則應將單獨的 -p 8080:80 視為公開暴露該服務的決定。

如果確實需要讓某些位址可以連線、其他位址無法連線,Docker 已預留一個 chain。DOCKER-USER 會在 Docker 自己的 accept 規則之前處理,因此放在其中的規則即使 Docker 重新啟動並重寫 chain,也能保留:

sudo iptables -I DOCKER-USER -i enp1s0 ! -s 203.0.113.10 -j DROP
sudo iptables -S DOCKER-USER

請從 ip route show default 取得介面名稱,不要假設是 eth0,因為目前的 EL 映像檔會使用 enp1s0 或 ens3 等名稱。在 Rocky 和 AlmaLinux 上,iptables command 是 nftables 上的相容層,Docker 的 chain 可透過它查看。以這種方式加入的規則會在重新開機後消失,除非你將其儲存。因此,確認規則無誤後,請將它們寫入 systemd unit。

2025 年發布的 Docker Engine 28.0 修補了相鄰的漏洞:現在,未發布的容器埠若透過路由直接存取,會在 DOCKER chain 中遭到封鎖。這項變更不影響已發布的埠,因此以上內容仍適用於目前版本。建議養成一項操作習慣:每次執行 sudo firewall-cmd --reload 後,重新測試已發布的埠。如果該埠停止回應,sudo systemctl restart docker 會重新安裝 Docker 的規則。

Ubuntu 管理員會透過不同工具遇到相同問題,請參閱為什麼已發布的 Docker 埠會忽略 ufw 規則。兩種情況的原因都是 NAT 路徑,只有前方的防火牆不同。

將非 root 使用者加入 docker 群組

在每個 docker 指令前輸入 sudo 會變得繁瑣,而加入 docker 群組可免除此需求:

sudo usermod -aG docker $USER
newgrp docker
docker run --rm hello-world

usermod -aG 會編輯 /etc/group,但您目前的 shell 已載入群組列表,因此變更需在開啟新 shell 後才會生效。newgrp docker 可啟動一個已掛載該群組的 shell,讓您立即進行測試。新的 SSH 連線則會自動套用變更。

請務必釐清該群組所賦予的權限。成員身分擁有對 /var/run/docker.sock 的寫入權限,而任何能與該 socket 通訊的程式,皆可要求 daemon 啟動一個掛載主機檔案系統的容器。以下指令展示了其含義:

docker run --rm -v /:/host alpine wc -l /host/etc/shadow

這能讓一個沒有 sudo 權限的帳號,讀取僅有 root 可存取的檔案。Docker 官方的安裝後說明文件也指出:docker 群組擁有等同於 root 的權限。僅在您願意給予該帳號 sudo 權限時,才將其加入此群組。若您正在設定新伺服器的帳號,請將此決策納入 VPS 最小權限使用者設定 的整體規劃中,而非事後才進行。

Docker 亦提供 rootless 模式,能以無特權使用者身分執行 daemon。這屬於獨立的安裝路徑,且會改變儲存驅動程式與 1024 以下連接埠的運作方式,因此請將其視為獨立的專案規劃,而非事後才添加的旗標。

後續步驟

您現在已具備引擎、compose 外掛程式、可隨開機自動啟動的服務,以及上述針對 EL 發行版的三種特定行為。下一步是為每個服務建立 compose.yaml,而 Compose 檔案結構 涵蓋了檔案格式與驅動它的指令。若這是您首次架設容器主機,在 VPS 上執行 Docker 涵蓋了本指南未提及的資源配置、儲存空間與映像檔維護等問題。

FAQ

Docker 的 CentOS 套件庫能在 Rocky Linux 和 AlmaLinux 上運作嗎?

可以。使用 dnf config-manager 新增 https://download.docker.com/linux/centos/docker-ce.repo。該檔案中的 baseurl 包含 $releasever,而 Rocky Linux 和 AlmaLinux 會將其展開為主要版本號,因此 EL 9 系統會解析至 CentOS 9 樹狀目錄,EL 10 系統則會解析至 CentOS 10 樹狀目錄。使用 sudo dnf repoinfo docker-ce-stable 確認展開結果,並讀取 Repo-baseurl 行。如果該行顯示 9.6 這類次要版本,而 dnf 擷取中繼資料時回報 Status code: 404,將 /etc/yum.repos.d/docker-ce.repo 編輯為使用純主要版本號即可修正。如果該行已顯示主要版本號,則 404 有其他原因,例如套件庫中繼資料不一致或基礎 URL 錯誤;編輯該變數無法解決問題。

Docker 和 podman 可以安裝在同一台伺服器上嗎?

Docker 的文件將 podman 和 runc 列為衝突套件,並要求在安裝 Docker Engine 前移除兩者。實際衝突的是 podman-docker 套件;該套件擁有 /usr/bin/docker,並將每個 docker 命令轉換為 podman 命令。執行 rpm -qf "$(command -v docker)" 查看哪個套件擁有該路徑。如果輸出以 podman-docker 開頭,表示是 podman 在回應。Docker 不支援同時保留兩個引擎,因此在重要的伺服器上應選擇其中一個。

為什麼我的容器在 bind mount 上收到 permission denied?

Rocky Linux 和 AlmaLinux 預設會強制啟用 SELinux;Docker 的 selinux-enabled 設定啟用後,容器會以 container_t 類型執行。該類型無法存取一般主機目錄所使用的通用標籤,因此即使目錄的擁有者和權限模式正確,仍會遭到拒絕。使用主機上的 ls -ldZ 和 sudo ausearch -m avc -ts recent 進行確認;後者會列印包含兩個不相符內容的 avc: denied。對於容器之間共用的內容,將 :z 加入 volume 參數;對於僅供單一容器使用的內容,則加入 :Z。絕不要讓 :Z 指向 /home 或 /usr,因為重新標籤會遞迴執行,並導致主機故障。

發布容器埠時,需要在 firewalld 中開放埠嗎?

不需要,而這正是問題所在。Docker 的 NAT 規則會在封包抵達主機輸入路徑前改寫目的位址,因此 firewalld 的區域規則不會檢查該封包。Docker 也會將其 bridge 放入名為 docker、target 為 ACCEPT 的 firewalld 區域。使用 -p 8080:80 啟動的容器可從網際網路連線,即使 sudo firewall-cmd --list-ports 沒有輸出。若只有主機應能連線至服務,請使用 -p 127.0.0.1:8080:80 發布至特定位址;或者將過濾規則插入 DOCKER-USER chain,Docker 會在自己的 accept 規則前處理該 chain。

將我的使用者加入 docker 群組安全嗎?

這會授予 root 權限。docker 群組成員可以寫入 /var/run/docker.sock,而 docker run --rm -v /:/host alpine wc -l /host/etc/shadow 接著會以沒有 sudo 權限的帳戶讀取僅限 root 存取的檔案。Docker 的安裝後文件也明確說明兩者具有相同的權限等價性。僅將原本就願意授予 sudo 權限的帳戶加入該群組;共用帳戶或服務帳戶則繼續使用 sudo docker。如果需要讓非特權使用者執行容器,rootless mode 是替代方案;它是獨立的安裝路徑,而不是一項設定。

這篇文章對您有幫助嗎?