努力
加油

腾讯云Ubuntu服务器安装Docker的完整步骤是什么?

在腾讯云 Ubuntu 服务器上安装 Docker,核心逻辑其实和在其他 Linux 发行版上差不多,但考虑到国内网络环境(特别是拉取镜像的速度)以及腾讯云的默认安全策略,有几个坑需要避开。

以下是经过验证的、生产环境可用的完整步骤。我按“最稳妥”的方式推荐,即通过官方源安装,而不是直接用 apt install docker.io(那个版本通常很旧且不是社区最新维护版)。

前置准备:登录与基础检查

  1. SSH 登录
    ssh root@<你的CVM公网IP>
  2. 更新系统包索引
    这一步不能省,确保你拿到的是最新的软件列表。

    sudo apt update && sudo apt upgrade -y
  3. 确认内核版本
    Docker 对内核有要求,Ubuntu 18.04/20.04/22.04 LTS 都满足条件。你可以简单看下:

    uname -r

第一步:卸载可能存在的冲突版本

如果你之前尝试过 apt install docker.io 或者装过旧版 Docker,先清理一下,避免端口或依赖冲突。

sudo apt-get remove docker docker-engine docker.io containerd runc

注:如果提示没有这些包,直接忽略即可。


第二步:安装必要依赖

Docker 的安装过程需要 HTTPS 传输和证书校验,所以得先装上这些工具。

sudo apt-get install -y ca-certificates curl gnupg lsb-release

第三步:添加 Docker 官方 GPG 密钥和 APT 源

这是最关键的一步。注意:由于国内网络原因,直接使用 Docker 官方源可能会超时或下载极慢。

方案 A:使用 Docker 官方源(推荐,稳定但需良好网络)

  1. 添加 GPG 密钥

    sudo mkdir -p /etc/apt/keyrings
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
  2. 设置稳定版仓库
    首先获取你的 Ubuntu 代号(如 focal, jammy 等):

    echo 
      "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu 
      $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

方案 B:使用阿里云镜像源(强烈推荐,国内服务器首选)

如果执行上面的 curl 命令卡住或失败,请直接换用阿里云的 Docker CE 镜像源,速度会快很多。

  1. 添加阿里云 GPG 密钥

    sudo mkdir -p /etc/apt/keyrings
    curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
  2. 设置阿里云仓库

    echo 
      "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu 
      $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

第四步:安装 Docker Engine

再次更新包索引,然后安装。

sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

注:这里安装了 docker-compose-plugin,这样你就可以直接用 docker compose 命令了,不需要单独去下二进制文件。


第五步:验证安装

sudo docker run hello-world

如果看到 Hello from Docker! 的输出,说明安装成功。


第六步:配置非 Root 用户运行 Docker(重要优化)

默认情况下,只有 root 用户能运行 Docker 命令。为了方便日常开发,建议将当前用户加入 docker 组。

  1. 创建 docker 组并添加用户
    (假设当前用户是 ubuntu 或 root,如果是其他用户请替换 <username>)

    sudo groupadd docker
    sudo usermod -aG docker $USER
  2. 重启生效
    退出 SSH 重新登录,或者执行:

    newgrp docker
  3. 测试
    现在你可以不加 sudo 直接运行 docker ps 或 docker images 了。

第七步:配置开机自启

虽然安装后默认是自启的,但为了保险起见:

sudo systemctl enable docker
sudo systemctl enable containerd

第八步:国内镜像提速配置(必做)

在国内拉取 Docker Hub 的镜像(尤其是官方镜像如 nginx, mysql, redis 等)非常慢,甚至超时。必须配置镜像提速器。

  1. 编辑 daemon.json

    sudo mkdir -p /etc/docker
    sudo tee /etc/docker/daemon.json <<-'EOF'
    {
      "registry-mirrors": [
        "https://mirror.ccs.tencentyun.com",
        "https://docker.m.daocloud.io",
        "https://huecker.io",
        "https://dockerhub.timeweb.cloud"
      ]
    }
    EOF

    注:mirror.ccs.tencentyun.com 是腾讯云专属镜像提速地址,无需申请,直接可用,延迟最低。其他几个是公共提速源,可以作为备用。

  2. 重启 Docker 服务

    sudo systemctl daemon-reload
    sudo systemctl restart docker
  3. 验证配置

    sudo docker info | grep -A 10 "Registry Mirrors"

    你应该能看到刚才配置的提速地址。


常见问题排查

  1. 权限拒绝 (Permission denied)

    • 现象:运行 docker ps 报错 Got permission denied while trying to connect to the Docker daemon socket...
    • 解决:确保你已经执行了 usermod -aG docker $USER 并重新登录了终端。
  2. 防火墙问题

    • 腾讯云 CVM 默认开启了安全组。如果你在容器内启动了 Web 服务(如 80, 8080 端口),务必去腾讯云控制台 -> 实例 -> 安全组规则中,添加入方向规则,允许对应 TCP 端口。
    • 服务器内部的 ufw 防火墙通常不影响 Docker 桥接网络,但如果不确定,可以暂时关闭测试:sudo ufw disable。
  3. 磁盘空间不足

    • Docker 镜像和容器会占用大量磁盘空间。定期检查:
      df -h
      docker system df
    • 如果满了,可以使用 docker system prune -a 清理未使用的镜像和容器(慎用,会删除所有停止的容器和无用的镜像)。

总结

这套流程涵盖了从环境准备到镜像提速的全链路。对于腾讯云 Ubuntu 服务器,重点在于使用腾讯云内网镜像提速地址 (mirror.ccs.tencentyun.com) 和正确配置安全组。按照这个步骤走,基本不会踩坑。