Rocky Linux 和 AlmaLinux 安装 Docker 指南
使用 dnf 从 Docker 官方仓库安装 Docker Engine 和 Compose 插件,解决 Podman 占用 docker 命令、SELinux 阻止绑定挂载,以及 Firewalld 未过滤容器端口等问题。
在 Rocky Linux 和 AlmaLinux 上安装 Docker
要在 Rocky Linux 或 AlmaLinux 上安装 Docker,请添加 Docker 自己的 dnf 软件仓库,安装包含 Compose 插件的引擎,然后启用该服务。整个过程只需四条命令。由于这两个发行版都是 Red Hat Enterprise Linux (RHEL) 的重构版本,并且共用其软件包布局,因此安装方式完全相同。CentOS Stream 的操作方式也相同。以下内容同时适用于这两个发行版。因此,如果您仍在二者之间选择,决定因素是各项目作出的兼容性承诺,以及您的旧 CPU 是否仍受支持。
安装过程很短,因此本指南的大部分内容都介绍 Enterprise Linux (EL) 与 Ubuntu 的不同之处。您的镜像可能已经将 docker 命令交由 Podman 管理。只有启用 Docker 的 SELinux 支持后,SELinux 才会限制容器;启用后,它会阻止访问绑定挂载的文件,除非这些文件带有正确的标签。Firewalld 不会过滤 Docker 发布的端口,因此容器端口可能已经对互联网开放,而 firewall-cmd 却报告没有开放端口。
不要使用来自 get.docker.com 的 Docker 便捷安装脚本。Docker 官方文档说明不建议在生产环境中使用该脚本。它会在不询问的情况下重写软件仓库配置,而且无法安全地重复运行来执行升级。手动添加软件仓库后,dnf upgrade 会像管理系统中的其他软件包一样管理 Docker。这样,如果您配置了定时应用安全更新,Docker 引擎也会纳入 dnf-automatic 的更新范围。因此应尽早决定是让 Docker 自动安装补丁,还是在维护窗口内暂缓更新。无论采用哪种方式,升级都会替换软件包中的二进制文件,但旧的 dockerd 仍会继续运行;needs-restarting 命令可以告诉您哪些服务仍在运行刚刚被替换的代码。
podman 是否已经响应 docker 命令?
Rocky Linux 和 AlmaLinux 的默认软件仓库中都提供 podman,许多 VPS 镜像还会为您预先安装它。有些镜像更进一步安装 podman-docker,它会在 /usr/bin/docker 放置一个调用 podman 的 shell 脚本。此后,您输入的每个 docker 命令实际上都会运行 podman,因此按照 Docker 编写的指南执行时,输出可能与预期不同。
最初的迹象是启动提示。/usr/bin/docker 脚本会在 /etc/containers 和您自己的 ~/.config/containers 目录中查找名为 nodocker 的文件;如果设置了 $XDG_CONFIG_HOME,则也会在该目录下查找。如果两个文件都不存在,它会在执行任何操作前输出一行:
Emulate Docker CLI using podman. Create /etc/containers/nodocker to quiet msg.有人可能创建了其中一个文件来隐藏启动提示,因此不要只依赖这一点。使用软件包数据库查询哪个软件包拥有该二进制文件:
command -v docker
rpm -qf "$(command -v docker)"以 podman-docker 开头的结果表示 podman 正在响应。以 docker-ce-cli 开头的结果表示使用的是真正的 Docker。如果 rpm -qf 报告没有软件包拥有该文件,说明有人手动安装了它;在信任该文件前,应先阅读脚本内容。
Podman 运行相同的 OCI 镜像,是一个合理的选择。如果您决定使用它,可以在此停止。如果平台选择尚未确定,值得注意的是,FreeBSD jail 隔离完整的用户空间,而不是运行从注册表拉取的分层镜像。如果您要使用 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 软件源树,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.repodnf 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 软件包展开此变量。Rocky Linux 和 AlmaLinux 会将其设置为主版本号,因此 EL 9 中的值为 9,EL 10 中的值为 10。这就是 CentOS 软件源能在 Rocky 主机上正确解析的原因。安装前先确认展开结果:
sudo dnf repoinfo docker-ce-stable查看 Repo-baseurl 行。该行应以 /9/x86_64/stable 或 /10/x86_64/stable 结尾。如果您的发行版将 $releasever 设置为类似 9.6 的次版本号,该行会显示为 /9.6/,dnf 获取元数据时会针对该 URL 报告 Status code: 404。请编辑 /etc/yum.repos.d/docker-ce.repo,将 $releasever 替换为不带其他内容的主版本号。单凭 404 不能证明就是此问题。Red Hat 列出了导致相同错误的其他原因,包括软件源元数据不一致和基础 URL 错误,因此只有在 Repo-baseurl 确实显示次版本号时才进行修改。如果该行已经以主版本号结尾,替换变量不会产生任何变化。
安装引擎和 Compose 插件
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 驱动的容器运行时。docker-buildx-plugin 用于构建镜像。docker-compose-plugin 通过子命令提供 docker compose。
这些软件包不会安装带连字符的 docker-compose 二进制文件。那是 Compose v1 的用法;Compose v2 普遍可用后,Docker 已宣布 Compose v1 终止生命周期。任何使用带连字符的 docker-compose 的调用,都需要改为使用带空格的 docker compose。
首次安装会暂停以导入 Docker 的签名密钥,并显示密钥指纹。该密钥来自您刚添加的仓库文件中的 gpgkey=https://download.docker.com/linux/centos/gpg,因此在接受密钥前,请将 dnf 显示的指纹与该 URL 中的指纹进行比较。
有一种失败情况经常出现,值得单独说明。如果 dnf 报告 containerd.io 需要 container-selinux,但没有任何软件包提供该依赖项,说明您的 AppStream 仓库已禁用。运行 dnf repolist,并确认列表中包含 appstream,因为在 EL 9 和 EL 10 上,container-selinux 由该仓库提供。
启动 Docker 并确认其正常运行
sudo systemctl enable --now docker
sudo systemctl status docker --no-pager
sudo docker run --rm hello-worldDocker 的 RPM 软件包安装后不会自动启动或启用 daemon。因此,Docker 的 CentOS 页面包含此步骤,而 Ubuntu 页面没有;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 插件,因为它属于不同的软件包。即使引擎正常运行,该插件也可能缺失:
docker compose version在全新安装中,正常结果应类似于 Docker Compose version v5.7.0。这是 Docker 的 EL 9 软件仓库截至 10 November 2026 提供的版本。不要因版本号从 v2 跳到 v5 而感到困惑。Docker 于 2025 年发布了 Compose v5,其功能与 v2 完全相同,并跳过中间版本号,以避免与标记为 v2 和 v3 的旧版 Compose 文件格式混淆。Docker 同时支持 Compose v2 和 Compose v5,因此,旧服务器返回 v2.x.x 仍表示运行正常,而 dnf upgrade 可将其升级到 v5。重启后恢复服务与启用 daemon 是两个不同的问题;重启策略决定 Compose 服务是否会在启动时恢复。
为什么 bind mount 会出现 permission denied?
Rocky Linux 和 AlmaLinux 默认以 enforcing 模式运行 SELinux(Security-Enhanced Linux)。使用 getenforce 确认,该命令会输出 Enforcing。
主机上的 SELinux 强制执行本身不会限制 Docker 容器。Docker 的 SELinux 支持由 daemon 设置 selinux-enabled 控制,该设置默认关闭,docker-ce 软件包也不会启用它。关闭时,容器以 spc_t 启动,这是一个不受限制的类型。因此,bind mount 无需任何标签即可工作,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使用两个命令即可查看原因。ls -ldZ /srv/site 输出标签。对于 /srv 下的路径,其标签是 system_u:object_r:var_t:s0,而不是 container_file_t。然后,sudo ausearch -m avc -ts recent 输出内核的审计记录,其中包含 avc: denied { read }、用于标识 container_t 的 scontext= 字段,以及用于标识刚才看到的目录标签的 tcontext= 字段。这两个字段不匹配,就是全部原因。
修复方法是在卷参数后添加后缀。Docker 会为路径重新标记:
sudo docker run --rm -v /srv/site:/usr/share/nginx/html:ro,z nginx:alpine cat /usr/share/nginx/html/index.html小写的 :z 会将内容重新标记为共享类型,因此多个容器可以使用同一目录。大写的 :Z 会将内容重新标记为私有且不共享,并绑定到一个容器;此时,第二个容器读取同一路径会被拒绝。凡是 sidecar 或备份容器也会访问的目录,都使用 :z。由一个容器独占的数据库目录,使用 :Z。
Docker 文档中有一条值得重复的警告,因为重新标记会递归执行。使用 :Z bind mount 系统目录,例如 /home 或 /usr,会“使主机无法运行,您可能需要手动重新标记主机文件”。这些后缀只能用于为容器创建的目录,绝不要用于系统路径。
在 Compose 中,后缀添加到同一个字符串中:
services:
web:
image: nginx:alpine
volumes:
- /srv/site:/usr/share/nginx/html:ro,z有两个限制很容易触发。--mount 标志完全不能设置 SELinux 标签,因此需要设置标签时应使用 -v。命名卷不需要后缀,因为 Docker 会自动为它在 /var/lib/docker/volumes 下创建的目录设置标签。
不要关闭 SELinux。sudo setenforce 0 只能作为一分钟的测试:如果容器随后可以运行,说明是 SELinux 阻止了它,但不一定是 bind mount 标签导致的。查看拒绝记录中的 tcontext= 字段。如果该字段是目录标签,答案就是 :z。如果其中标识的是设备,通常应改用策略布尔值,例如将 X server 设备挂载到容器时使用 sudo setsebool -P container_use_xserver_devices 1。立即使用 sudo setenforce 1 恢复 enforcing 模式。在 Enterprise Linux 上,bind mount 的 permission denied 有两个彼此独立的原因,而从容器内部看起来完全相同。一个是 SELinux 标签。另一个是普通的数字用户和组所有权,这正是 PUID 和 PGID 变量要解决的问题。ls -lnZ 会在一行中显示权限模式、数字所有者和标签,因此您可以判断当前遇到的是哪一种问题。
为什么已发布的端口在 firewalld 看似关闭时仍可访问?
Firewalld 是 Rocky Linux 和 AlmaLinux 的默认防火墙。使用 sudo systemctl is-active firewalld 检查其是否正在运行。如果尚未在此主机上配置 firewalld,应先使用 firewalld 放行 SSH 和 Web 端口,因为只有存在可供比较的有效区域规则集后,下面的现象才有意义。现在发布一个端口,然后查看 firewalld 认为哪些端口已开放:
sudo docker run -d --name web -p 8080:80 nginx:alpine
sudo firewall-cmd --list-portsfirewall-cmd 输出空行。在另一台机器上,curl -I http://YOUR_SERVER_IP:8080/ 返回 HTTP/1.1 200 OK。该端口可以从互联网访问,但防火墙没有报告任何开放端口。
原因在于数据包经过的路径。Firewalld 的区域规则会过滤目标为主机自身的流量。已发布的端口并不以主机为目标:Docker 会安装目标 NAT(网络地址转换)规则,在数据包到达主机输入路径之前,将目标地址改写为容器地址。因此,内核会转发该数据包,而不是在本地交付。随后,Docker 会将其网桥接口放入名为 docker 的 firewalld 区域,该区域的目标为 ACCEPT,并添加名为 docker-forwarding 的转发策略,允许从任意区域向 docker 区域转发。你的区域规则根本看不到该数据包。
最简洁的修复方法是不添加防火墙规则。将发布端的主机地址绑定到 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 为此预留了一个链。DOCKER-USER 会在 Docker 自身的 accept 规则之前处理,因此放置在其中的规则在 Docker 重启并重写链后仍会保留:
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 命令是 nftables 的兼容层,Docker 的链可以通过该命令查看。通过这种方式添加的规则会在重启后丢失,除非将其保存。因此,确认规则无误后,应将其写入 systemd 单元。
2025 年发布的 Docker Engine 28.0 修复了相邻的一处漏洞:现在,未发布的容器端口无法再通过直接路由访问,相关限制位于 DOCKER 链中。该变更不影响已发布的端口,因此上述内容仍适用于当前版本。应养成一个运维习惯:每次执行 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-worldusermod -aG 会修改 /etc/group,但当前 shell 已经加载了自己的组列表,因此新组不会立即生效。newgrp docker 会启动一个附加了该组的新 shell,您可以立即测试。新的 SSH 会话会自动加载该组。
请明确该组授予的权限。加入该组后,用户可以写入 /var/run/docker.sock;任何可以访问该套接字的程序,都可以请求 daemon 启动一个挂载主机文件系统的容器。以下命令可以直接说明这意味着什么:
docker run --rm -v /:/host alpine wc -l /host/etc/shadow该命令会以没有 sudo 权限的账户读取只有 root 才能读取的文件。Docker 自己的安装后文档也说明了这一点:docker 组授予的权限等同于 root。只有在您也愿意向该账户授予 sudo 时,才应将其添加到该组。如果您正在新服务器上配置账户,应将此决定与 VPS 上的最小权限用户配置 一并考虑,而不是事后再处理。
Docker 还提供 rootless 模式,可由非特权用户运行 daemon。它使用独立的安装路径,并会改变存储驱动以及低于 1024 的端口的行为。因此,应将其作为独立项目规划,而不是之后再添加的一个标志。
下一步
现在,您已经拥有 Docker 引擎、Compose 插件、一个可在重启后继续运行的服务,以及上文记录的 3 项 EL 特定行为。下一步是为每个服务创建一个 compose.yaml;Compose 文件的结构介绍文件格式及用于操作该文件的命令。如果这是您的第一台容器主机,在 VPS 上运行 Docker将介绍本指南未涵盖的规格、存储和镜像维护问题。
FAQ
Docker 的 CentOS 软件源能在 Rocky Linux 和 AlmaLinux 上运行吗?
可以。添加 https://download.docker.com/linux/centos/docker-ce.repo,并使用 dnf config-manager。该文件中的 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 不支持同时保留这两个引擎。因此,在重要的服务器上应选择其中一个。
为什么容器在绑定挂载上收到 permission denied?
Rocky Linux 和 AlmaLinux 默认启用 SELinux 强制模式。Docker 的 selinux-enabled 设置启用后(默认关闭),容器会以 container_t 类型运行。该类型无法访问普通主机目录使用的通用标签。因此,无论目录的所有者和权限模式是什么,容器都无法访问您创建的目录。对主机路径运行 ls -ldZ,并运行 sudo ausearch -m avc -ts recent 进行确认;后者会以 avc: denied 格式显示两个不匹配的上下文。对于容器之间共享的内容,在卷参数中添加 :z;对于仅供单个容器使用的内容,添加 :Z。不要将 :Z 指向 /home 或 /usr,因为重新标记会递归执行,并会破坏主机。
发布容器端口时,需要在 firewalld 中开放端口吗?
不需要,而这正是问题所在。Docker 的 NAT 规则会在数据包到达主机输入路径之前重写目标地址,因此 firewalld 的区域规则不会检查该数据包。Docker 还会将其网桥加入名为 docker、目标为 ACCEPT 的 firewalld 区域。使用 -p 8080:80 启动的容器可以从互联网访问,而 sudo firewall-cmd --list-ports 不会输出任何内容。仅允许主机访问服务时,使用 -p 127.0.0.1:8080:80 将端口发布到指定地址。也可以将过滤规则插入 DOCKER-USER 链,因为 Docker 会在处理自己的 accept 规则之前处理该链。
将我的用户加入 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 模式。它是独立的安装路径,而不是一个设置。