服务器安装Docker的完整步骤与常见问题处理
在Linux服务器上配置Docker,最稳妥的方式是使用Docker官方提供的安装脚本或系统包管理器。
整个过程分为四步:确认系统环境、安装Docker引擎、启动并设置开机自启、验证安装结果。
下面按顺序说明每个环节的操作和容易出错的地方。
安装前先确认系统环境
Docker对Linux内核版本有要求,较新的发行版通常已经满足。
先登录服务器,用下面两条命令查看系统版本和内核版本:
cat /etc/os-release
uname -r
如果系统是CentOS 7、Ubuntu 20.04或更新版本,一般可以直接安装。
CentOS 7的内核版本偏低,但Docker官方仍提供支持,只是运行某些新特性容器时可能受限。
确认系统后,建议先更新软件包索引,避免安装时依赖缺失:
sudo apt update # Debian/Ubuntu
sudo yum makecache # CentOS/RHEL
安装Docker引擎
最简单的方式是使用Docker官方的一键安装脚本,适合测试环境或对版本没有特殊要求的场景:
curl -fsSL https://get.docker.com | sudo sh
如果服务器无法访问外网,或者你希望精确控制安装版本,可以用包管理器手动安装。
以Ubuntu为例:
sudo apt install docker.io
CentOS则使用:
sudo yum install docker-ce
安装完成后,Docker服务默认不会自动启动。
执行下面的命令启动并设置开机自启:
sudo systemctl start docker
sudo systemctl enable docker
把当前用户加入docker组
默认情况下,只有root用户和docker组成员才能执行docker命令。
如果平时用普通用户登录服务器,直接运行docker ps会提示权限不足。
把当前用户加入docker组可以避免每次命令前都加sudo:
sudo usermod -aG docker $USER
执行后需要退出当前SSH会话并重新登录,用户组变更才会生效。
注意,加入docker组意味着该用户拥有与root等效的容器管理权限,在生产服务器上应只授予可信账户。
验证安装是否成功
重新登录后,运行下面两条命令检查Docker是否正常工作:
docker --version
docker run hello-world
第一条命令应输出Docker客户端和引擎的版本号。
第二条命令会从官方仓库拉取一个测试镜像并运行,如果看到“Hello from Docker!
”字样,说明安装和网络访问都正常。
如果拉取镜像超时,通常需要检查服务器的DNS设置或配置镜像加速地址。
常见问题与处理
执行docker命令提示“permission denied”:说明当前用户没有加入docker组,或者加入后没有重新登录。
先确认groups命令输出中包含docker,如果没有,重新执行usermod命令并退出SSH重连。
拉取镜像速度慢或超时:可以在/etc/docker/daemon.json中配置镜像加速地址,文件不存在时新建。
修改后执行sudo systemctl daemon-reload和sudo systemctl restart docker使配置生效。
服务启动失败:用sudo systemctl status docker查看错误信息,常见原因是daemon.json格式错误或磁盘空间不足。
检查配置文件语法后再次启动。
完成以上步骤后,服务器就具备了运行容器的基础环境。
后续部署应用时,可以先从docker pull拉取镜像,再用docker run启动容器,逐步熟悉容器管理命令。