### 如何在 Ubuntu 上安装和使用 `docker-ce-cli` #### 1. 准备工作 在安装 `docker-ce-cli` 前，需确保系统的包管理器是最新的。运行以下命令更新系统软件源并升级现有软件包： ```bash sudo apt update && sudo apt upgrade -y ``` 此步骤有助于减少因版本不匹配引起的依赖问题。 --- #### 2. 卸载旧版 Docker 如果之前已安装过其他版本的 Docker 或其变体（如 `docker.io`），建议先卸载它们以避免冲突： ```bash sudo apt remove docker docker-engine docker.io containerd runc -y ``` 这一步可以清理可能存在的遗留文件或配置[^2]。 --- #### 3. 设置 Docker 的官方仓库 为了获取最新版本的 `docker-ce-cli` 和相关组件，需要添加 Docker 的官方 APT 存储库： ##### (a) 安装必要的工具 ```bash sudo apt install curl gnupg lsb-release ca-certificates -y ``` ##### (b) 添加 GPG 密钥 通过以下命令导入 Docker 的官方 GPG 密钥： ```bash curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg ``` ##### (c) 添加存储库 创建一个新的 APT 源列表文件来启用 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 ``` --- #### 4. 安装 `docker-ce-cli` 完成以上设置后，即可安装 `docker-ce-cli` 及其依赖项： ```bash sudo apt update sudo apt install docker-ce-cli -y ``` 该命令会自动解析并下载所需的依赖关系，包括但不限于 `containerd.io` 和核心 CLI 工具[^1]。 --- #### 5. 测试安装 验证 `docker-ce-cli` 是否成功安装以及当前版本号： ```bash docker version ``` 如果没有报错，则说明安装正常。注意此时仅安装了客户端部分；若要启动服务端功能，还需额外安装完整的 Docker 引擎（即 `docker-ce`）[^3]。 --- #### 6. 使用示例 以下是几个常见的 `docker-ce-cli` 命令及其用途： - 列出本地镜像： ```bash docker images ``` - 运行容器实例： ```bash docker run hello-world ``` - 查看正在运行的容器： ```bash docker ps ``` 这些基础操作可以帮助快速熟悉 Docker 的基本用法。 --- #### 7. 解决常见问题 **(a)** 如果遇到类似于“无法找到指定版本”的错误，请确认目标架构与操作系统代号是否一致。例如，在 Ubuntu Focal 中应使用 `focal` 而非其他名称作为参数[^3]。 **(b)** 对于权限不足的情况，可尝试将当前用户加入 `docker` 用户组： ```bash sudo usermod -aG docker $USER newgrp docker ``` 之后重新登录使更改生效。 ---