Linux 一键安装 Docker 脚本使用指南

ZhangCurry2026-01-232026-01-23

Linux 一键安装 Docker 脚本使用指南

脚本版本 1.0.0 | 默认安装 Docker 27.5.0 | 最后更新 2026-02-16

这个脚本是在管理多台服务器时写的，目的是把每次安装 Docker 都要重复的操作自动化——选版本、配镜像加速、改 daemon.json、设开机自启，一次配好，以后所有机器都用同一套。

系统要求与兼容性

支持的 Linux 发行版

Linux 发行版	支持版本	包管理器	推荐度
Ubuntu	20.04 / 22.04 / 24.04	apt	⭐⭐⭐⭐⭐
Debian	11 (Bullseye) / 12 (Bookworm)	apt	⭐⭐⭐⭐⭐
CentOS	7 / 8 / 9	yum	⭐⭐⭐⭐
RHEL	8 / 9	yum	⭐⭐⭐⭐
Rocky Linux	8 / 9	yum	⭐⭐⭐⭐
AlmaLinux	8 / 9	yum	⭐⭐⭐⭐
Fedora	38 / 39	dnf	⭐⭐⭐⭐

Ubuntu、Debian 和 CentosOS 的测试最充分，如果没有特殊原因，新机器优先用这三个发行版。

支持的系统架构

x86_64 (AMD64)

— 绝大多数云服务器和物理机
ARM64 (aarch64)

— ARM 服务器、树莓派 4
ARMv7

— 树莓派 3 等旧款 ARM 设备

脚本会自动检测架构并下载对应版本，不需要手动指定。

硬件最低要求

CPU：1 核心
内存：1GB（推荐 2GB 以上）
磁盘：5GB 可用空间（推荐 20GB 以上，用于存镜像）
网络：需要能访问外网

权限要求

必须以 root 权限运行，没有例外：

1	sudo bash install-docker-linux.sh

直接用普通用户跑会在第一步就报错退出，脚本不会做任何修改。

功能特性

智能环境检测

脚本启动后先做一轮环境检查，通不过就停下来告诉你哪里有问题：

自动识别 Linux 发行版（Ubuntu/CentOS/Debian 等）和版本号
检测 CPU 架构，选对应的安装包
测试国内外网络连通性
检查磁盘剩余空间（要求至少 5GB）
检测是否已安装 Docker，有的话让你选处理方式

版本管理

默认安装 Docker 27.5.0（当前最新稳定版）
支持通过 --version 参数指定任意版本
交互式选择时会列出常用版本供参考
可以查询当前系统的所有可用版本

检测到系统已有 Docker 时，脚本提供 4 种选择：

卸载并重新安装

— 彻底清理后重装，适合出问题想重来
保持现有版本

— 跳过安装，什么都不动
升级到指定版本

— 保留数据和卷，只换二进制
退出脚本

— 不做任何操作

选择卸载时还会问要不要保留 /var/lib/docker 里的镜像和容器数据。

自动配置优化

安装完成后脚本会生成一份调优过的 daemon.json，包括：

配置 5 个国内镜像加速源（拉镜像速度差异巨大，这个必须配）
日志文件大小限制（不配的话日志文件会无限涨）
overlay2 存储驱动
live-restore 开启（Docker 重启时容器不中断）
关闭 userland-proxy（用 iptables 转发，性能更好）
文件描述符限制调到 64000

具体配置内容见下文 daemon.json 配置说明。

用户权限

脚本会自动把当前用户加入 docker 组，装完之后执行一次 newgrp docker 或重新登录，就不需要每次加 sudo 了。

安装日志

所有操作都会写入 /var/log/docker-install/ 目录，出问题了可以去那里找详细的安装过程记录。

错误处理

脚本开了 set -e，任何步骤失败都会立即停止执行，不会让一半安装的状态留在系统里。失败时会显示出错的行号和建议的修复方法。

安装验证

安装完成后执行 6 项验证：

docker
1
2
3
4
5
6
7
8
9

    命令是否可用

2. 版本信息是否正确

3. Docker 服务是否正在运行

