Linux CentOS 系统 Docker 完整安装部署文档

一、环境说明

• 系统版本：CentOS 7 / Rocky Linux 7 系列（适配本次安装流程）

• 安装方式：YUM 国内镜像源安装（规避国外源网络问题）

• 文档包含：Docker安装、国内镜像加速、开机自启、免sudo配置、安装验证、常用命令、故障排查

二、前置准备

1. 登录权限：需使用服务器 root 账号操作（权限足够，避免安装报错）

2. 网络要求：服务器可正常访问外网（用于下载Docker组件及镜像）

3. 旧版说明：若执行卸载旧版Docker命令提示“无匹配包”，属于正常现象，无需额外处理

三、详细安装步骤

3.1 安装依赖工具

执行以下命令，安装Docker安装所需的依赖组件，确保后续安装顺利：

yum install -y yum-utils device-mapper-persistent-data lvm2

3.2 配置国内YUM源（关键步骤）

抛弃Docker官方国外源（避免出现“TCP connection reset by peer”连接失败问题），替换为阿里云国内YUM源，提升下载速度和稳定性：

yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

3.3 安装Docker核心组件

安装Docker CE（社区版）及相关核心组件，执行命令后自动完成下载和安装：

yum install -y docker-ce docker-ce-cli containerd.io

3.4 启动Docker并设置开机自启

安装完成后，启动Docker服务，并配置开机自启（避免服务器重启后Docker失效）：

systemctl start docker
systemctl enable docker

四、国内镜像加速配置

为解决Docker拉取镜像慢、超时问题，配置多组优质国内镜像源，无需额外注册，直接复制执行即可：

# 创建Docker配置目录（若不存在则自动创建）
mkdir -p /etc/docker

# 写入镜像加速配置到daemon.json文件
tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.xuanyuan.me",
    "https://docker.1ms.run",
    "https://hub-mirror.c.163.com",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}
EOF

4.1 重启Docker使配置生效

配置完成后，需重启Docker服务，才能让镜像加速配置生效：

systemctl daemon-reload
systemctl restart docker

五、免sudo使用Docker配置

默认情况下，普通用户使用Docker命令需加 sudo，执行以下命令可实现普通用户免sudo操作Docker：

usermod -aG docker $USER

注意：配置后需退出当前终端，重新登录，配置才能生效。生效后，普通用户可直接使用 docker 命令，无需额外加 sudo。

六、安装验证（必做）

通过以下3步验证Docker是否安装成功、配置生效：

6.1 查看Docker版本

docker -v

输出格式示例：Docker version 26\.1\.4, build 5650f9b，说明Docker安装成功。

6.2 测试运行HelloWorld镜像

docker run hello-world

若输出 Hello from Docker\! 相关内容，说明Docker可正常拉取、运行镜像，安装完全正常。

6.3 验证镜像加速是否生效

docker info

查看输出内容中“Registry Mirrors”字段，若显示配置的4个国内镜像地址，说明镜像加速配置生效。

七、Docker常用系统命令（备查）

# 查看Docker运行状态
systemctl status docker

# 重启Docker服务
systemctl restart docker

# 停止Docker服务
systemctl stop docker

# 关闭Docker开机自启
systemctl disable docker

# 查看Docker详细信息（含镜像源、容器、镜像等）
docker info

# 查看已拉取的镜像
docker images

# 查看正在运行的容器
docker ps

# 停止指定容器（替换container_id为实际容器ID）
docker stop container_id

八、常见故障说明及解决方法

8.1 卸载旧版提示“No Packages marked for removal”

原因：服务器原本未安装过Docker旧版本，属于正常现象，无需任何处理，直接继续后续安装步骤即可。

8.2 安装时出现“TCP connection reset by peer”

原因：使用Docker官方国外源，国内网络拦截导致连接失败。

解决方法：重新执行“3.2 配置国内YUM源”步骤，替换为阿里云国内源后，再重新安装Docker。

8.3 镜像拉取慢、超时

原因：未配置国内镜像加速，或镜像源不稳定。

解决方法：确认“四、国内镜像加速配置”步骤已执行，重启Docker后再次尝试拉取镜像；若仍有问题，可更换镜像源列表中的地址。

九、注意事项

• 全程需使用 root 账号操作，普通用户无足够权限完成安装和配置。

• 镜像加速配置后，必须重启Docker才能生效，否则配置不生效。

• 若服务器有防火墙，无需额外开放端口（Docker默认端口无需手动配置）。

• 后续若需升级Docker，可直接执行 yum update docker\-ce 命令，无需重新安装。