初学者安装 docker 引擎关键在于选对系统版本、避开依赖陷阱、验证生效:windows/macos 用 docker desktop 并开启 wsl2 或授予权限;ubuntu/debian 和 centos/rhel 等须添加官方仓库安装 ce 版,加入 docker 组并重启服务;安装后需配置镜像加速器、验证非 root 运行、测试容器启动。

初学者安装 Docker 引擎其实不难,关键是选对系统版本、跳过常见依赖陷阱、验证安装是否真正生效。下面按主流操作系统分步说明,每一步都标出易错点和验证方式。
Windows 和 macOS:用官方桌面版一键搞定
Windows 10/11(专业版/企业版/教育版)和 macOS 用户,不要手动装 Docker Engine,直接下载 Docker Desktop:
- 去官网 docker.com/products/docker-desktop 下载对应安装包
- Windows 需提前开启 WSL2(安装时勾选“Install WSL2 kernel update”即可,Docker Desktop 会自动配置)
- macOS 安装后首次启动会请求辅助功能权限,必须允许,否则
docker run会静默失败 - 安装完成,在终端运行
docker --version和docker run hello-world,看到欢迎信息才算成功
Ubuntu/Debian:用 APT 仓库安装最稳
别用 sudo apt install docker.io(系统源版本旧、缺 CLI 插件),应添加 Docker 官方 GPG 密钥和仓库:
- 先卸载可能存在的旧版:
sudo apt remove docker docker-engine docker.io containerd runc - 执行四条命令依次添加密钥、添加仓库、更新、安装:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpgecho "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/nullsudo apt updatesudo apt install docker-ce docker-ce-cli containerd.io - 把当前用户加进
docker组,避免每次都要sudo:sudo usermod -aG docker $USER,然后完全退出并重新登录终端 - 验证:
docker info不报 permission denied,且docker run hello-world正常输出即成功
CentOS/RHEL/Rocky Linux:用 yum/dnf 装 CE 版
同样避开系统自带的老旧 docker 包,启用 Docker 官方仓库:
- 卸载旧版:
sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine - 设置仓库(以 CentOS 8+/Rocky 8+ 为例):
sudo yum install -y yum-utilssudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo - 安装:
sudo yum install docker-ce docker-ce-cli containerd.io - 启动服务并设开机自启:
sudo systemctl start docker && sudo systemctl enable docker - 验证同上,注意若遇到
cgroup v2兼容问题(如 Podman 冲突),可临时改内核参数或升级到较新内核
安装后必做的三件事
无论哪个系统,装完不是终点,这三项直接影响后续使用体验:
-
配置镜像加速器(国内用户强烈建议):编辑
/etc/docker/daemon.json(Windows/macOS 在 Docker Desktop 设置里找 Daemon),加入阿里云或中科大镜像地址,例如:{"registry-mirrors": ["https://<your-mirror>.mirror.aliyuncs.com"]}</your-mirror>,然后重启服务:sudo systemctl restart docker -
验证非 root 运行:切到普通用户,执行
docker ps,不报错才说明用户组生效;若仍提示 permission denied,请检查是否已重新登录终端 -
试跑一个真实容器:比如
docker run -it --rm alpine sh -c "echo 'Hello from Alpine!'",确认基础运行环境就绪










