引言
Rocky Linux作为CentOS的稳定替代品，在企业级服务器环境中越来越受欢迎。Docker作为容器化技术的领导者，在Rocky Linux上的部署相对直接，但版本兼容性和配置细节可能导致问题。本文将详细介绍在Rocky Linux 9.x版本上快速部署Docker环境的完整流程，包括Docker Engine、Docker Compose的安装，以及常见安装问题的诊断与解决方案。我们将使用官方推荐的Docker仓库进行安装，确保安全性和稳定性。
系统准备
在开始安装Docker之前，确保您的Rocky Linux系统满足以下条件：
系统版本
：Rocky Linux 8.x或9.x（推荐9.x以获得最新支持）。
权限
：拥有sudo权限的用户或root用户。
网络连接
：稳定的互联网连接以下载软件包。
系统更新
：运行以下命令更新系统包：
sudo dnf update -y
卸载旧版本
（如果存在）：旧版Docker可能导致冲突，运行以下命令卸载：
sudo dnf remove docker \
docker-client \
docker-client-latest \
docker-common \
docker-latest \
docker-latest-logrotate \
docker-logrotate \
docker-engine
这些准备步骤确保系统干净，避免潜在的包冲突。
安装Docker Engine
Rocky Linux官方仓库不包含最新Docker版本，因此推荐使用Docker官方仓库安装。以下是详细步骤：
步骤1: 设置Docker仓库
首先，安装必要的工具并添加Docker的GPG密钥：
# 安装dnf插件以管理仓库
sudo dnf install -y dnf-utils
# 添加Docker官方仓库（稳定版）
sudo dnf config-manager –add-repo https://download.docker.com/linux/centos/docker-ce.repo
这会创建一个
/etc/yum.repos.d/docker-ce.repo
文件，指向Docker的CentOS仓库（Rocky Linux兼容）。
步骤2: 安装Docker Engine
运行以下命令安装Docker组件：
# 安装Docker Engine、CLI、容器运行时和相关工具
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker-ce
：Docker社区版引擎。
docker-ce-cli
：Docker命令行工具。
containerd.io
：容器运行时。
docker-buildx-plugin
和
docker-compose-plugin
：用于构建和编排的插件（包含Docker Compose v2）。
安装过程会自动处理依赖，如
libcgroup
和
iptables
。
步骤3: 启动并启用Docker服务
安装完成后，启动Docker并设置开机自启：
# 启动Docker服务
sudo systemctl start docker
# 启用开机自启
sudo systemctl enable docker
# 验证服务状态
sudo systemctl status docker
输出应显示
active (running)
，表示服务正常运行。
步骤4: 验证安装
运行以下命令验证Docker是否正确安装：
# 检查Docker版本
docker –version
# 运行测试容器（Hello World）
sudo docker run hello-world
如果成功，您将看到一条欢迎消息，确认Docker可以拉取镜像并运行容器。
安装Docker Compose
Docker Compose用于定义和运行多容器应用。Docker Compose v2已集成到Docker CLI中（通过
docker compose
命令），但如果您需要独立的v1版本，可单独安装。推荐使用v2，它已包含在上述安装中。验证Compose：
# 检查Docker Compose版本
docker compose version
如果未安装，手动安装v2插件：
sudo dnf install -y docker-compose-plugin
对于v1（不推荐，除非特定需求）：
# 下载并安装（作为备用）
sudo curl -L “https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)” -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose –version
配置用户权限
默认情况下，运行Docker命令需要sudo。为避免每次输入密码，将用户添加到
docker
组：
# 将当前用户添加到docker组
sudo usermod -aG docker $USER
# 重新登录或运行以下命令使更改生效
newgrp docker
注意
：此更改仅对新会话生效。测试权限：
docker run hello-world # 无需sudo
如果仍需sudo，检查
/etc/group
中用户是否已添加。
常见安装问题及解决方案
安装过程中可能遇到各种问题，以下是Rocky Linux特有或常见问题的诊断与修复。每个问题包括症状、原因和详细解决方案。
问题1: 仓库添加失败或GPG密钥错误
症状
：运行
sudo dnf config-manager –add-repo
时出现错误如“Cannot add repo”或“GPG key retrieval failed”。
原因
：网络问题、防火墙阻挡，或dnf-utils未安装。
解决方案
：
确保dnf-utils已安装：
sudo dnf install -y dnf-utils
。
手动下载并导入GPG密钥：
sudo rpm –import https://download.docker.com/linux/centos/gpg
如果网络受限，检查防火墙：
sudo firewall-cmd –list-all # 查看防火墙规则
sudo firewall-cmd –add-service=https –permanent # 允许HTTPS
sudo firewall-cmd –reload
测试网络连通性：
curl -I https://download.docker.com
。
问题2: 安装包冲突或依赖错误
症状
：
sudo dnf install docker-ce
时出现“Error: Package: docker-ce-… requires …”或与Podman冲突（Rocky Linux默认包含Podman）。
原因
：Rocky Linux的AppStream仓库包含旧版容器工具，导致依赖冲突。
解决方案
：
排除冲突包：
sudo dnf install -y docker-ce –allowerasing
–allowerasing
允许替换冲突包。
如果Podman冲突，卸载它（可选，如果不需要）：
sudo dnf remove podman
清理缓存并重试：
sudo dnf clean all
sudo dnf makecache
sudo dnf install -y docker-ce docker-ce-cli containerd.io
检查SELinux状态（见问题4）。
问题3: Docker服务启动失败
症状
：
sudo systemctl start docker
失败，
systemctl status docker
显示错误如“Failed to start Docker Application Container Engine”。
原因
：常见于cgroup v2配置、端口冲突或缺少内核模块。
解决方案
：
检查日志：
sudo journalctl -u docker -f
或
sudo docker daemon –debug
（调试模式）。
对于cgroup v2问题（Rocky 9默认启用），编辑
/etc/default/grub
：
sudo nano /etc/default/grub
添加
systemd.unified_cgroup_hierarchy=0
到GRUB_CMDLINE_LINUX，然后：
sudo grub2-mkconfig -o /boot/grub2/grub.cfg
sudo reboot
确保内核模块加载：
sudo modprobe overlay
sudo modprobe br_netfilter
echo ‘overlay’ | sudo tee -a /etc/modules-load.d/docker.conf
echo ‘br_netfilter’ | sudo tee -a /etc/modules-load.d/docker.conf
重启服务：
sudo systemctl restart docker
。
问题4: SELinux相关错误
症状
：运行容器时出现“permission denied”或SELinux AVC拒绝日志。
原因
：Rocky Linux默认启用SELinux，可能阻止Docker访问文件系统。
解决方案
：
临时禁用SELinux测试（不推荐生产）：
sudo setenforce 0
sudo systemctl restart docker
永久配置SELinux模式为permissive：
sudo sed -i ‘s/SELINUX=enforcing/SELINUX=permissive/’ /etc/selinux/config
sudo setenforce 0
sudo reboot
或者安装SELinux策略模块：
sudo dnf install -y container-selinux
sudo restorecon -R /var/lib/docker
验证：
sestatus
应显示
Current mode: permissive
。
问题5: 磁盘空间或权限不足
症状
：
docker run
失败，显示“no space left on device”或“permission denied”。
原因
：/var/lib/docker目录空间不足或权限错误。
解决方案
：
检查磁盘：
df -h /var/lib/docker
。
清理未使用资源：
sudo docker system prune -a # 删除所有未用镜像、容器、卷
更改Docker存储位置（可选，如果空间不足）：
编辑
/etc/docker/daemon.json
（创建如果不存在）：
{
“data-root”: “/path/to/new/docker/dir”
}
然后重启Docker：
sudo systemctl restart docker
。
修复权限：
sudo chown -R root:docker /var/lib/docker
。
问题6: 网络或代理问题
症状
：拉取镜像超时或“connection refused”。
原因
：企业网络代理或防火墙。
解决方案
：
配置Docker代理：
创建
/etc/systemd/system/docker.service.d/http-proxy.conf
：
[Service]
Environment=”HTTP_PROXY=http://proxy.example.com:8080″
Environment=”HTTPS_PROXY=http://proxy.example.com:8080″
Environment=”NO_PROXY=localhost,127.0.0.1″
重载systemd：
sudo systemctl daemon-reload && sudo systemctl restart docker
。
测试DNS：
nslookup registry-1.docker.io
。
如果使用云实例，检查安全组规则允许出站流量。
高级配置与最佳实践
加速镜像拉取
：配置国内镜像源（如阿里云）：
编辑
/etc/docker/daemon.json
：
{
“registry-mirrors”: [“https://
}
重启Docker。
日志管理
：配置日志驱动以避免磁盘满：
在daemon.json中添加：
{
“log-driver”: “json-file”,
“log-opts”: {“max-size”: “10m”, “max-file”: “3”}
}
安全最佳实践
：避免以root运行容器，使用
–user
标志；定期更新Docker：
sudo dnf update docker-ce
。
监控
：安装
docker stats
或使用Prometheus监控容器。
结论
通过以上步骤，您可以在Rocky Linux上快速部署一个功能齐全的Docker环境。整个过程通常在10-15分钟内完成。如果遇到问题，优先检查日志和系统兼容性。Rocky Linux的稳定性使它成为Docker的理想宿主机，但对于生产环境，始终测试在非关键系统上。参考Docker官方文档（docs.docker.com）获取最新更新。如果您有特定错误日志，可进一步诊断。