Ubuntu 服务器 Docker 安装指南
本指南将帮助您在 Ubuntu 服务器上安装和配置 Docker。
前置条件
- Ubuntu 服务器
- 具有 sudo 权限的用户账户
安装步骤
1. 更新系统包列表
sudo apt update
2. 安装依赖包
安装必要的依赖包，用于支持 HTTPS 仓库访问：
sudo apt install -y \
apt-transport-https \
ca-certificates \
curl \
software-properties-common
3. 添加 Docker 官方 GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
4. 配置 Docker 软件源
echo "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/null
5. 更新软件包列表
sudo apt update
6. 安装 Docker 引擎
sudo apt install -y docker-ce docker-ce-cli containerd.io
7. 验证安装
检查 Docker 版本：
docker --version
运行测试容器：
sudo docker run hello-world
8. 配置用户权限（可选）
将当前用户添加到 docker 用户组，避免每次都需要使用 sudo：
sudo usermod -aG docker $USER
注意：执行此命令后需要注销并重新登录才能生效。
9. 配置 Docker 服务
启动 Docker 服务：
sudo systemctl start docker
设置开机自启：
sudo systemctl enable docker
故障排除
如果遇到权限问题，请确保：
- 已正确将用户添加到 docker 用户组
- 已重新登录系统使更改生效
参考链接
Docker 安装故障排除指南
常见问题：Package 'docker-ce' has no installation candidate
当遇到此错误时，表示系统无法从当前配置的软件源中找到 Docker 相关的软件包。请按照以下步骤逐一排查：
1. 检查软件源配置
重新添加 Docker 的 GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
重新添加 Docker 的 APT 软件源
echo "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/null
更新软件包列表
sudo apt update
2. 检查 Ubuntu 版本兼容性
Docker 官方支持的 Ubuntu 版本：
- Ubuntu Jammy 22.04 (LTS)
- Ubuntu Focal 20.04 (LTS)
- Ubuntu Bionic 18.04 (LTS)
查看当前 Ubuntu 版本：
lsb_release -a
3. 手动指定 Docker 版本
如果默认安装失败，可以尝试安装特定版本：
列出可用的 Docker 版本
apt-cache madison docker-ce
安装指定版本
# 示例：安装特定版本（请根据实际输出替换版本号）
sudo apt install docker-ce=5:20.10.14~3-0~ubuntu-focal \
docker-ce-cli=5:20.10.14~3-0~ubuntu-focal \
containerd.io
4. 检查网络连接
测试与 Docker 官方源的连接：
ping download.docker.com
5. 清除 APT 缓存
如果上述方法都无效，尝试清除 APT 缓存：
sudo apt clean
sudo apt update
6. 重新安装
完成上述步骤后，重新尝试安装 Docker：
sudo apt install -y docker-ce docker-ce-cli containerd.io
其他常见问题
权限问题
如果遇到权限相关错误，请确保：
- 已正确将用户添加到 docker 用户组
- 已重新登录系统使更改生效
服务启动问题
如果 Docker 服务无法启动，可以尝试：
# 重启 Docker 服务
sudo systemctl restart docker
# 查看 Docker 服务状态
sudo systemctl status docker
# 查看 Docker 日志
sudo journalctl -xu docker
