关键在于官方源安装、镜像加速、docker组权限及overlay2存储驱动配置:先确认系统兼容性并更新,再添加docker官方gpg密钥与仓库,安装docker-ce等核心组件并启用服务;接着配置daemon.json镜像加速、将用户加入docker组、确保storage-driver为overlay2;最后用hello-world验证,排查权限、网络与配置问题。
在云服务器上高效安装 docker engine,关键不是“装上就行”,而是让安装过程稳定、后续运行可靠、拉镜像快、权限合理、不踩安全坑。下面从准备到验证,分四步讲清楚。
确认系统兼容性与基础准备
Ubuntu 20.04/22.04 LTS 或 CentOS 7/8/Stream 是首选,内核需 ≥3.10(CentOS 7 默认满足,但建议升级至 kernel-ml 以支持 overlay2 驱动)。避免使用已停止维护的版本(如 Ubuntu 18.04、CentOS 6)。
- 执行 sudo apt update(Ubuntu)或 sudo yum update -y(CentOS),确保系统最新
- 安装基础依赖:curl、ca-certificates、gnupg(Ubuntu)或 yum-utils、device-mapper-persistent-data、lvm2(CentOS)
- 检查内存:生产环境建议 ≥4GB;若仅测试,2GB 可临时运行,但避免同时启多个容器
用官方源安装(推荐,稳定可控)
比一键脚本更透明,便于审计和复现,也方便后续升级或降级。
- Ubuntu 示例:添加 Docker 官方 GPG 密钥和 APT 仓库,再安装 docker-ce、docker-ce-cli、containerd.io 及插件(如 buildx、compose)
- CentOS 示例:用 yum-config-manager 添加 docker-ce.repo,然后 yum install docker-ce docker-ce-cli containerd.io
- 安装后立即执行 sudo systemctl enable --now docker,确保服务启动并开机自启
必配三项:镜像加速、用户组、存储驱动
这三步不做,后续会明显卡顿、权限报错或写入异常。
-
配置镜像加速器:国内用户必须加。编辑 /etc/docker/daemon.json,填入阿里云或腾讯云提供的加速地址,例如:
{"registry-mirrors": ["https://xxx.mirror.aliyuncs.com"]} - 将当前用户加入 docker 组:运行 sudo usermod -aG docker $USER,再执行 newgrp docker 立即生效,避免每次敲 sudo
- 确认存储驱动为 overlay2:Docker 20.10+ 默认启用。执行 docker info | grep "Storage Driver" 验证;若显示 devicemapper(CentOS 7 默认),需手动配置 /etc/docker/daemon.json 加入 {"storage-driver": "overlay2"}
快速验证与常见问题排查
安装完成不等于可用,要真正跑通一个容器才算落地。
- 运行 docker run --rm hello-world:成功输出 “Hello from Docker!” 即基础功能正常
- 若提示 permission denied on /var/run/docker.sock,说明用户未生效,重新登录终端或再执行 newgrp docker
- 若拉镜像超时或失败,先检查 daemon.json 格式是否为合法 JSON(无注释、逗号结尾正确),再重启服务:sudo systemctl restart docker
- 执行 docker info 查看完整运行状态,重点关注 Registry Mirrors、Storage Driver、Cgroup Driver 三项