4. ```
   docker info


 系统信息获取

运行 hello-world 测试容器
Docker Compose 是否可用

使用方法

CentOS系统安装实测

[root@VM-8-2-centos ~]# wget https://gitee.com/haonuli/itinstall-script/raw/main/install-docker-linux.sh
--2026-02-25 15:00:37--  https://gitee.com/haonuli/itinstall-script/raw/main/install-docker-linux.sh
Resolving gitee.com (gitee.com)... 180.76.199.13
Connecting to gitee.com (gitee.com)|180.76.199.13|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: unspecified [text/plain]
Saving to: ‘install-docker-linux.sh’

    [ <=>                                                                                                                                                                                                          ] 42,888      --.-K/s   in 0.01s   

2026-02-25 15:00:37 (2.77 MB/s) - ‘install-docker-linux.sh’ saved [42888]

[root@VM-8-2-centos ~]# ll
total 44
-rw-r--r-- 1 root root 42888 Feb 25 15:00 install-docker-linux.sh
[root@VM-8-2-centos ~]# chmod +x install-docker-linux.sh 
[root@VM-8-2-centos ~]# ll
total 44
-rwxr-xr-x 1 root root 42888 Feb 25 15:00 install-docker-linux.sh
[root@VM-8-2-centos ~]# ./install-docker-linux.sh 

==========================================
  Docker 一键安装脚本
  版本: 1.0.0
  作者: 运维工程师
==========================================

[INFO] 2026-02-25 15:08:21 - 开始执行Docker安装流程...
[INFO] 2026-02-25 15:08:21 - 日志文件: /var/log/docker-install/install_20260225_150821.log

✓ 权限检查通过
[INFO] 2026-02-25 15:08:21 - 检查网络连接...
✓ 网络连接正常
[INFO] 2026-02-25 15:08:21 - 检查磁盘空间...
✓ 磁盘空间充足 (可用: 53.31GB)

==================== [STEP] 检测系统信息 ====================

[INFO] 2026-02-25 15:08:21 - 系统架构: x86_64 (AMD64)
[INFO] 2026-02-25 15:08:21 - 操作系统: CentOS Linux
[INFO] 2026-02-25 15:08:21 - 版本: 7 (Core)
✓ 系统检测完成: centos 7 (x86_64)

==================== [STEP] 检查现有Docker安装 ====================

✓ 系统未安装Docker，可以开始全新安装

==================== [STEP] 选择Docker版本 ====================


当前默认版本: \033[0;32m27.5.0\033[0m

常用Docker版本：
  - 27.5.0 (推荐，最新稳定版)
  - 26.1.0
  - 25.0.0
  - 24.0.9
  - 23.0.6

是否使用默认版本 27.5.0? [Y/n]: y
[INFO] 2026-02-25 15:08:32 - 使用默认版本: 27.5.0

是否安装Docker Compose? [Y/n]: y
[INFO] 2026-02-25 15:08:35 - 将同时安装Docker Compose

==================== [STEP] 更新软件包索引 ====================

[INFO] 2026-02-25 15:08:35 - 执行: yum makecache
Loaded plugins: fastestmirror, langpacks
Determining fastest mirrors
Metadata Cache Created
✓ 软件包索引更新完成

==================== [STEP] 安装系统依赖 ====================

[INFO] 2026-02-25 15:08:49 - 安装依赖包: yum-utils device-mapper-persistent-data lvm2
Loaded plugins: fastestmirror, langpacks
Loading mirror speeds from cached hostfile
Package yum-utils-1.1.31-54.el7_8.noarch already installed and latest version
Package device-mapper-persistent-data-0.8.5-3.el7_9.2.x86_64 already installed and latest version
Resolving Dependencies
--> Running transaction check
---> Package lvm2.x86_64 7:2.02.187-6.el7_9.3 will be updated
---> Package lvm2.x86_64 7:2.02.187-6.el7_9.5 will be an update
--> Processing Dependency: lvm2-libs = 7:2.02.187-6.el7_9.5 for package: 7:lvm2-2.02.187-6.el7_9.5.x86_64
--> Running transaction check
---> Package lvm2-libs.x86_64 7:2.02.187-6.el7_9.3 will be updated
---> Package lvm2-libs.x86_64 7:2.02.187-6.el7_9.5 will be an update
--> Processing Dependency: device-mapper-event = 7:1.02.170-6.el7_9.5 for package: 7:lvm2-libs-2.02.187-6.el7_9.5.x86_64
--> Running transaction check
---> Package device-mapper-event.x86_64 7:1.02.170-6.el7_9.3 will be updated
---> Package device-mapper-event.x86_64 7:1.02.170-6.el7_9.5 will be an update
--> Processing Dependency: device-mapper-event-libs = 7:1.02.170-6.el7_9.5 for package: 7:device-mapper-event-1.02.170-6.el7_9.5.x86_64
--> Processing Dependency: device-mapper = 7:1.02.170-6.el7_9.5 for package: 7:device-mapper-event-1.02.170-6.el7_9.5.x86_64
--> Running transaction check
---> Package device-mapper.x86_64 7:1.02.170-6.el7_9.3 will be updated
--> Processing Dependency: device-mapper = 7:1.02.170-6.el7_9.3 for package: 7:device-mapper-libs-1.02.170-6.el7_9.3.x86_64
---> Package device-mapper.x86_64 7:1.02.170-6.el7_9.5 will be an update
---> Package device-mapper-event-libs.x86_64 7:1.02.170-6.el7_9.3 will be updated
---> Package device-mapper-event-libs.x86_64 7:1.02.170-6.el7_9.5 will be an update
--> Running transaction check
---> Package device-mapper-libs.x86_64 7:1.02.170-6.el7_9.3 will be updated
---> Package device-mapper-libs.x86_64 7:1.02.170-6.el7_9.5 will be an update
--> Finished Dependency Resolution

Dependencies Resolved

================================================================================
 Package                     Arch      Version                 Repository  Size
================================================================================
Updating:
 lvm2                        x86_64    7:2.02.187-6.el7_9.5    updates    1.3 M
Updating for dependencies:
 device-mapper               x86_64    7:1.02.170-6.el7_9.5    updates    297 k
 device-mapper-event         x86_64    7:1.02.170-6.el7_9.5    updates    192 k
 device-mapper-event-libs    x86_64    7:1.02.170-6.el7_9.5    updates    192 k
 device-mapper-libs          x86_64    7:1.02.170-6.el7_9.5    updates    325 k
 lvm2-libs                   x86_64    7:2.02.187-6.el7_9.5    updates    1.1 M

Transaction Summary
================================================================================
Upgrade  1 Package (+5 Dependent packages)

Total download size: 3.4 M
Downloading packages:
No Presto metadata available for updates
--------------------------------------------------------------------------------
Total                                              3.8 MB/s | 3.4 MB  00:00     
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
  Updating   : 7:device-mapper-libs-1.02.170-6.el7_9.5.x86_64              1/12 
  Updating   : 7:device-mapper-1.02.170-6.el7_9.5.x86_64                   2/12 
  Updating   : 7:device-mapper-event-libs-1.02.170-6.el7_9.5.x86_64        3/12 
  Updating   : 7:device-mapper-event-1.02.170-6.el7_9.5.x86_64             4/12 
  Updating   : 7:lvm2-libs-2.02.187-6.el7_9.5.x86_64                       5/12 
  Updating   : 7:lvm2-2.02.187-6.el7_9.5.x86_64                            6/12 
  Cleanup    : 7:lvm2-2.02.187-6.el7_9.3.x86_64                            7/12 
  Cleanup    : 7:lvm2-libs-2.02.187-6.el7_9.3.x86_64                       8/12 
  Cleanup    : 7:device-mapper-event-1.02.170-6.el7_9.3.x86_64             9/12 
  Cleanup    : 7:device-mapper-event-libs-1.02.170-6.el7_9.3.x86_64       10/12 
  Cleanup    : 7:device-mapper-1.02.170-6.el7_9.3.x86_64                  11/12 
  Cleanup    : 7:device-mapper-libs-1.02.170-6.el7_9.3.x86_64             12/12 
  Verifying  : 7:device-mapper-event-1.02.170-6.el7_9.5.x86_64             1/12 
  Verifying  : 7:lvm2-libs-2.02.187-6.el7_9.5.x86_64                       2/12 
  Verifying  : 7:device-mapper-1.02.170-6.el7_9.5.x86_64                   3/12 
  Verifying  : 7:device-mapper-libs-1.02.170-6.el7_9.5.x86_64              4/12 
  Verifying  : 7:lvm2-2.02.187-6.el7_9.5.x86_64                            5/12 
  Verifying  : 7:device-mapper-event-libs-1.02.170-6.el7_9.5.x86_64        6/12 
  Verifying  : 7:lvm2-2.02.187-6.el7_9.3.x86_64                            7/12 
  Verifying  : 7:device-mapper-event-1.02.170-6.el7_9.3.x86_64             8/12 
  Verifying  : 7:lvm2-libs-2.02.187-6.el7_9.3.x86_64                       9/12 
  Verifying  : 7:device-mapper-libs-1.02.170-6.el7_9.3.x86_64             10/12 
  Verifying  : 7:device-mapper-1.02.170-6.el7_9.3.x86_64                  11/12 
  Verifying  : 7:device-mapper-event-libs-1.02.170-6.el7_9.3.x86_64       12/12 

Updated:
  lvm2.x86_64 7:2.02.187-6.el7_9.5                                              

Dependency Updated:
  device-mapper.x86_64 7:1.02.170-6.el7_9.5                                     
  device-mapper-event.x86_64 7:1.02.170-6.el7_9.5                               
  device-mapper-event-libs.x86_64 7:1.02.170-6.el7_9.5                          
  device-mapper-libs.x86_64 7:1.02.170-6.el7_9.5                                
  lvm2-libs.x86_64 7:2.02.187-6.el7_9.5                                         

Complete!
✓ 系统依赖安装完成

==================== [STEP] 添加Docker官方GPG密钥 ====================

[INFO] 2026-02-25 15:08:53 - 使用阿里云镜像

==================== [STEP] 添加Docker软件仓库 ====================

Loaded plugins: fastestmirror, langpacks
adding repo from: https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
grabbing file https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo to /etc/yum.repos.d/docker-ce.repo
repo saved to /etc/yum.repos.d/docker-ce.repo
✓ Docker仓库添加成功

==================== [STEP] 安装Docker Engine ====================

[INFO] 2026-02-25 15:08:53 - 准备安装Docker版本: 27.5.0
[INFO] 2026-02-25 15:08:53 - 查询可用的Docker版本...
Loading mirror speeds from cached hostfile
Loaded plugins: fastestmirror, langpacks
docker-ce.x86_64            3:26.1.4-1.el7                      docker-ce-stable
docker-ce.x86_64            3:26.1.3-1.el7                      docker-ce-stable
docker-ce.x86_64            3:26.1.2-1.el7                      docker-ce-stable
docker-ce.x86_64            3:26.1.1-1.el7                      docker-ce-stable
docker-ce.x86_64            3:26.1.0-1.el7                      docker-ce-stable
docker-ce.x86_64            3:26.0.2-1.el7                      docker-ce-stable
docker-ce.x86_64            3:26.0.1-1.el7                      docker-ce-stable
docker-ce.x86_64            3:26.0.0-1.el7                      docker-ce-stable
[INFO] 2026-02-25 15:08:54 - 开始安装Docker...
[WARN] 2026-02-25 15:08:55 - 未找到版本 27.5.0，安装最新可用版本
Loaded plugins: fastestmirror, langpacks
Loading mirror speeds from cached hostfile
Resolving Dependencies
--> Running transaction check
---> Package containerd.io.x86_64 0:1.6.33-3.1.el7 will be installed
--> Processing Dependency: container-selinux >= 2:2.74 for package: containerd.io-1.6.33-3.1.el7.x86_64
---> Package docker-buildx-plugin.x86_64 0:0.14.1-1.el7 will be installed
---> Package docker-ce.x86_64 3:26.1.4-1.el7 will be installed
--> Processing Dependency: docker-ce-rootless-extras for package: 3:docker-ce-26.1.4-1.el7.x86_64
--> Processing Dependency: libcgroup for package: 3:docker-ce-26.1.4-1.el7.x86_64
---> Package docker-ce-cli.x86_64 1:26.1.4-1.el7 will be installed
---> Package docker-compose-plugin.x86_64 0:2.27.1-1.el7 will be installed
--> Running transaction check
---> Package container-selinux.noarch 2:2.119.2-1.911c772.el7_8 will be installed
--> Processing Dependency: policycoreutils-python for package: 2:container-selinux-2.119.2-1.911c772.el7_8.noarch
---> Package docker-ce-rootless-extras.x86_64 0:26.1.4-1.el7 will be installed
--> Processing Dependency: fuse-overlayfs >= 0.7 for package: docker-ce-rootless-extras-26.1.4-1.el7.x86_64
--> Processing Dependency: slirp4netns >= 0.4 for package: docker-ce-rootless-extras-26.1.4-1.el7.x86_64
---> Package libcgroup.x86_64 0:0.41-21.el7 will be installed
--> Running transaction check
---> Package fuse-overlayfs.x86_64 0:0.7.2-6.el7_8 will be installed
--> Processing Dependency: libfuse3.so.3(FUSE_3.2)(64bit) for package: fuse-overlayfs-0.7.2-6.el7_8.x86_64
--> Processing Dependency: libfuse3.so.3(FUSE_3.0)(64bit) for package: fuse-overlayfs-0.7.2-6.el7_8.x86_64
--> Processing Dependency: libfuse3.so.3()(64bit) for package: fuse-overlayfs-0.7.2-6.el7_8.x86_64
---> Package policycoreutils-python.x86_64 0:2.5-34.el7 will be installed
--> Processing Dependency: setools-libs >= 3.3.8-4 for package: policycoreutils-python-2.5-34.el7.x86_64
--> Processing Dependency: libsemanage-python >= 2.5-14 for package: policycoreutils-python-2.5-34.el7.x86_64
--> Processing Dependency: audit-libs-python >= 2.1.3-4 for package: policycoreutils-python-2.5-34.el7.x86_64
--> Processing Dependency: python-IPy for package: policycoreutils-python-2.5-34.el7.x86_64
--> Processing Dependency: libqpol.so.1(VERS_1.4)(64bit) for package: policycoreutils-python-2.5-34.el7.x86_64
--> Processing Dependency: libqpol.so.1(VERS_1.2)(64bit) for package: policycoreutils-python-2.5-34.el7.x86_64
--> Processing Dependency: libapol.so.4(VERS_4.0)(64bit) for package: policycoreutils-python-2.5-34.el7.x86_64
--> Processing Dependency: checkpolicy for package: policycoreutils-python-2.5-34.el7.x86_64
--> Processing Dependency: libqpol.so.1()(64bit) for package: policycoreutils-python-2.5-34.el7.x86_64
--> Processing Dependency: libapol.so.4()(64bit) for package: policycoreutils-python-2.5-34.el7.x86_64
---> Package slirp4netns.x86_64 0:0.4.3-4.el7_8 will be installed
--> Running transaction check
---> Package audit-libs-python.x86_64 0:2.8.5-4.el7 will be installed
---> Package checkpolicy.x86_64 0:2.5-8.el7 will be installed
---> Package fuse3-libs.x86_64 0:3.6.1-4.el7 will be installed
---> Package libsemanage-python.x86_64 0:2.5-14.el7 will be installed
---> Package python-IPy.noarch 0:0.75-6.el7 will be installed
---> Package setools-libs.x86_64 0:3.3.8-4.el7 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

================================================================================
 Package                Arch   Version                   Repository        Size
================================================================================
Installing:
 containerd.io          x86_64 1.6.33-3.1.el7            docker-ce-stable  35 M
 docker-buildx-plugin   x86_64 0.14.1-1.el7              docker-ce-stable  14 M
 docker-ce              x86_64 3:26.1.4-1.el7            docker-ce-stable  27 M
 docker-ce-cli          x86_64 1:26.1.4-1.el7            docker-ce-stable  15 M
 docker-compose-plugin  x86_64 2.27.1-1.el7              docker-ce-stable  13 M
Installing for dependencies:
 audit-libs-python      x86_64 2.8.5-4.el7               os                76 k
 checkpolicy            x86_64 2.5-8.el7                 os               295 k
 container-selinux      noarch 2:2.119.2-1.911c772.el7_8 extras            40 k
 docker-ce-rootless-extras
                        x86_64 26.1.4-1.el7              docker-ce-stable 9.4 M
 fuse-overlayfs         x86_64 0.7.2-6.el7_8             extras            54 k
 fuse3-libs             x86_64 3.6.1-4.el7               extras            82 k
 libcgroup              x86_64 0.41-21.el7               os                66 k
 libsemanage-python     x86_64 2.5-14.el7                os               113 k
 policycoreutils-python x86_64 2.5-34.el7                os               457 k
 python-IPy             noarch 0.75-6.el7                os                32 k
 setools-libs           x86_64 3.3.8-4.el7               os               620 k
 slirp4netns            x86_64 0.4.3-4.el7_8             extras            81 k

Transaction Summary
================================================================================
Install  5 Packages (+12 Dependent packages)

Total download size: 116 M
Installed size: 407 M
Downloading packages:
warning: /var/cache/yum/x86_64/7/docker-ce-stable/packages/docker-buildx-plugin-0.14.1-1.el7.x86_64.rpm: Header V4 RSA/SHA512 Signature, key ID 621e9f35: NOKEY
Public key for docker-buildx-plugin-0.14.1-1.el7.x86_64.rpm is not installed
--------------------------------------------------------------------------------
Total                                               18 MB/s | 116 MB  00:06     
Retrieving key from https://mirrors.aliyun.com/docker-ce/linux/centos/gpg
Importing GPG key 0x621E9F35:
 Userid     : "Docker Release (CE rpm) <docker@docker.com>"
 Fingerprint: 060a 61c5 1b55 8a7f 742b 77aa c52f eb6b 621e 9f35
 From       : https://mirrors.aliyun.com/docker-ce/linux/centos/gpg
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
  Installing : libcgroup-0.41-21.el7.x86_64                                1/17 
  Installing : docker-buildx-plugin-0.14.1-1.el7.x86_64                    2/17 
  Installing : setools-libs-3.3.8-4.el7.x86_64                             3/17 
  Installing : audit-libs-python-2.8.5-4.el7.x86_64                        4/17 
  Installing : slirp4netns-0.4.3-4.el7_8.x86_64                            5/17 
  Installing : libsemanage-python-2.5-14.el7.x86_64                        6/17 
  Installing : python-IPy-0.75-6.el7.noarch                                7/17 
  Installing : fuse3-libs-3.6.1-4.el7.x86_64                               8/17 
  Installing : fuse-overlayfs-0.7.2-6.el7_8.x86_64                         9/17 
  Installing : checkpolicy-2.5-8.el7.x86_64                               10/17 
  Installing : policycoreutils-python-2.5-34.el7.x86_64                   11/17 
  Installing : 2:container-selinux-2.119.2-1.911c772.el7_8.noarch         12/17 
setsebool:  SELinux is disabled.
  Installing : containerd.io-1.6.33-3.1.el7.x86_64                        13/17 
  Installing : docker-compose-plugin-2.27.1-1.el7.x86_64                  14/17 
  Installing : 1:docker-ce-cli-26.1.4-1.el7.x86_64                        15/17 
  Installing : docker-ce-rootless-extras-26.1.4-1.el7.x86_64              16/17 
  Installing : 3:docker-ce-26.1.4-1.el7.x86_64                            17/17 
  Verifying  : docker-compose-plugin-2.27.1-1.el7.x86_64                   1/17 
  Verifying  : checkpolicy-2.5-8.el7.x86_64                                2/17 
  Verifying  : fuse3-libs-3.6.1-4.el7.x86_64                               3/17 
  Verifying  : python-IPy-0.75-6.el7.noarch                                4/17 
  Verifying  : fuse-overlayfs-0.7.2-6.el7_8.x86_64                         5/17 
  Verifying  : libsemanage-python-2.5-14.el7.x86_64                        6/17 
  Verifying  : slirp4netns-0.4.3-4.el7_8.x86_64                            7/17 
  Verifying  : 2:container-selinux-2.119.2-1.911c772.el7_8.noarch          8/17 
  Verifying  : containerd.io-1.6.33-3.1.el7.x86_64                         9/17 
  Verifying  : 3:docker-ce-26.1.4-1.el7.x86_64                            10/17 
  Verifying  : 1:docker-ce-cli-26.1.4-1.el7.x86_64                        11/17 
  Verifying  : policycoreutils-python-2.5-34.el7.x86_64                   12/17 
  Verifying  : docker-ce-rootless-extras-26.1.4-1.el7.x86_64              13/17 
  Verifying  : audit-libs-python-2.8.5-4.el7.x86_64                       14/17 
  Verifying  : setools-libs-3.3.8-4.el7.x86_64                            15/17 
  Verifying  : docker-buildx-plugin-0.14.1-1.el7.x86_64                   16/17 
  Verifying  : libcgroup-0.41-21.el7.x86_64                               17/17 

Installed:
  containerd.io.x86_64 0:1.6.33-3.1.el7                                         
  docker-buildx-plugin.x86_64 0:0.14.1-1.el7                                    
  docker-ce.x86_64 3:26.1.4-1.el7                                               
  docker-ce-cli.x86_64 1:26.1.4-1.el7                                           
  docker-compose-plugin.x86_64 0:2.27.1-1.el7                                   

Dependency Installed:
  audit-libs-python.x86_64 0:2.8.5-4.el7                                        
  checkpolicy.x86_64 0:2.5-8.el7                                                
  container-selinux.noarch 2:2.119.2-1.911c772.el7_8                            
  docker-ce-rootless-extras.x86_64 0:26.1.4-1.el7                               
  fuse-overlayfs.x86_64 0:0.7.2-6.el7_8                                         
  fuse3-libs.x86_64 0:3.6.1-4.el7                                               
  libcgroup.x86_64 0:0.41-21.el7                                                
  libsemanage-python.x86_64 0:2.5-14.el7                                        
  policycoreutils-python.x86_64 0:2.5-34.el7                                    
  python-IPy.noarch 0:0.75-6.el7                                                
  setools-libs.x86_64 0:3.3.8-4.el7                                             
  slirp4netns.x86_64 0:0.4.3-4.el7_8                                            

Complete!
✓ Docker Engine 安装完成

==================== [STEP] 配置Docker守护进程 ====================

[INFO] 2026-02-25 15:09:25 - 创建Docker配置文件: /etc/docker/daemon.json
[INFO] 2026-02-25 15:09:25 - 配置说明：
[INFO] 2026-02-25 15:09:25 -   - 镜像加速器: 使用国内多个镜像源
[INFO] 2026-02-25 15:09:25 -   - 日志限制: 单文件最大100MB，保留3个文件
[INFO] 2026-02-25 15:09:25 -   - 存储驱动: overlay2（推荐）
[INFO] 2026-02-25 15:09:25 -   - 实时恢复: 启用（容器在Docker重启后继续运行）
✓ Docker配置文件创建完成

==================== [STEP] 配置用户权限 ====================

[INFO] 2026-02-25 15:09:25 - 当前用户为root，跳过用户权限配置

==================== [STEP] 启动Docker服务 ====================

[INFO] 2026-02-25 15:09:25 - 重新加载systemd配置...
[INFO] 2026-02-25 15:09:25 - 启动Docker服务...
✓ Docker服务已启动
[INFO] 2026-02-25 15:09:28 - 设置Docker服务开机自启...
Created symlink from /etc/systemd/system/multi-user.target.wants/docker.service to /usr/lib/systemd/system/docker.service.
✓ Docker已设置为开机自启

==================== [STEP] 验证Docker安装 ====================

[INFO] 2026-02-25 15:09:28 - 检查Docker命令...
✓ ✓ Docker命令可用
[INFO] 2026-02-25 15:09:28 - 检查Docker版本...
[INFO] 2026-02-25 15:09:28 - 已安装的Docker版本: 26.1.4
✓ ✓ Docker版本检查通过
[INFO] 2026-02-25 15:09:28 - 检查Docker服务状态...
✓ ✓ Docker服务运行中
[INFO] 2026-02-25 15:09:28 - 检查Docker系统信息...
✓ ✓ Docker系统信息正常
[INFO] 2026-02-25 15:09:28 - 运行测试容器 (hello-world)...
✓ ✓ Docker容器运行测试通过
[INFO] 2026-02-25 15:09:38 - 检查Docker Compose...
[INFO] 2026-02-25 15:09:38 - Docker Compose版本: 2.27.1
✓ ✓ Docker Compose 可用
✓ 所有验证检查通过！

==================== [STEP] 安装总结 ====================


==========================================
  Docker 安装成功！
==========================================

安装信息：
  Docker版本: 26.1.4
  安装时间: 2026-02-25 15:09:38
  系统: centos 7 (x86_64)
  日志文件: /var/log/docker-install/install_20260225_150821.log

  Docker Compose: 2.27.1

配置信息：
  配置文件: /etc/docker/daemon.json
  数据目录: /var/lib/docker
  镜像加速: 已启用（国内多镜像源）
  开机自启: enabled

==========================================
  后续步骤
==========================================

1. 重新登录以使docker组权限生效：

2. 验证Docker安装：
   docker --version
   docker run hello-world

3. 查看Docker信息：
   docker info

4. 常用Docker命令：
   docker ps              # 查看运行中的容器
   docker images          # 查看镜像列表
   docker pull <image>    # 拉取镜像
   docker run <image>     # 运行容器

5. Docker Compose命令：
   docker compose up      # 启动服务
   docker compose down    # 停止服务
   docker compose ps      # 查看服务状态

6. 管理Docker服务：
   sudo systemctl start docker    # 启动Docker
   sudo systemctl stop docker     # 停止Docker
   sudo systemctl restart docker  # 重启Docker
   sudo systemctl status docker   # 查看状态

7. 卸载Docker（如需要）：
   sudo yum remove docker-ce docker-ce-cli containerd.io
   sudo rm -rf /var/lib/docker /etc/docker

==========================================
  问题排查
==========================================

如遇到问题，请检查：
  1. 日志文件: /var/log/docker-install/install_20260225_150821.log
  2. Docker日志: journalctl -xeu docker.service
  3. Docker状态: systemctl status docker
  4. 网络连接: ping docker.io

获取帮助：
  - Docker官方文档: https://docs.docker.com
  - Docker中文社区: https://www.docker.org.cn

✓ Docker安装完成！

命令行参数

1	sudo bash install-docker-linux.sh [选项]

参数	说明	适用场景
`--version <版本号>`	安装指定版本	`--version 24.0.7`
`--no-compose`	不安装 Docker Compose	只需要 Engine
`--no-mirror`	不配置国内镜像加速源	海外服务器
`--no-autostart`	不设置 Docker 开机自启	测试环境
`--help` / `-h`	显示帮助信息	—

常用安装示例

# Ubuntu 默认安装（交互式选版本）
sudo bash install-docker-linux.sh

# CentOS 安装指定版本
sudo bash install-docker-linux.sh --version 24.0.7

# 海外服务器，不用国内镜像
sudo bash install-docker-linux.sh --no-mirror

# 只装 Docker Engine，不装 Compose
sudo bash install-docker-linux.sh --no-compose

# 多参数组合
sudo bash install-docker-linux.sh --version 26.1.0 --no-autostart

# 内网通过代理安装
export http_proxy=http://proxy.example.com:8080
export https_proxy=http://proxy.example.com:8080
sudo -E bash install-docker-linux.sh

安装流程详解

16 个安装步骤

脚本按以下顺序自动执行：

步骤 1  检查 root 权限
步骤 2  检查网络连接（分别测试国内和国际网络）
步骤 3  检查磁盘空间（需要至少 5GB）
步骤 4  检测系统信息（发行版、版本号、CPU 架构）
步骤 5  检测是否已安装 Docker
步骤 6  选择 Docker 版本
步骤 7  更新软件包索引
步骤 8  安装系统依赖（curl、gnupg 等）
步骤 9  添加 Docker 官方 GPG 密钥
步骤 10 添加 Docker 软件仓库
步骤 11 安装 DockerEngine 和 Containerd
步骤 12 写入 daemon.json 配置
步骤 13 配置用户权限（加入 docker 组）
步骤 14 启动 Docker 服务并设置开机自启
步骤 15 执行 6 项安装验证
步骤 16 显示安装总结

交互式选择说明

处理已有 Docker

==========================================
检测到系统已安装Docker
==========================================
当前版本: 24.0.7
Docker路径: /usr/bin/docker

已安装的包:
  - docker-ce
  - docker-ce-cli
  - containerd.io

请选择操作：
  1) 卸载现有Docker并重新安装 (推荐)
  2) 跳过安装，保持现有版本
  3) 仅升级到指定版本
  4) 退出脚本

请输入选项 [1-4]:

数据保留确认

选择卸载时会出现：

1	是否保留Docker镜像和容器数据? [y/N]:

输入 y 保留 /var/lib/docker 中的数据，输入 n 或直接回车则完全清理（配置文件会自动备份到 /etc/docker/daemon.json.backup.YYYYMMDD_HHMMSS）。

版本选择

当前默认版本: 27.5.0

常用Docker版本：
  - 27.5.0 (推荐，最新稳定版)
  - 26.1.0 (长期支持版)
  - 25.0.0
  - 24.0.9
  - 23.0.6

是否使用默认版本 27.5.0? [Y/n]:

不确定选哪个：

开发测试环境

→ 默认的 27.5.0
生产环境

→ 26.1.0，更保守
有版本要求的项目

→ 按项目要求

daemon.json 配置说明

脚本安装完成后会在 /etc/docker/daemon.json 写入以下配置：

{
  "registry-mirrors": [
    "https://docker.rainbond.cc",
    "https://docker.1ms.run",
    "https://docker.m.daocloud.io",
    "https://dockerhub.icu",
    "https://docker.chenby.cn"
  ],
"log-driver": "json-file",
"log-opts": {
    "max-size": "100m",
    "max-file": "3"
  },
"storage-driver": "overlay2",
"default-ulimits": {
    "nofile": {
      "Name": "nofile",
      "Hard": 64000,
      "Soft": 64000
    }
  },
"live-restore": true,
"userland-proxy": false,
"experimental": false,
"metrics-addr": "127.0.0.1:9323",
"max-concurrent-downloads": 10
}

各配置项说明

配置项	值	作用
`registry-mirrors`	5 个国内镜像源	拉取镜像时走国内节点，速度快很多
`log-driver`	json-file	标准 JSON 格式日志
`log-opts.max-size`	100m	单个日志文件上限，超过自动轮转
`log-opts.max-file`	3	最多保留 3 个日志文件（约 300MB）
`storage-driver`	overlay2	性能最好的存储驱动，内核 3.10+ 可用
`default-ulimits.nofile`	64000	文件描述符上限，高并发场景必须调大
`live-restore`	true	Docker 服务重启时容器不停止
`userland-proxy`	false	用 iptables 做端口转发，比用户态代理快
`metrics-addr`	127.0.0.1:9323	Prometheus 采集端点，只监听本机
`max-concurrent-downloads`	10	同时拉取的镜像层数，加速多层镜像下载

关于镜像加速源

配置了 5 个而不是 1 个，是因为公开镜像源的可用性不稳定。Docker 会依次尝试，前面的失败了自动切到下一个：

docker.rainbond.cc（Rainbond 社区）
docker.1ms.run（1ms）
docker.m.daocloud.io（DaoCloud）
dockerhub.icu
docker.chenby.cn

验证镜像加速是否生效：

1	docker info \| grep -A 10 "Registry Mirrors"

修改配置

如果需要调整，直接编辑配置文件然后重启：

1
2
3

sudo nano /etc/docker/daemon.json
sudo systemctl restart docker
docker info

常见问题 FAQ

Q1：必须用 sudo 运行吗？

是的，安装 Docker 需要修改系统配置，必须有 root 权限：

1	sudo bash install-docker-linux.sh

Q2：装完之后运行 docker 命令还要加 sudo，怎么解决？

用户加入 docker 组需要重新登录才能生效，两种方式任选：

# 不退出当前会话，立即生效
newgrp docker

# 或直接退出终端重新登录

Q3：怎么安装指定版本？

1	sudo bash install-docker-linux.sh --version 24.0.7

不确定有哪些版本可以装时，先查一下：

# Ubuntu/Debian
apt-cache madison docker-ce

# CentOS/RHEL
yum list docker-ce --showduplicates

Q4：内网环境、访问不了外网怎么办？

通过 HTTP 代理安装：

1
2
3

export http_proxy=http://proxy.example.com:8080
export https_proxy=http://proxy.example.com:8080
sudo -E bash install-docker-linux.sh

目前脚本不支持纯离线安装，如有需求可提 Issue。

Q5：安装失败了怎么查原因？

# 脚本安装日志
sudo cat /var/log/docker-install/install_*.log

# Docker 服务日志
sudo journalctl -xeu docker.service

Q6：ARM 服务器能用吗？

支持，脚本自动检测 ARM64 或 ARMv7 并安装对应版本，不需要额外处理。

Q7：安装后想换镜像加速源怎么改？

编辑 /etc/docker/daemon.json，修改 registry-mirrors 数组，保存后执行：

1	sudo systemctl restart docker

故障排查

错误1：权限不足

报错：

1	[ERROR] 此脚本必须以root权限运行

解决：

1	sudo bash install-docker-linux.sh

错误2：网络连接失败

报错：

1	[ERROR] 网络连接失败，无法访问外部网络

排查步骤：

# 测试基础网络
ping -c 3 8.8.8.8

# 测试 DNS
nslookup download.docker.com

# 如果在内网，配置代理
export http_proxy=http://proxy.example.com:8080
export https_proxy=http://proxy.example.com:8080
sudo -E bash install-docker-linux.sh

错误3：磁盘空间不足

报错：

1 2	[ERROR] 磁盘空间不足可用空间: 2.5GB / 所需空间: 至少 5GB

解决：

# 清理 APT 缓存（Ubuntu/Debian）
sudo apt-get clean

# 清理 YUM 缓存（CentOS/RHEL）
sudo yum clean all

# 如果已有 Docker 残留，清理镜像和容器
sudo docker system prune -a

# 找出占用最多的目录
du -sh /* 2>/dev/null | sort -rh | head -10

错误4：GPG 密钥下载失败

报错：

1	[ERROR] GPG密钥下载失败

解决：

先试 --no-mirror 参数（走官方源）：

1	sudo bash install-docker-linux.sh --no-mirror

或手动添加 GPG 密钥后重跑：

# Ubuntu/Debian
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
  sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

sudo bash install-docker-linux.sh

错误5：Docker 服务启动失败

报错：

1	[ERROR] Docker服务启动失败

排查步骤：

# 1. 看详细日志（最有用）
sudo journalctl -xeu docker.service --no-pager | tail -50

# 2. 检查 daemon.json 格式
cat /etc/docker/daemon.json | python3 -m json.tool

# 3. 让 Docker 自己验证配置
sudo dockerd --validate

# 4. 如果是配置文件问题，先用最小配置测试
echo '{}' | sudo tee /etc/docker/daemon.json
sudo systemctl start docker

错误6：测试容器运行失败

报错：

1	[ERROR] Docker容器运行测试失败

排查步骤：

# 确认 Docker 服务在跑
sudo systemctl status docker

# 手动拉取测试镜像
sudo docker pull hello-world

# 手动运行测试容器
sudo docker run --rm hello-world

# 检查镜像加速配置
docker info | grep -A5 "Registry Mirrors"

错误7：找不到指定版本

报错：

1	[WARN] 未找到精确版本 24.0.7

解决：

# 查看当前仓库里有哪些版本
# Ubuntu/Debian
apt-cache madison docker-ce | head -20

# CentOS/RHEL
yum list docker-ce --showduplicates | sort -r | head -20

找一个存在的版本号重新安装：

1	sudo bash install-docker-linux.sh --version 24.0.9

完全卸载 Docker

Ubuntu / Debian

# 1. 停止服务
sudo systemctl stop docker docker.socket containerd

# 2. 卸载软件包
sudo apt-get purge -y docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin

# 3. 删除数据和配置
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd
sudo rm -rf /etc/docker

# 4. 删除 docker 用户组
sudo groupdel docker

# 5. 清理残留
sudo apt-get autoremove -y && sudo apt-get autoclean

CentOS / RHEL / Rocky Linux

# 1. 停止服务
sudo systemctl stop docker docker.socket containerd

# 2. 卸载软件包
sudo yum remove -y docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin

# 3. 删除数据和配置
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd
sudo rm -rf /etc/docker

# 4. 删除 docker 用户组
sudo groupdel docker

Fedora

# 1. 停止服务
sudo systemctl stop docker docker.socket containerd

# 2. 卸载软件包
sudo dnf remove -y docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin

# 3. 删除数据和配置
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd
sudo rm -rf /etc/docker

# 4. 删除 docker 用户组
sudo groupdel docker

只卸载软件包、保留数据

如果想保留镜像和容器数据，不删 /var/lib/docker：

# Ubuntu/Debian
sudo apt-get remove docker-ce docker-ce-cli containerd.io

# CentOS/RHEL
sudo yum remove docker-ce docker-ce-cli containerd.io

# Fedora
sudo dnf remove docker-ce docker-ce-cli containerd.io

重新安装 Docker 后，/var/lib/docker 里的数据可以继续用。

附录

日志文件位置

日志类型	位置
脚本安装日志	`/var/log/docker-install/install_YYYYMMDD_HHMMSS.log`
Docker 服务日志	`journalctl -u docker.service`
容器日志目录	`/var/lib/docker/containers/<container-id>/`

重要文件路径

文件/目录	说明
`/etc/docker/daemon.json`	Docker 守护进程配置文件
`/var/lib/docker/`	镜像、容器、卷的数据目录
`/var/run/docker.sock`	Docker Unix Socket
`/etc/apt/sources.list.d/docker.list`	APT 仓库源（Ubuntu/Debian）
`/etc/yum.repos.d/docker-ce.repo`	YUM 仓库源（CentOS/RHEL）

常用 Docker 命令速查

# 版本和状态
docker --version
docker compose version
docker info

# 容器操作
docker ps                   # 查看运行中的容器
docker ps -a                # 查看所有容器（含已停止）
docker start <ID或名称>     # 启动容器
docker stop <ID或名称>      # 停止容器
docker restart <ID或名称>   # 重启容器
docker rm <ID或名称>        # 删除容器

# 镜像操作
docker images               # 查看本地镜像
docker pull <镜像名:tag>    # 拉取镜像
docker rmi <ID或名称>       # 删除镜像
docker image prune          # 清理悬空镜像

# 服务管理
sudo systemctl start docker    # 启动
sudo systemctl stop docker     # 停止
sudo systemctl restart docker  # 重启
sudo systemctl status docker   # 查看状态
sudo systemctl enable docker   # 设置开机自启

# 清理
docker system prune            # 清理停止的容器、悬空镜像等
docker system prune -a         # 清理所有未使用的资源（谨慎）
docker system df               # 查看磁盘占用

参考资源

Docker 官方文档：https://docs.docker.com
Docker Hub：https://hub.docker.com
Docker Release Notes：https://docs.docker.com/engine/release-notes/
GitHub docker-ce：https://github.com/docker/docker-ce

💡 提示：本文档会持续更新，请登录官网「itinstall.dev」查看最新版本。如有问题或建议，欢迎反馈！

Linux 一键安装 Docker 脚本使用指南

系统要求与兼容性

支持的 Linux 发行版

支持的系统架构

硬件最低要求

权限要求

功能特性

智能环境检测

版本管理

自动配置优化

用户权限

安装日志

错误处理

安装验证

使用方法

推荐方式（下载后运行）

CentOS系统安装实测

命令行参数

常用安装示例

安装流程详解

16 个安装步骤

交互式选择说明

处理已有 Docker

数据保留确认

版本选择

daemon.json 配置说明

各配置项说明

关于镜像加速源

修改配置

常见问题 FAQ

Q1：必须用 sudo 运行吗？

Q2：装完之后运行 docker 命令还要加 sudo，怎么解决？

Q3：怎么安装指定版本？

Q4：内网环境、访问不了外网怎么办？

Q5：安装失败了怎么查原因？

Q6：ARM 服务器能用吗？

Q7：安装后想换镜像加速源怎么改？

故障排查

错误1：权限不足

错误2：网络连接失败

错误3：磁盘空间不足

错误4：GPG 密钥下载失败

错误5：Docker 服务启动失败

错误6：测试容器运行失败

错误7：找不到指定版本

完全卸载 Docker

Ubuntu / Debian

CentOS / RHEL / Rocky Linux

Fedora

只卸载软件包、保留数据

附录

日志文件位置

重要文件路径

常用 Docker 命令速查

参考资源