ubuntu 服务器安装 docker

Ubuntu 服务器 Docker 安装指南

本指南将帮助您在 Ubuntu 服务器上安装和配置 Docker。

前置条件

  • Ubuntu 服务器
  • 具有 sudo 权限的用户账户

安装步骤

1. 更新系统包列表

bash 复制代码
sudo apt update

2. 安装依赖包

安装必要的依赖包,用于支持 HTTPS 仓库访问:

bash 复制代码
sudo apt install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    software-properties-common

3. 添加 Docker 官方 GPG 密钥

bash 复制代码
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
    sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

4. 配置 Docker 软件源

bash 复制代码
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. 更新软件包列表

bash 复制代码
sudo apt update

6. 安装 Docker 引擎

bash 复制代码
sudo apt install -y docker-ce docker-ce-cli containerd.io

7. 验证安装

检查 Docker 版本:

bash 复制代码
docker --version

运行测试容器:

bash 复制代码
sudo docker run hello-world

8. 配置用户权限(可选)

将当前用户添加到 docker 用户组,避免每次都需要使用 sudo:

bash 复制代码
sudo usermod -aG docker $USER

注意:执行此命令后需要注销并重新登录才能生效。

9. 配置 Docker 服务

启动 Docker 服务:

bash 复制代码
sudo systemctl start docker

设置开机自启:

bash 复制代码
sudo systemctl enable docker

故障排除

如果遇到权限问题,请确保:

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

参考链接


Docker 安装故障排除指南

常见问题:Package 'docker-ce' has no installation candidate

当遇到此错误时,表示系统无法从当前配置的软件源中找到 Docker 相关的软件包。请按照以下步骤逐一排查:

1. 检查软件源配置

重新添加 Docker 的 GPG 密钥
bash 复制代码
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
    sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
重新添加 Docker 的 APT 软件源
bash 复制代码
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
更新软件包列表
bash 复制代码
sudo apt update

2. 检查 Ubuntu 版本兼容性

Docker 官方支持的 Ubuntu 版本:

  • Ubuntu Jammy 22.04 (LTS)
  • Ubuntu Focal 20.04 (LTS)
  • Ubuntu Bionic 18.04 (LTS)

查看当前 Ubuntu 版本:

bash 复制代码
lsb_release -a

3. 手动指定 Docker 版本

如果默认安装失败,可以尝试安装特定版本:

列出可用的 Docker 版本
bash 复制代码
apt-cache madison docker-ce
安装指定版本
bash 复制代码
# 示例:安装特定版本(请根据实际输出替换版本号)
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 官方源的连接:

bash 复制代码
ping download.docker.com

5. 清除 APT 缓存

如果上述方法都无效,尝试清除 APT 缓存:

bash 复制代码
sudo apt clean
sudo apt update

6. 重新安装

完成上述步骤后,重新尝试安装 Docker:

bash 复制代码
sudo apt install -y docker-ce docker-ce-cli containerd.io

其他常见问题

权限问题

如果遇到权限相关错误,请确保:

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

服务启动问题

如果 Docker 服务无法启动,可以尝试:

bash 复制代码
# 重启 Docker 服务
sudo systemctl restart docker

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

# 查看 Docker 日志
sudo journalctl -xu docker

参考资源

相关推荐
灵感__idea5 小时前
JavaScript高级程序设计(第5版):好的编程就是掌控感
前端·javascript·程序员
烛阴6 小时前
Mix
前端·webgl
代码续发6 小时前
前端组件梳理
前端
试图让你心动7 小时前
原生input添加删除图标类似vue里面移入显示删除[jquery]
前端·vue.js·jquery
陈不知代码7 小时前
uniapp创建vue3+ts+pinia+sass项目
前端·uni-app·sass
小王码农记7 小时前
sass中@mixin与 @include
前端·sass
陈琦鹏8 小时前
轻松管理 WebSocket 连接!easy-websocket-client
前端·vue.js·websocket
hui函数8 小时前
掌握JavaScript函数封装与作用域
前端·javascript
行板Andante8 小时前
前端设计中如何在鼠标悬浮时同步修改块内样式
前端
Carlos_sam9 小时前
Opnelayers:ol-wind之Field 类属性和方法详解
前端·javascript