努力
加油

在腾讯云的Ubuntu系统上如何正确安装Docker环境?

在腾讯云 Ubuntu 系统上安装 Docker,核心原则就一条:别直接用 apt install docker,那是旧版或者不规范的包,容易出各种依赖地狱和版本断层。

最稳妥、也是官方推荐的路径是走 Docker 官方源。这样能保证你拿到的是最新稳定版,且后续升级(apt upgrade)时不会出问题。

下面分步骤来,尽量避开那些虚头巴脑的废话,直接上干货。

第一步:清理“脏”环境(如果之前装过)

很多老教程会让你先卸载 docker.io、docker-doc、docker-compose 这些自带包。如果你是从零开始的裸机,这步可以跳过;如果是重装或之前折腾过,建议执行一下,防止冲突:

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

然后更新一下索引:

sudo apt-get update

第二步:安装前置依赖

Docker 需要一些基础工具来管理 HTTPS 仓库和密钥。这一步在 Ubuntu 20.04/22.04/24.04 上都通用:

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

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

这是最关键的一步。国内网络环境有时候访问 Docker Hub 的官方源比较慢,甚至超时。强烈建议配置镜像提速或者使用阿里云/腾讯云的镜像源辅助,但为了合规性和稳定性,我们先按标准流程走,后面再讲提速器。

  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
  1. 设置稳定的 APT 源:

你需要确认你的 Ubuntu 版本代号(比如 focal, jammy, noble)。可以直接用命令自动识别:

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

注意:如果你在腾讯云控制台操作,发现 curl 很慢,可以把上面的 https://download.docker.com/linux/ubuntu 替换为阿里云的 Docker CE 镜像源地址(例如 https://mirrors.aliyun.com/docker-ce/linux/ubuntu),速度会快很多。

第四步:安装 Docker Engine

再次更新索引,然后安装最新的 Docker 组件:

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

安装完成后,验证是否成功:

sudo docker run hello-world

如果能打印出 “Hello from Docker!”,说明内核层没问题了。

第五步:配置非 root 用户权限(重要)

默认情况下,运行 Docker 命令需要 sudo。对于日常开发或部署来说,每次敲 sudo 很烦,而且不安全。我们创建一个 docker 用户组,并把当前用户加进去。

  1. 创建组(如果已存在则忽略):

    sudo groupadd docker
  2. 将当前用户加入该组:

    sudo usermod -aG docker $USER
  3. 生效权限:
    这里有个坑,修改完用户组后,必须重新登录 SSH 或者重启服务器才能生效。直接在当前终端输入 newgrp docker 有时也不彻底,最稳妥的是退出 SSH 重连。

重连后,测试一下不用 sudo 能不能跑:

docker ps

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

在国内拉取 ubuntu, nginx, mysql 等基础镜像,如果不配提速器,大概率会卡死或者超时。

  1. 编辑 daemon 配置文件:

    sudo nano /etc/docker/daemon.json
  2. 写入以下内容(以腾讯云容器镜像服务 CCR 为例,当然也可以用阿里云或其他第三方):

{
  "registry-mirrors": [
    "https://mirror.ccr.tencentyun.com",
    "https://registry.docker-cn.com" 
  ],
  "exec-opts": ["native.cgroupdriver=systemd"]
}

关于 cgroup driver:Ubuntu 18.04+ 默认使用 systemd 作为 init 系统,Docker 也推荐使用 systemd 作为 cgroup driver。加上这一行可以避免后续 Kubernetes 或某些编排工具出现兼容性问题。

  1. 保存退出(Ctrl+O, Enter, Ctrl+X)。

  2. 重启 Docker 服务使配置生效:

    sudo systemctl restart docker

常见问题排查(避坑指南)

  1. 启动失败?
    查看日志:sudo journalctl -xeu docker.service。通常是因为端口冲突或者之前的残留进程没杀干净。

  2. 防火墙问题?
    腾讯云安全组记得放行你要暴露的端口(如 80, 443, 22 等)。Docker 内部自己有一套 iptables/nftables 规则,通常不需要手动改 UFW,除非你强制开启了 UFW 并配置不当。

  3. 磁盘空间不足?
    Docker 镜像和容器会占用大量 /var/lib/docker 目录的空间。如果是在小内存低配云主机上跑,建议定期执行 docker system prune -a 清理无用镜像和卷。

  4. 版本选择:
    不要执着于最新版。生产环境建议锁定一个 LTS(长期支持)版本。可以通过 apt-cache policy docker-ce 查看可用版本,然后用 sudo apt-get install docker-ce=<版本号> 指定安装。

总结下来,核心就是:官方源 + 镜像提速 + systemd cgroup + 非 root 用户。这套组合拳打下来,在腾讯云 Ubuntu 上基本能稳如老狗。