ubuntu 服务器安装 docker

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

故障排除

如果遇到权限问题，请确保：

1. 已正确将用户添加到 docker 用户组
2. 已重新登录系统使更改生效

参考链接

• Docker 官方文档
• Docker Hub

---

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

其他常见问题

权限问题

如果遇到权限相关错误，请确保：

1. 已正确将用户添加到 docker 用户组
2. 已重新登录系统使更改生效

服务启动问题

如果 Docker 服务无法启动，可以尝试：

# 重启 Docker 服务
sudo systemctl restart docker

# 查看 Docker 服务状态
sudo systemctl status docker

# 查看 Docker 日志
sudo journalctl -xu docker

参考资源

• Docker 官方安装文档
• Docker 故障排除指南
• Ubuntu 软件源配置指南